如何配置FrankenPHP1.1定时任务脚本-php教程-PHP中文网

frankenphp 1.1 不内置定时任务调度器，需在宿主系统中通过 cron 或 systemd timer 调用与之 php 环境一致的 cli 脚本；关键步骤包括确认 php 路径、编写独立 cli 脚本、显式指定绝对路径及环境，并做好日志与权限管理。

如何配置frankenphp1.1定时任务脚本

FrankenPHP 1.1 本身不内置定时任务调度器（如 cron daemon），它是一个以 SAPI 模式运行 PHP 的现代 Web 服务器（基于 PHP 的 embed SAPI + HTTP/2 + Workers），核心职责是处理 HTTP 请求。所以“配置 FrankenPHP 的定时任务脚本”，实质上是指：在运行 FrankenPHP 的宿主系统中，正确设置外部定时任务（如系统 cron 或 systemd timer），使其定期调用 PHP 脚本——该脚本可与 FrankenPHP 应用逻辑复用（如调用 Laravel 命令、执行数据库清理、触发队列等）。

以下是清晰、可落地的操作步骤：

确认 PHP CLI 环境与 FrankenPHP 使用的 PHP 一致

FrankenPHP 通常自带或依赖特定版本的 PHP（例如通过 frankenphp:1.1-cli 镜像或本地编译的 PHP）。定时任务必须使用**同一套 PHP 可执行文件和扩展**，否则可能出现扩展缺失（如 pdo_mysql、redis）、路径错误或版本不兼容。

查 FrankenPHP 当前使用的 PHP 路径：
在 FrankenPHP 项目目录下运行：
./frankenphp php --version 或 $(which frankenphp) php --version
记下输出中的 PHP 二进制路径（例如 /usr/local/bin/php 或 /opt/frankenphp/php）
后续所有 cron 脚本都应显式调用该路径，而非仅写 php

编写可独立运行的 PHP 定时脚本

不要依赖 FrankenPHP 的 Worker 或 HTTP 上下文。脚本应为标准 CLI 模式，支持命令行参数、环境变量隔离，并能安全退出。

btpanel phpsite 宝塔面板PHP网站

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

下载

脚本示例 app:cleanup（保存为 bin/cleanup.php）：
// 设置正确的环境（尤其 .env 文件位置）
putenv('APP_ENV=production');
require __DIR__.'/../vendor/autoload.php';
(new App\CleanupService())->run();
确保脚本有可执行权限：
chmod +x bin/cleanup.php
测试是否能手动运行：
/opt/frankenphp/php bin/cleanup.php

用系统 cron 添加定时任务

推荐编辑当前用户（如 www-data 或 frankenphp 用户）的 crontab，避免权限冲突。

切换到 FrankenPHP 运行用户（常见为 www-data）：
sudo -u www-data crontab -e
添加一行（例如每天凌晨 2 点执行）：
0 2 * * * /opt/frankenphp/php /var/www/myapp/bin/cleanup.php >> /var/log/cleanup.log 2>&1
日志重定向很重要：便于排查失败（如权限不足、路径错误、未加载 .env）
注意：cron 中 PATH 很窄，务必写绝对路径；HOME 和 WORKDIR 不继承 shell，需在命令中用 cd /var/www/myapp && ... 或在脚本内 chdir(__DIR__.'/..')

（可选）用 systemd timer 替代 cron（更可控、可监控）

适用于 Linux 系统且偏好声明式管理的场景。需创建两个文件：

/etc/systemd/system/app-cleanup.service：
[Service]
Type=oneshot
User=www-data
WorkingDirectory=/var/www/myapp
ExecStart=/opt/frankenphp/php bin/cleanup.php
Environment="APP_ENV=production"
/etc/systemd/system/app-cleanup.timer：
[Timer]
OnCalendar=*-*-* 02:00:00
Persistent=true
[Install]
WantedBy=timers.target
启用并启动：
sudo systemctl daemon-reload
sudo systemctl enable --now app-cleanup.timer
sudo systemctl list-timers | grep cleanup