PHP无法直接打包成可自动更新的EXE,所谓“PHP EXE”实为第三方工具(如ExeOutput、PHP Desktop)将PHP+浏览器+运行时打包;自动更新依赖客户端检查版本、下载新包、替换文件并重启,PHP仅负责版本协商,更新调度须由独立updater进程完成。

PHP 本身不能直接打包成 EXE 并自动更新
PHP 是服务端脚本语言,运行依赖 PHP 解释器和 Web 服务器(如 Apache/Nginx),php.exe 只是命令行解释器,不是可独立分发的 GUI 应用程序。所谓“PHP 做 EXE”,实际是用第三方工具(如 ExeOutput for PHP、PHP Desktop 或 WebCompiler)把 PHP + 内置浏览器 + 运行时打包成单个 Windows 可执行文件。这类 EXE 的自动更新机制,本质是**客户端程序自己检查版本、下载新包、替换文件并重启**——和 PHP 无关,全靠打包工具或你写的 JS/PHP 混合逻辑控制。
ExeOutput for PHP 中实现在线升级的关键点
这是目前最常用于将 PHP 桌面化并生成 EXE 的商业工具,支持内置 HTTP 客户端和自定义启动脚本。自动更新需在打包前写好逻辑:
- 更新检查必须放在
startup.php或主页面的中,用file_get_contents()请求远程version.json(含version和download_url) - 比对本地
app_version.txt(需随 EXE 一起写入,每次启动读取)与远程版本号,不一致则触发下载 - 下载必须用
ExeOutput提供的EO_HTTPGetFile()函数(非标准 PHP 函数!),否则会因沙箱限制失败 - 新 EXE 下载完成后,调用
EO_ShellExecute()启动安装器(如updater.exe),再用EO_TerminateApplication()退出当前进程 - 务必关闭
ExeOutput的“压缩资源”选项,否则无法覆盖写入内部文件
PHP Desktop(开源方案)中更新逻辑更可控但需自己写 C++ 插件
PHP Desktop 基于 Chromium 和 CEF,主进程是 C++,PHP 运行在子进程中。它不内置更新模块,但提供了 native messaging 接口,允许 PHP 调用宿主程序能力:
- PHP 层发起请求:
file_get_contents("http://your-api.com/version?current=" . urlencode(file_get_contents("app_version"))) - 响应返回新版本 ZIP 包 URL 和校验值(如
sha256) - 用
exec("powershell -Command \"Invoke-WebRequest ...\"")下载 ZIP(Windows 下可行,但需用户权限) -
解压需调用外部工具(如
7z.exe)或通过 C++ 插件实现安全解压 —— 直接用 PHPZipArchive无法覆盖正在运行的 EXE 目录 - 关键限制:
PHP Desktop的主 EXE 是只读锁定的,更新必须另起一个独立 updater 进程,且旧进程退出后才能重命名/替换文件
绕过 EXE 打包:用 PHP + Electron 更靠谱
如果目标是“带 PHP 后端的桌面应用+自动更新”,与其硬套 PHP 打包工具,不如改用 Electron + php-cgi 嵌入方案:
立即学习“PHP免费学习笔记(深入)”;
- Electron 主进程用
autoUpdater模块(基于Squirrel.Windows)实现静默增量更新,稳定且被大量商用产品验证 - PHP 作为子进程启动:
const php = spawn('php-cgi', ['-b', '127.0.0.1:9000'], { cwd: path.join(__dirname, 'php-backend') }); -
前端通过
fetch('http://127.0.0.1:9000/api.php')调用 PHP,完全复用 Web 开发习惯 - 更新时只更新 Electron 主程序和 PHP 后端文件夹,
php-cgi.exe可随包分发,无需额外安装环境 - 注意:Windows 上需确保
php-cgi.exe和依赖 DLL(如libssh2.dll)一并打包,否则启动失败报错0xc000007b
真正卡住的从来不是“怎么让 PHP 变成 EXE”,而是“如何安全替换正在运行的进程文件”。所有方案最终都回归到:用一个独立 updater 进程完成下载、校验、停止旧进程、替换文件、重启。PHP 在其中只负责版本协商和业务逻辑,别让它扛更新调度的活。











