配置 crontab 执行 PHP 脚本实战指南

一、为什么需要crontab执行PHP脚本？

在Web开发中，经常需要定时执行后台任务，例如：数据报表生成、缓存清理、异步通知等。通过Linux系统的crontab服务配合PHP CLI模式，可以高效稳定地实现这些自动化需求。

二、环境准备

确保系统已安装：

 检查PHP CLI版本
php -v

 检查crontab服务状态
systemctl status cron

三、配置crontab的完整步骤

1. 创建PHP可执行脚本

!/usr/bin/env php
<?php
// /var/www/scripts/task.php
date_default_timezone_set('Asia/Shanghai');
file_put_contents('/var/log/php_cron.log', 
    date('Y-m-d H:i:s')." 任务执行成功n", 
    FILE_APPEND);

2. 设置脚本权限

chmod +x /var/www/scripts/task.php
chown www-data:www-data /var/www/scripts/task.php

3. 编辑crontab任务

 打开当前用户的crontab
crontab -e

 添加以下内容（每天凌晨3点执行）
0 3    /usr/bin/php /var/www/scripts/task.php >> /var/log/php_cron.log 2>&1

四、高级配置技巧

1. 多环境路径处理

 使用which定位PHP路径
/usr/bin/env php /path/to/script.php

2. 错误日志监控

 在脚本中实现错误捕获
try {
    // 业务代码
} catch (Exception $e) {
    error_log($e->getMessage());
}

3. 锁机制防重复执行

$lockFile = '/tmp/script.lock';
if (file_exists($lockFile)) {
    exit();
}
file_put_contents($lockFile, getmypid());
// 业务代码...
unlink($lockFile);

五、常见问题排查

• 权限问题：确保crontab用户对脚本和日志文件有读写权限
• 环境变量：在脚本中显式设置PATH或使用绝对路径
• 时区不一致：在PHP脚本开头设置date_default_timezone_set()
• 无输出：检查/var/mail/$USER中的系统邮件

六、最佳实践建议

1. 为每个任务单独创建日志文件
2. 生产环境添加执行超时限制
3. 使用flock命令实现原子锁
4. 重要任务添加邮件通知机制