宝塔面板守护进程开启教程：PHP 8.3 配置与启动命令

本文介绍如何在宝塔面板中配置守护进程，让 PHP 后台任务持续运行。示例使用 PHP 8.3，并启动网站目录中的 generation-worker.php 脚本。

配置前说明

• 请先确认网站使用的 PHP 版本，本教程示例为 PHP 8.3。
• 请将命令中的 /www/wwwroot/你的网站 替换为自己的实际网站目录。
• 启动用户建议与网站运行用户保持一致，宝塔面板通常为 www。

第一步：设置 PHP 命令行版本

进入宝塔面板的网站设置，依次打开“高级设置”与“PHP 命令行版本”，选择和网站一致的 PHP 版本。本教程选择 PHP 8.3。

第二步：打开守护进程管理器

进入宝塔面板“软件商店”，找到“守护进程管理器”，点击“设置”进入进程配置页面。

第三步：填写守护进程配置

新增一个守护进程，并按下面的参数填写：

• 启动用户：www
• 运行目录：/www/wwwroot/你的网站/public/
• 启动命令：

/www/server/php/83/bin/php /www/wwwroot/你的网站/bin/generation-worker.php --poll-ms

其中 83 代表 PHP 8.3。如果使用其他版本，请同步修改 PHP 可执行文件路径。

第四步：保存并检查运行状态

确认路径和命令无误后保存配置并启动进程。进程状态显示为运行中，即表示守护进程已经正常工作。

常见问题排查

• 进程启动后立即停止：检查 PHP 可执行文件路径、网站目录和脚本文件名是否正确。
• 提示权限不足：确认 www 用户拥有运行目录及相关文件的读取和执行权限。
• 更换 PHP 版本后无法运行：同步修改启动命令中的版本目录，例如 PHP 8.3 对应 /www/server/php/83/bin/php。
• 仍然无法启动：先在宝塔终端中执行同一条命令，根据报错信息检查依赖、配置或脚本参数。

提示：不同项目的入口脚本和参数可能不同，请以项目实际文档为准。