PhpStorm运行Webman高性能框架_配置自定义启动脚本执行【实战】-phpstorm-PHP中文网

不能直接运行start.php，因其是cli入口但phpstorm默认以普通脚本执行，跳过workerman信号注册与进程模型，导致热更新失效、断点不生效、ctrl+c无法优雅退出；windows下更需用windows.php替代。

phpstorm运行webman高性能框架_配置自定义启动脚本执行【实战】

直接用 php start.php start 启动 Webman 在 PhpStorm 中无法热更新、不好打断点、进程管理混乱——这不是 Webman 的问题，是启动方式没对。

为什么不能直接运行 start.php？

Webman 的 start.php 是 CLI 启动入口，但 PhpStorm 默认把它当普通 PHP 脚本执行：不加载 Workerman 进程模型、不监听信号、不 fork 子进程，导致调试器挂不上、断点不生效、Ctrl+C 无法优雅退出。

php start.php start 实际调用的是 Workerman 的 Worker::runAll()，依赖 CLI SAPI 和进程控制能力
PhpStorm 直接执行该文件时，会跳过 Workerman 的信号注册和事件循环初始化
Windows 下尤其明显：php windows.php 才是真正适配 Win 的启动入口，而 start.php 默认只适配 Linux/macOS

怎么配一个真正可用的 PhpStorm 启动配置？

核心是绕过 PhpStorm 对脚本的“静态执行”逻辑，让它真正以 CLI 模式启动 Webman 主进程，并支持调试。

菜单栏 → 运行 → 编辑配置 → 点 + → 选 PHP Script
Script path 填项目根目录下的 start.php（Linux/macOS）或 windows.php（Windows）
Interpreter options 栏填 start（不是 start.php start，后者会被当成参数传给解释器）
勾选 Use script path as working directory，确保 config/、app/ 等路径能正确解析
如需调试，务必在 Environment variables 中添加 XDEBUG_MODE=debug（Xdebug 3+）或 XDEBUG_CONFIG="idekey=PHPSTORM"（Xdebug 2）

自定义启动脚本怎么写才可靠？

别硬改 start.php，它要保持框架原生结构。推荐在项目根目录新建 dev-start.php，专供 IDE 使用：

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

<?php // dev-start.php
if (php_sapi_name() !== 'cli') {
    exit("This script only runs in CLI mode.\n");
}
define('WEBMAN_START_TIME', microtime(true));
require_once __DIR__ . '/start.php';
// 强制重载配置、禁用 opcache（开发时）
opcache_reset();
// 可选：加载 .env 开发配置
if (file_exists(__DIR__ . '/.env.local')) {
    $dotenv = Dotenv\Dotenv::createImmutable(__DIR__);
    $dotenv->safeLoad();
}

然后在 PhpStorm 配置中把 Script path 指向 dev-start.php，Interpreter options 留空即可——这样既不污染主入口，又能注入开发所需逻辑。

Windows 下调试失败的常见坑

不是 Xdebug 配置错，而是进程模型不匹配：

用 php start.php start 在 Windows 上会报 pcntl_fork() is not available ——Workerman 自动 fallback 到单进程模式，但 PhpStorm 调试器仍试图 attach 到子进程
必须用 windows.php 启动，它内部用 proc_open() 替代 pcntl，兼容性更好
如果断点始终灰色（未激活），检查 PhpStorm 的 Settings → PHP → Debug → Xdebug → Debug port 是否为 9003（Xdebug 3 默认），且 Start listening for PHP Debug Connections 按钮已点亮
调试时若发现多个 php.exe 进程残留，说明 Workerman 子进程没被正确 kill ——建议在 PhpStorm 的 Before launch 里加个 External tool，执行 taskkill /F /IM php.exe（Windows）或 pkill -f 'php.*start\.php'（macOS/Linux）