PHP用cron设置定时任务控制硬件

本文深入解析了如何在Linux系统中通过系统级cron调度器安全可靠地运行PHP脚本以控制硬件（如GPIO、串口等），明确指出PHP自身不具备嵌入式定时能力，所谓“PHP定时任务”实为cron定期调用具备可执行权限、使用绝对路径、记录详细日志、校验硬件状态并拥有正确用户组权限（如gpio组）的PHP脚本；文章还强调避免sleep或信号陷阱等不可靠方式，直击权限配置、环境隔离与错误处理等实战痛点，为物联网和嵌入式PHP开发提供清晰、稳健的落地指南。

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。

• 每 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 只负责“叫醒”脚本，叫醒之后脚本能走多远，取决于你给它开了多少扇门。

好了，本文到此结束，带大家了解了《PHP用cron设置定时任务控制硬件》，希望本文对你有所帮助！关注golang学习网公众号，给大家分享更多文章知识！