ThinkPHP 8.1-FPM 重启实为重启 php8.1-fpm 进程,以重载 PHP 配置或清空 OPcache;需用 systemctl restart php8.1-fpm(改 php.ini 必选)或 reload(仅重载 pool 配置);重启后须执行 php think clear:runtime 并确保 OPcache 更新。

ThinkPHP 本身不管理 PHP-FPM,所谓“ThinkPHP 8.1-FPM 重启”,实际是重启你系统中为 ThinkPHP 提供 PHP 解析服务的 php8.1-fpm 进程,目的是让其加载新配置(如 php.ini、www.conf 修改)或清空 OPcache 缓存,从而让框架行为同步更新。
确认你要重启的具体服务名
Ubuntu/Debian 系统通常使用带版本号的服务名:
- php8.1-fpm(最常见,对应 PHP 8.1)
- 也可能是 php-fpm81 或 php81-fpm,取决于安装源(如 ondrej PPA 或系统默认仓库)
先查清楚:
systemctl list-units | grep -i "php.*fpm"
标准重启命令(推荐)
执行以下命令,会完全停止再启动进程,确保配置重载生效:
sudo systemctl restart php8.1-fpm
重启后检查状态是否正常:
修复 Core bailout 状态损坏安全问题,以及 BZ2、DOM、PDO、Opcache/JIT 内存与执行错误,改进 Unicode 字素处理、URL 解析、TLS 流状态、信号分发及会话错误处理。
sudo systemctl status php8.1-fpm
看到 active (running) 且无报错即成功。
平滑重载(适合线上,不中断请求)
若服务正在处理请求,又不想断开用户连接,可用 reload(前提是 php-fpm.conf 中设置了 process_control_timeout,默认为 0,需显式设为 >0 才有效):
sudo systemctl reload php8.1-fpm
注意:reload 不会重新读取全局 php.ini,但会重载 pool 配置(如 www.conf);如修改了 php.ini,必须用 restart。
配合 ThinkPHP 配置刷新(关键!)
仅重启 php-fpm 不足以让 ThinkPHP 读到新配置。还需两步:
- 清空框架运行时缓存:
php think clear:runtime或手动删除runtime/config.php - 若启用了 OPcache(生产环境默认开启),需重载 OPcache 或重启 php-fpm —— 因为
php think config:cache生成的缓存文件会被 OPcache 锁定,不重启 FPM 就不会更新
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!










