yii2不能直接与electron整合运行，因其是php服务端框架而electron仅支持js/html/css；必须将yii2作为本地http api服务，electron作为前端客户端通过fetch调用，主进程可借助child_process启动php服务但需妥善处理生命周期与跨平台兼容性。
不能直接用 Yii2 + Electron “拼起来”就跑，因为两者运行环境和职责根本冲突：Yii2 是服务端 PHP 框架，Electron 是桌面端 JS 运行时。想让它们共存，必须明确分工——Yii2 做后端 API 服务，Electron 做前端壳子，中间靠 HTTP 或 IPC 桥接。
为什么不能把 Yii2 直接塞进 Electron 渲染进程？
Electron 的渲染进程是 Chromium 实例，只认 HTML/CSS/JS，不带 PHP 解释器。你扔一个 index.php 进去，浏览器只会把它当纯文本下载或报 404；就算用 file:// 协议加载，PHP 代码也完全不会执行。这是底层运行时的硬隔离，不是配置能绕过的。
- 常见错误现象：
Parse error: syntax error, unexpected '（其实是 PHP 源码被当 HTML 渲染了） - 有人试过用
child_process.spawn('php', ['-S', 'localhost:8000'])在主进程中起内置服务器，但 Windows 上路径空格、PHP 版本缺失、CLI 模式限制多，极易卡在启动阶段 - Electron 主进程虽有 Node.js 环境，但无法原生 require 或执行 .php 文件——这不是权限问题，是语言 runtime 根本不同
可行方案：Yii2 作为本地 API 服务，Electron 作为 UI 客户端
这是目前最稳定、可调试、易部署的组合方式。核心逻辑是让 Yii2 在本地起一个 HTTP 服务（如 php yii serve 或 nginx+php-fpm），Electron 渲染进程通过 fetch 或 axios 调它，就像调远程接口一样。
- Yii2 必须启用 CORS（尤其开发期），在
config/web.php的components中加：'response' => ['class' => 'yii\web\Response','format' => yii\web\Response::FORMAT_JSON,'headers' => ['Access-Control-Allow-Origin' => '*']] - Electron 主进程无需改动，但渲染进程的
webPreferences要关掉nodeIntegration（安全要求），改用预加载脚本暴露有限 API，比如封装fetch调用 - 本地开发时，Yii2 服务地址写成
http://localhost:8080（或你实际监听的端口），Electron 页面里直接fetch('/api/user')即可，不用代理 - 打包发布时，Electron 应用自带一个轻量级 HTTP 服务包装器（如
serve或http-server）来托管 Yii2 的web目录不行——PHP 无法打包进 Electron；正确做法是把 Yii2 编译为 CLI 工具或用phpdesktop类方案，但已脱离 Electron 范畴
Electron 主进程如何安全启动并监控 Yii2 服务？
如果坚持让 Electron “管” Yii2 进程（例如自动拉起 PHP 内置服务器），必须用 child_process 并处理好生命周期。但要注意：PHP 内置服务器不支持 Windows 下的信号中断，容易残留进程。
- 启动命令示例：
spawn('php', ['yii', 'serve', '--docroot=web', '--port=8080'], { cwd: '/path/to/yii2/project' }) - 必须监听
exit事件，否则 Electron 关闭时 PHP 进程还在后台跑着，下次启动会报Address already in use - Windows 用户注意：
php命令需确保在系统 PATH 中，且版本 ≥ 7.4（Yii2.0.43+ 要求），yii文件要有执行权限（Linux/macOS）或得用php yii显式调用 - 不要在渲染进程里 spawn PHP——跨进程权限受限，且 Chromium 会拦截非标准协议请求，导致白屏无报错
真正难的不是“怎么连”，而是“怎么断”。Electron 窗口关闭时，Yii2 服务是否干净退出？网络请求失败时，Electron 是该重试、降级到本地缓存，还是弹系统通知？这些边界逻辑比技术拼接更重要，也最容易被忽略。
