PHP使用crontab设置定时任务教程

本文深入剖析了PHP脚本在crontab中无法正常执行的根源——并非代码缺陷，而是shell环境、PHP路径、工作目录、用户权限、SAPI模式及特殊字符处理等系统级差异所致；通过强调使用绝对PHP路径、显式声明PATH、重定向日志排查、区分CLI/Web运行环境、合理设计短生命周期脚本、规避伪定时陷阱，并给出chmod权限、SELinux调试、参数解析和%转义等实操要点，手把手教你绕过90%的“crontab跑不起来”坑，让定时任务真正稳定、可监控、易维护。

PHP脚本在crontab里不执行，多半是环境问题

crontab跑PHP脚本失败，90%不是代码问题，而是shell环境和PHP执行路径不一致。系统级crontab默认不用你的用户shell配置（比如~/.bashrc），所以php命令可能根本找不到，或者用的是系统自带的老版本php。

实操建议：

• 在crontab里写绝对路径：用which php查到真实路径，比如/usr/local/bin/php，而不是直接写php script.php
• 显式指定PATH：在crontab条目开头加PATH=/usr/local/bin:/usr/bin:/bin，避免找不到php或依赖命令（如curl、mysql）
• 重定向输出排查：加上> /tmp/cron.log 2>&1，否则错误全丢进黑盒，连Parse error都看不到
• 注意当前工作目录：crontab默认在/root或/下运行，脚本里用的相对路径（如include 'config.php'）会直接报错

PHP里用sleep()模拟定时？别这么干

有人在PHP里写while(true) { do_work(); sleep(300); }，以为这就叫“定时任务”。这是伪定时，进程一挂就停，没日志、没重启、没资源隔离，线上等于裸奔。

真正该做的只有两件事：

• 把业务逻辑写成短生命周期脚本：单次执行完就退出，比如php /var/www/backup.php
• 让crontab管调度：用标准时间表达式控制频率，比如*/5 * * * * /usr/local/bin/php /var/www/backup.php >> /var/log/backup.log 2>&1
• 如果真需要“每5秒跑一次”，说明你该用消息队列或长轮询，而不是硬塞进crontab（最小粒度是1分钟）

PHP脚本被crontab执行时权限不对

你在终端能跑通的脚本，放到crontab就提示Permission denied或failed to open stream: Permission denied，常见原因有三个：

• 脚本文件本身没可执行权限：chmod +x /var/www/script.php没用——PHP脚本不需要+x，但php script.php要求script.php对运行用户（如www-data）可读
• 脚本里写的日志路径、缓存目录，crontab用户（比如root）有权限，但PHP实际执行用户（比如www-data）没有——检查ps aux | grep php确认进程属主
• SELinux或AppArmor启用时拦截了访问，audit2why -a看拒绝日志，临时关掉验证是否是它拦的

如何让PHP脚本支持命令行参数并兼容crontab

很多PHP脚本只在Web下跑，一进crontab就崩，因为$_SERVER['REQUEST_METHOD']不存在，或者$_GET为空导致逻辑跳错。得明确区分运行环境。

简单可靠的判断方式：

• 用php_sapi_name()：值为cli就是命令行，fpm-fcgi或apache2handler就是Web
• 别依赖$_SERVER['HTTP_HOST']这类Web专属变量，改用getopt()解析参数，比如php script.php --env=prod --force
• 数据库连接、配置加载逻辑要统一入口：用if (php_sapi_name() === 'cli') { $config = parse_ini_file('/etc/myapp/cli.ini'); }

crontab本身不传参数，所以参数得写死在条目里，比如0 2 * * * /usr/local/bin/php /var/www/cleanup.php --days=7 >> /var/log/cleanup.log

最常被忽略的一点：crontab里的%符号会被shell当特殊字符处理，如果脚本里用了date +\%Y\%m\%d这种格式，必须写成\%转义，否则整个条目解析失败，且不会报错，只会静默跳过。

今天带大家了解了的相关知识，希望对你有所帮助；关于文章的技术知识我们会一点点深入介绍，欢迎大家关注golang学习网公众号，一起学习编程~