php命令行跑定时任务,我把宝塔的计划任务换掉了
- 2026年11月19日
- 29 次
宝塔面板里加一条计划任务,选周期、粘路径、保存,第二天日志里就有输出。同一个脚本写进 crontab,只剩一句 command not found;同样一条命令在php命令行里手敲,跑得好好的。三个入口,三种结果。差的地方不在 PHP 代码本身,在于每次执行时加载了哪份 php.ini、又拿到了哪一套环境变量。
php命令行和网页模式的两套配置
判断给在前面:先跑 php --ini,看它到底加载了哪个文件,再去确认 FPM 那边加载的是不是同一个。不要从面板的 PHP 设置页面反推命令行的配置,那里显示的是 FPM 那份,两个页面长得一样,内容可以完全不同。

命令很短,两行就够:
php --ini
php -i | grep -E 'Loaded Configuration|memory_limit|disable_functions'
php --ini 输出四行,第二行 Loaded Configuration File 就是答案。apt 装出来的 PHP,CLI 和 FPM 各有一份配置文件,CLI 在 cli/php.ini,FPM 在 fpm/php.ini,同一个版本号下面并排两个目录。改错文件的现象很好认:命令行里 memory_limit 显示 -1(不限),你在 FPM 那份 ini 里改成 256M,命令行再查还是 -1。
第二行命令的输出更直接,memory_limit => -1 => -1 说明这份配置压根不限内存,disable_functions => no value => no value 就是一条没禁。网页那边通常是 128M、禁掉 exec、shell_exec、proc_open 这一串。同一个导出脚本在浏览器里跑到一半爆内存,在命令行里一路跑完,差别就在这两行,不在代码。
disable_functions(禁用函数)在分开安装的情况下是两份独立名单。网页侧禁了 exec,CLI 侧未必禁;脚本在命令行里调 exec 一切正常,搬到网页就报错:PHP 8 起是 Call to undefined function exec(),PHP 7 是 Warning: exec() has been disabled for security reasons 加一个 null 返回值,看着都像扩展没装,其实是配置挡的。
反过来的情况也常见。宝塔这类自己编译的 PHP,一个版本只有一份 php.ini,CLI 和 FPM 共用。这种机器上改 disable_functions 会同时动到两边,「命令行宽松、网页严格」的假设直接不成立;改之前先看那行 Loaded Configuration File,两份路径相同就是共用,不同才是分开。判据只有这一条,其他说法都是猜。
crontab里写php绝对路径的原因
cron 执行任务时用的环境比登录 shell 瘦得多。它的 PATH 常见只有 /usr/bin:/bin,php、python、node 这些装在 /usr/local/bin 或者面板自带目录下的,一律找不到。

这件事不要猜,让 cron 自己把 PATH 打出来。临时往 crontab 加一行 * * * * * echo $PATH > /tmp/cron_path.txt 2>&1,一分钟以后读那个文件,看到的就是真实值。/www/server/php/82/bin 这种目录基本不会在里面,所以 php cron.php 的结果是 /bin/sh: php: command not found —— 连 PHP 都没启动,也就轮不到 PHP 报错。
正式的写法把解释器和路径全写死:
17 3 * * * cd /www/wwwroot/site && /www/server/php/82/bin/php cron.php >> /www/wwwlogs/cron.log 2>&1
cd 那一段不能省。cron 的工作目录是执行用户的 home,不是脚本所在目录。脚本里写 require 'config.php' 这种裸相对路径,日志里就是这样的两行:PHP Warning: require(config.php): Failed to open stream: No such file or directory in /www/wwwroot/site/cron.php on line 12,紧跟一句 PHP Fatal error: require(): Failed opening required 'config.php'。报错里明明写着 cron.php,找不到的却是 config.php,新手看到这两行很容易去查权限。改成 require __DIR__ . '/config.php' 就没了。
PHP_BINARY 的问题更隐蔽。脚本内部拿它去拼子进程命令,FPM 下这个常量指向的是 php-fpm 的可执行文件,不是 php;which php 给出的才是 CLI 路径,两者从来不是一回事。同一段代码从网页触发,拼出来的子进程命令是 php-fpm,执行完什么也没发生,日志里干干净净。要拼子进程,先判断 PHP_SAPI === 'cli' 再用 PHP_BINARY,或者在配置里单独存一个 CLI 路径。
命令行下的环境变量和超时时间
$_SERVER 在 CLI 下少了 HTTP_HOST、REQUEST_URI、REMOTE_ADDR 这一批。框架靠它拼站点域名,命令行里取到空值,生成的绝对 URL 只剩路径部分,写进数据库几十条之后才发现全是相对地址。
max_execution_time 在 CLI 下默认 0,也就是不限时。网页侧一般 30 秒或 60 秒就断。同一个导出脚本,网页上跑一半 502,php命令行里能跑二十分钟,不是命令行更快,是那道闸根本没装。补一句机制:Linux 上 max_execution_time 只统计 CPU 时间,脚本卡在数据库或 curl 上照样不算,真正兜底的是 php-fpm 的 request_terminate_timeout。

