FrankenPHP 1.1 不内置定时任务调度器，需在宿主系统中通过 cron 或 systemd timer 调用与之 PHP 环境一致的 CLI 脚本；关键步骤包括确认 PHP 路径、编写独立 CLI 脚本、显式指定绝对路径及环境，并做好日志与权限管理。
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 模式，支持命令行参数、环境变量隔离，并能安全退出。
立即学习“PHP免费学习笔记（深入）”；
- 脚本示例 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
不复杂但容易忽略：定时任务不是 FrankenPHP 的功能，而是你部署环境的一部分。关键是让 PHP CLI 环境对齐、脚本健壮、执行上下文明确。
