PHP无法原生打包EXE并显示启动画面,实际依赖ExeOutput等工具封装PHP+Web服务器+浏览器内核;启动页为startup.html静态页面,通过exepackage.js控制显隐,资源需用exepackage://协议引用。

PHP 本身不能直接打包成 EXE 并显示启动画面
PHP 是服务端脚本语言,没有原生 GUI 或 Windows 启动动画能力。所谓“PHP 打包 EXE”,实际是靠第三方工具(如 ExeOutput for PHP、WebCompiler 或 PHP Desktop)把 PHP + 内置 Web Server + Chromium/IE 封装进一个 Windows 可执行文件。启动画面本质是封装器加载 HTML/CSS/JS 的过程,不是 PHP 在控制。
ExeOutput for PHP 中添加启动页的实操步骤
这是目前最常用且支持启动画面的工具。它会在主页面加载前,先显示一个本地 HTML 文件(startup.html),并提供 JS API 控制其关闭时机。
- 将自定义启动页保存为
startup.html,放在项目根目录(与index.php同级) - 在
startup.html中用纯 HTML/CSS/JS 实现动画,例如用@keyframes做淡入或旋转 logo - 必须在页面中引入 ExeOutput 提供的 JS 接口:
- 当 PHP 主应用准备就绪后,调用
exePackage.hideSplash()关闭启动页(通常在index.php输出完成前,通过触发) - 注意:启动页资源(图片、字体)需用
exepackage://协议引用,例如,否则路径会 404
常见失败原因和绕不过去的限制
很多用户卡在“启动页一闪而过”或“完全不显示”,核心问题不在代码,而在封装配置和生命周期理解偏差:
-
startup.html必须编码为 UTF-8 无 BOM,否则 ExeOutput 加载失败且无提示 - 启动页默认超时时间为 10 秒,若 PHP 后端响应慢于该值,启动页会自动关闭——这不是 bug,是保护机制;可通过 ExeOutput 设置界面修改
Splash Timeout值 - 无法在启动页里执行 PHP 逻辑(如查数据库、读配置),它纯静态;所有动态判断必须移交到主页面,再由 JS 控制启动页显隐
- ExeOutput 12+ 版本对 Windows 10/11 高 DPI 支持不佳,启动页可能被缩放错位,建议禁用“高 DPI 缩放替代”选项(右键 EXE → 属性 → 兼容性)
替代方案:用 NSIS 手动包装 + 独立 splash 进程
如果 ExeOutput 的限制太重(比如要动态生成启动文字、需要更长控制权),可放弃“PHP 封装器”路线,改用底层打包方式:
立即学习“PHP免费学习笔记(深入)”;
- 用
PHP Desktop或ServerGrove/phpdesktop构建基础 EXE(它本质是 CEF + PHP CLI) - 另写一个轻量级 C# 或 AutoHotKey 小程序,仅负责显示启动窗体(WinForm 或 WPF),带进度条和动画
- 用 NSIS 脚本编排启动顺序:
先运行 splash.exe→异步启动 phpdesktop.exe→检测主窗口句柄出现后关闭 splash.exe - 关键点:NSIS 中需用
ExecWait启动 splash,再用FindWindow+SendMessage等 API 判断主程序是否 ready,不能依赖固定延时
这条路自由度高,但工作量翻倍,且每次更新 PHP 逻辑都要重新打包整个 NSIS 安装包。真正需要精细控制启动体验的团队才会走这一步。











