PHP转EXE本质是打包PHP解释器+脚本+资源,2025年真正支持CLI模式的工具仅有ZZEE PHPExe和roadrunner+UPX方案,其余多已失效或不兼容CLI。

PHP 本身是解释型语言,没有原生的 .exe 编译能力;所谓“PHP 转 EXE”,本质是把 PHP 解释器 + 你的脚本 + 依赖资源打包进一个 Windows 可执行容器中,运行时自动启动 CLI 模式执行。目前真正支持 CLI 场景、稳定可用且持续维护的工具极少,多数已停更或仅限 Web CGI 封装。
✅ 真正支持 CLI 模式的主流工具(2025 年实测有效)
能完整保留 php -f script.php arg1 arg2 这类命令行调用行为的工具,只有以下两类:
-
ZZEE PHPExe:老牌闭源工具,2024–2025 年仍有更新。它会嵌入精简版 PHP CLI 解释器(如 PHP 8.2/8.3),生成的.exe可直接双击运行,也支持命令行传参(app.exe --help或app.exe input.txt)。缺点是不支持扩展动态加载(如ext-redis需静态编译进解释器)。 -
roadrunner+UPX打包方案(变通但实用):RoadRunner 本身不是打包工具,但它能以常驻 CLI 进程方式运行 PHP 脚本(rr serve启动后监听 STDIN/STDOUT)。配合 Go 编写的轻量 wrapper(如用golang.org/x/sys/windows调用 CreateProcess),再用UPX压缩最终二进制,可产出体积小、启动快、完全 CLI 行为一致的 EXE。适合已有 RoadRunner 项目想分发给无 PHP 环境的用户。
❌ 常见误选工具:看似能打,实际不支持 CLI
很多教程推荐的工具在 2025 年已失效或根本不处理 CLI 场景:
-
PHP Desktop:纯 GUI 框架,底层基于 Chromium + PHP-CGI,只能跑 Web 应用,无法接收命令行参数,运行后强制弹窗,php.exe不暴露给终端。 -
ExeOutput for PHP:商业软件,主打 Web 打包,生成的 EXE 是内嵌浏览器+本地服务器,argv完全不可用,$argc/$argv恒为 1。 -
WinBinder:早已停止维护(最后更新 2012 年),不兼容 PHP 7.4+,且仅提供 GUI 控件绑定,无 CLI 封装能力。
⚠️ 打包 CLI PHP 的三个硬性前提(缺一不可)
即使选对工具,若忽略以下任一条件,生成的 EXE 很可能运行报错或静默失败:
立即学习“PHP免费学习笔记(深入)”;
- PHP 脚本必须使用
#!/usr/bin/env php或显式调用php_sapi_name() === 'cli'判断环境,避免意外进入web分支逻辑; - 所有依赖文件(如
vendor/、配置文件、模板路径)必须相对脚本位置加载,不能写死绝对路径——__DIR__和getcwd()在 EXE 中行为不同,推荐统一用dirname($_SERVER['SCRIPT_FILENAME'])获取真实脚本根目录; - 若脚本调用系统命令(如
exec('curl')),需确认打包环境是否包含对应二进制(curl.exe等),否则需改用 PHP 原生函数(file_get_contents+ stream context)替代。
示例:安全获取当前脚本所在目录(EXE 兼容) $root = dirname($_SERVER['SCRIPT_FILENAME']); $config = file_get_contents($root . '/config.json');
CLI 打包最易被忽略的点是:你写的 PHP 脚本本身是否真的“只依赖 CLI SAPI”?很多开发者用 Laravel Artisan 或 Symfony Console 组件,它们内部做了大量环境探测和 autoload 适配——这些框架默认打包后大概率崩溃,必须用官方推荐的 composer dump-autoload --optimize + 自定义 index.php 入口来剥离 Web 相关逻辑。别指望一键打包能绕过这个层面。











