PHP脚本不能直接作为cron任务控制硬件,必须由系统cron定期调用;需设可执行权限、用绝对路径、记录日志、校验硬件状态并确保用户权限(如加入gpio组),且cron最小粒度为1分钟。

PHP 脚本不能直接当 cron 任务控制硬件,得靠系统 cron 调用
PHP 本身没有“嵌入式定时任务”机制,cron 是 Linux 系统级调度器,不是 PHP 的函数或扩展。所谓“PHP cron”,实际是让系统 cron 定期执行一个 PHP 脚本,再由该脚本去操作硬件(如 GPIO、串口、USB 设备等)。直接在 PHP 进程里用 sleep() 或 pcntl_alarm() 做定时,既不可靠,也无法长期驻留,更无法响应系统重启。
- PHP 脚本必须有可执行权限(
chmod +x /path/to/script.php),或通过php /path/to/script.php显式调用 - 硬件操作(如写
/sys/class/gpio/gpio17/value)需要运行脚本的用户有对应权限,通常要加进gpio或dialout用户组,或用sudo(不推荐无密码 sudo) - 脚本内避免使用相对路径 ——
cron的工作目录默认是用户家目录,__DIR__或getcwd()可能非预期
怎么写一个能被 cron 正确调用的硬件控制 PHP 脚本
关键点:环境隔离、错误捕获、硬件状态校验。比如控制树莓派 LED 亮灭:
#!/usr/bin/env php
// 导出引脚(仅首次需要,失败也继续)
@file_put_contents("$gpio_path/export", $gpio_pin);// 设置为输出模式
file_put_contents("$gpio_path/gpio{$gpio_pin}/direction", "out");
// 读取当前状态,取反
$current = (int)file_get_contents("$gpio_path/gpio{$gpio_pin}/value");
$next = 1 - $current;
file_put_contents("$gpio_path/gpio{$gpio_pin}/value", $next);
// 记录日志(避免 stdout/stderr 丢失)
file_put_contents("/tmp/led-cron.log", date('Y-m-d H:i:s') . " → {$next}\n", FILE_APPEND);
- 开头加
#!/usr/bin/env php才能直接chmod +x后被 cron 执行 - 所有硬件路径用绝对路径;
@抑制导出失败警告(已导出时会报错) - 务必记录日志 —— cron 默认丢弃 stdout/stderr,不写日志等于没跑
- 不要依赖 $_SERVER 或 Web 环境变量,cron 环境极简,PATH 往往只有
/usr/bin:/bin
怎么配系统 cron 并确认它真在运行
用 crontab -e 编辑当前用户定时任务。硬件控制建议用 root 或专用低权限用户(如 pi),别用 www-data。
立即学习“PHP免费学习笔记(深入)”;
- 每 30 秒执行一次?不行 ——
cron最小粒度是 1 分钟。高频控制请改用 systemd timer 或后台常驻进程 - 正确写法(每分钟执行):
* * * * * /usr/bin/php /home/pi/led-toggle.php >> /tmp/cron-php.log 2>&1 - PATH 不全?显式指定
php绝对路径(which php查),或在 crontab 开头加PATH=/usr/local/bin:/usr/bin:/bin - 验证是否生效:
grep CRON /var/log/syslog看有没有执行记录;tail -f /tmp/led-cron.log看脚本输出
为什么硬件控制容易失败?几个硬坑必须绕开
PHP 脚本在 cron 下跑和 CLI 下手动跑,行为可能完全不同 —— 权限、环境变量、当前目录、SELinux/AppArmor 限制都可能拦路。
-
Permission denied写 GPIO?检查ls -l /sys/class/gpio/gpio17/,确认value文件可写,且执行用户在gpio组(usermod -a -G gpio pi) - 串口设备(如
/dev/ttyUSB0)打不开?cron 下 udev 规则可能未生效,或设备名动态变化,建议用/dev/serial/by-id/...固定路径 - 脚本执行了但硬件没反应?先手动运行一遍,加
var_dump(file_put_contents(...))确认返回值非false,再查系统日志是否有内核拒绝访问(dmesg | tail) - 想用
exec("gpio write 0 1")?确保wiringPi已安装,且命令在 cron 的 PATH 里,否则加完整路径/usr/local/bin/gpio
真正卡住的往往不是 PHP 语法,而是 Linux 权限模型和硬件抽象层之间的那层薄冰。cron 只负责“叫醒”脚本,叫醒之后脚本能走多远,取决于你给它开了多少扇门。











