PHP Webman热更新失效怎么办_Webman开发模式下自动重载配置【排错】-php教程-PHP中文网

webman 的 reload 仅支持 config/autoload.php 中 files 列表声明的辅助文件（如 functions.php）、纯函数式 route.php 路由，不支持配置文件、控制器类、vendor 依赖及闭包路由，修改后需 restart。

php webman热更新失效怎么办_webman开发模式下自动重载配置【排错】

Webman 的热更新（reload）只对特定文件生效，不是改了代码就能自动重载——它默认不监听 config/、route.php 或控制器类的变更，除非你明确配置了监听路径或用了框架支持的加载方式。

哪些文件支持 reload 而不是 restart？

Webman 的 php start.php reload 命令只重新加载以下几类内容：

config/autoload.php 里通过 files 键声明的 PHP 文件（如 app/functions.php）
由 config/autoload.php 加载的、非 PSR-4 规范的辅助文件（比如自定义的 Request.php、Response.php）
路由文件 config/route.php（但仅限于用 Route::get() 等函数式写法，不包括闭包路由中 new 出来的控制器）

不支持热重载的典型文件：

config/database.php 这类返回数组的配置脚本 —— 必须 php start.php restart
app/controller/IndexController.php —— 类文件修改后不会触发 reload，除非你把它加进 autoload.php 的 files 列表（但不推荐，破坏 PSR-4）
vendor/ 下的依赖 —— Composer 更新后必须 restart

reload 命令没反应？先确认是否真在开发模式

Webman 默认只有在 APP_DEBUG = true 且未启用守护模式（即没加 -d）时，reload 才有效。如果执行 php start.php start -d 后再跑 reload，它会静默失败，因为主进程已 detach。

btpanel phpsite 宝塔面板PHP网站

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

下载

开发阶段务必用 php start.php start（不带 -d）启动
检查 .env 是否设了 APP_DEBUG=true，否则 reload 直接跳过监听逻辑
运行 php start.php status 确认当前是「运行中」而非「守护中」

自定义文件想热重载，但 autoload.php 不生效？

常见错误是把文件路径写错，或没注意 base_path() 的返回值。例如你在 config/autoload.php 里写：

return [
    'files' => [
        base_path() . '/app/helpers.php',
    ],
];

但实际文件在 support/helpers.php，就会漏掉。更稳妥的做法是：

用 file_exists() 手动验证路径：var_dump(file_exists(base_path('/support/helpers.php')));
避免拼接斜杠：用 base_path('support/helpers.php') 而不是 base_path() . '/support/helpers.php'
确保该文件里没有 class 声明（否则会被 PSR-4 自动加载器抢先加载一次，导致重复声明）

为什么改了 route.php 却没刷新路由？

Webman 的路由热重载只在 config/route.php 是纯函数调用（如 Route::get('/api', [IndexController::class, 'index'])）时才起作用。如果你写了闭包路由：Route::get('/test', fn() => echo 'hi');，那它绕过了容器和路由缓存机制，reload 无法感知变更。