PHP读取树莓派GPIO电平方法

PHP本身无法直接操作树莓派GPIO，文章深入剖析了三种常见但各有缺陷的“曲线救国”方案：通过sysfs文件系统轻量读取（需手动导出引脚、权限配置繁琐、仅支持轮询）、调用已弃用的WiringPi命令行工具（兼容性差、性能低、新版系统不支持），以及危险的pcntl_fork后台尝试（易致僵尸进程、FPM中禁用、违背Web请求生命周期）；最终明确指出，真正稳定、可维护、面向生产的方案是剥离职责——用C或Python编写基于现代libgpiod的常驻采集服务，暴露API或Socket接口，让PHP专注业务逻辑与数据消费，彻底规避权限冲突、竞态风险与架构硬伤。

PHP 本身没有内置 GPIO 操作能力，不能直接读取树莓派的 GPIO 引脚电平。必须借助系统层工具（如 sysfs 接口）或外部命令桥接，且需确保权限和内核支持。

用 sysfs + file_get_contents() 读取 GPIO 状态（最轻量）

树莓派 Linux 内核默认启用 sysfs GPIO 接口（路径为 /sys/class/gpio/），PHP 可以通过文件读写操作获取电平值。前提是该引脚已导出并设为输入模式。

• 先在 shell 中手动导出并配置引脚（例如 GPIO 17）：

  echo 17 > /sys/class/gpio/export
  echo in > /sys/class/gpio/gpio17/direction

• PHP 中读取电平只需：

  $value = (int) file_get_contents('/sys/class/gpio/gpio17/value');

  返回 0 或 1，对应低电平/高电平
• 注意：PHP 进程必须有读取 /sys/class/gpio/gpio*/value 的权限（通常需加入 gpio 用户组，或用 sudo 启动 Web 服务 —— 不推荐）
• 不支持实时中断或边沿触发，仅适合轮询式低频检测（如按钮状态、开关信号）

调用 gpio 命令行工具（兼容性更好，但依赖 WiringPi 已弃用）

老项目可能还在用 wiringpi 提供的 gpio 命令，它封装了底层操作，对 PHP 更友好，但 WiringPi 自 2019 年起不再维护，且新版 Raspberry Pi OS（基于 Debian 11+）默认不预装。

• 安装（仅限旧系统）：

  sudo apt install wiringpi

• PHP 中执行：

  $level = (int) trim(shell_exec('gpio -g read 17'));

  其中 -g 表示使用 Broadcom GPIO 编号（即 BCM 编号），17 是引脚号
• 若返回空或报错 command not found，说明未安装或架构不兼容（如 ARM64 系统上部分二进制不可用）
• 该方式会 fork 新进程，频繁调用有性能开销，不适合高频采样（>10Hz）

用 pcntl_fork() + exec() 避免 Web 服务器阻塞（慎用）

如果 PHP 运行在 Apache/Nginx + PHP-FPM 下，直接读 /sys/class/gpio/ 一般不会阻塞；但若你尝试用 exec() 调用带延迟的命令（如 gpio readall），可能引发超时或子进程残留。

• 避免在响应中执行耗时 GPIO 操作：不要在 HTTP 请求里循环读取多个引脚并 sleep
• 若需后台监听，应另起守护进程（如用 Python + RPi.GPIO 或 libgpiod），PHP 只负责读取其输出文件或 socket
• pcntl_fork() 在 PHP-FPM 中默认禁用，且 fork 出的子进程脱离请求生命周期后易成僵尸进程，不建议用于 GPIO 监听

真正稳定的做法是：用 C/Python 写一个常驻的 GPIO 采集服务（推荐 libgpiod，取代已废弃的 sysfs 接口），暴露 HTTP API 或本地 socket；PHP 只做请求和解析。否则，硬用 PHP 直接碰硬件，权限、竞态、可维护性全是坑。

文中关于的知识介绍，希望对你的学习有所帮助！若是受益匪浅，那就动动鼠标收藏这篇《PHP读取树莓派GPIO电平方法》文章吧，也可关注golang学习网公众号了解相关技术文章。