php无法直接操作树莓派GPIO，需通过sysfs文件系统（如file_get_contents读取/sys/class/gpio/gpio17/value）或gpio命令行工具（依赖已弃用的WiringPi），但均存在权限、性能与维护性问题；推荐用C/python编写独立采集服务并提供API供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），可能引发超时或子进程残留。
立即学习“PHP免费学习笔记（深入）”；
- 避免在响应中执行耗时 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 直接碰硬件，权限、竞态、可维护性全是坑。