php做exe新手怎么开始_零基础打包入门流程【教程】_技术教程

PHP无法直接编译为Windows原生.exe，实际是将解释器、脚本及资源封装成可执行容器，运行时仍依赖内置解释器；推荐先用Box生成PHAR，再通过PHP Desktop或ExeOutput转为.exe。

PHP 本身不能直接编译成 Windows 原生 .exe 文件——这是关键前提。所谓“PHP 打包成 exe”，实际是把 PHP 解释器、你的 PHP 脚本、依赖资源一起封装进一个可执行容器，运行时仍靠内置解释器执行脚本。不理解这点，后续所有操作都会走偏。

Windows 下的 php.exe 是 CLI 解释器，它只负责运行 PHP 代码，不包含 Web 服务器、扩展模块或自动加载逻辑。你双击它只会闪退，除非带参数如 php.exe script.php。真正需要的是一个能自启动、带环境、静默运行、支持 GUI 或服务模式的封装工具。

Box Project 是目前最轻量、最贴近 PHP 生态的打包工具，生成单文件 PHAR，再用第三方工具（如 PHP Desktop 或 ExeOutput for PHP）转为 .exe。新手应从 PHAR 入手，再过渡到 EXE 封装。

先确保项目可独立运行：
```
php -S localhost:8000 -t public/
```
能正常访问，说明路由、自动加载、依赖都没问题
安装 box：
```
composer global require humbug/box
```
（注意 Composer 全局 bin 目录需在系统 PATH 中）
写 box.json，至少指定："main": "index.php"、"output": "app.phar"、"compression": "GZ"
构建：
```
box compile
```
，生成 app.phar；验证：
```
php app.phar
```

此时你已获得一个可分发的单文件 PHP 应用——虽不是 .exe，但已解决核心问题：依赖隔离、入口统一、版本锁定。

立即学习“PHP免费学习笔记（深入）”；

PHAR 不能双击运行，必须借助宿主环境。以下是两个真实可用、文档清晰、新手踩坑少的方案：

PHP Desktop：开源桌面框架，基于 Chromium + CEF + 内置 PHP，支持 GUI 界面。下载预编译版后，把 app.phar 放进 www/，改 phpdesktop-chrome\settings.json 中 "home_page" 指向 app.phar 即可。最终打包用其自带的 make_installer.bat，生成带安装向导的 .exe
ExeOutput for PHP（商业，有试用版）：界面友好，直接拖入 PHP 文件夹，勾选“隐藏控制台”、“启动时运行 index.php”，点“Build EXE”即可。它会自动嵌入 PHP 8.1 运行时、处理 extension_dir、生成注册表项，适合交付给非技术人员

别碰 ZZEE PHPExe 或老旧的 PPHP 工具——它们不支持 PHP 7.4+，且无法加载现代扩展如 mbstring 或 openssl。

90% 的打包失败不是因为工具不会用，而是忽略了运行时上下文差异：

路径问题：__DIR__ 在 PHAR 中指向 phar://app.phar/，不是物理路径；要用 Phar::running() 或 dirname($_SERVER['SCRIPT_FILENAME']) 获取真实路径
配置加载：php.ini 不会被自动读取，ExeOutput 等工具提供“自定义 ini”入口，务必手动开启 extension=php_pdo_sqlite.dll 等所需扩展
临时目录：sys_get_temp_dir() 在某些封装环境下返回空或不可写，建议显式设置：
```
define('SYS_TEMP', __DIR__ . '/tmp');
```
并确保该目录存在且可写