闸没了,代价跟着来。脚本卡在一个不退出的循环里,网页侧到 60 秒被掐掉,命令行侧会一直挂着;第二天 cron 再起一个,两个进程抢同一张表,数据就乱了。长任务加锁是最便宜的办法:
<?php
$lock = fopen(__DIR__ . '/cron.lock', 'c');
if (!$lock || !flock($lock, LOCK_EX | LOCK_NB)) {
exit(1);
}
require __DIR__ . '/bootstrap.php';
抢不到锁直接 exit(1),进程结束时锁自动释放。退出码给 1 而不是 0,是为了让日志和监控能看出这一轮空跑了。
退出码、日志和失败通知
退出码是留给日志和监控看的,cron 自己不判断成败。一个任务在php命令行里跑成功、进了 cron 却报失败,多数时候就是这两个数字对不上:PHP 正常结束是 0,Fatal error 是 255,exit(1) 是你自己给的。这个数字不会写进任何地方,除非你把输出重定向了,或者配了邮件。
默认情况下 cron 不发通知。任务连着一周失败,唯一痕迹是日志末尾那几行。要收信,crontab 顶部加 MAILTO=you@example.com,机器上还得有能发信的 MTA;没有 MTA 的话这一行写了也是空的。
更省事的办法是让脚本自己记账:开始时写一行时间戳,结束时写退出码,所有输出 >> 追加进同一个文件。第二天翻日志,第一眼看时间戳有没有断档,断在哪一段就知道卡在哪一步。
什么时候继续用面板的计划任务
面板那套在几种情况下确实更合适。机器上并存三个 PHP 版本、每个版本各有自己的 ini 目录,面板的「PHP 命令行版本」一换就把软链指对了,不用记路径;任务依赖面板的备份钩子,跑完要触发面板自己的清理流程;团队里没人愿意碰 shell,出了问题得有人能看懂界面。
反过来,这几种别硬搬 crontab。任务要求秒级精度 —— cron 最小粒度是一分钟,秒级得自己在脚本里写循环,写出来的东西比面板的定时器更难维护;需要跨机器统一编排 —— cron 只管本机那一台;以及你拿不到机器上的日志文件的时候。命令行排障全靠日志和退出码,看不到日志,生产任务就不该迁过去。
我自己还遇到过一处版本差异:有些编译参数下 CLI 和 FPM 真的共用一份 php.ini,那种机器上改网页配置会连带影响命令行。判断依据始终是 php --ini 打出来的那行路径,不是任何教程里的默认值。
若非作者标注皆为李涛自留地原创文章,转载或复制请以超链接形式并注明出处。
- ZblogPhp主题制作五侧边栏设置 ZblogPhp侧边栏主题制作 2022-10-15
- PHP array_filter() 函数详解:按条件过滤数组元素 2026-07-02
- PHP中数组是什么?PHP数组怎么创建及打印输出 2022-10-20
- IT男的兴奋点是什么? 2021-01-03
- ZblogPhp代码实现限制首页调用文章数量 2022-10-10
- PHP替换字符串函数str_replace()用法及实例 2022-11-12
