PHP无法直接串口通信,因其流层缺乏波特率等参数控制、无超时与缓冲管理,且Web进程常无设备权限;推荐用Python脚本代理(pyserial),PHP通过shell_exec调用,或构建独立Node.js/Rust串口服务。

PHP 本身不直接支持串口通信,无法像 Python 或 C 那样原生读取温湿度传感器(如 DHT22、SHT30、RS485 Modbus 设备等)的原始数据。必须借助外部程序、系统命令或扩展来桥接硬件层。
为什么 PHP 不能直接用 fopen('/dev/ttyUSB0') 读串口
Linux 下虽可尝试用 fopen() 打开串口设备文件,但默认会失败——PHP 的流层缺乏对串口参数(波特率、停止位、校验位)的控制能力,且没有内置串口初始化逻辑。即使打开成功,fread() 也极大概率返回空或乱码。
- PHP 流不支持
stty级别配置(如stty -F /dev/ttyUSB0 9600 cs8 -cstopb -parenb) - 无超时控制、无字节级接收缓冲管理,传感器响应延迟易导致阻塞或截断
- Web 进程(如 Apache/PHP-FPM)通常无权访问
/dev/tty*,权限拒绝是常态
可行方案:用 Python 脚本做串口代理,PHP 调用它
这是最稳定、权限可控、调试直观的方式。让 Python(用 pyserial)负责收发,PHP 只管执行和解析输出。
示例:读取通过 USB 转串口连接的 SHT30(ASCII 协议)
立即学习“PHP免费学习笔记(深入)”;
#!/usr/bin/env python3 import serial import systry: ser = serial.Serial('/dev/ttyUSB0', 115200, timeout=2) ser.write(b'rd\r\n') # 发送读取指令(依传感器协议而定) resp = ser.readline().decode('ascii', errors='ignore').strip() ser.close() print(resp) # 如:T:23.5,H:45.2 except Exception as e: print(f"ERROR:{str(e)}")
PHP 中调用:
$output = shell_exec('/usr/bin/python3 /path/to/sht30_reader.py 2>&1');
if (preg_match('/T:([0-9.]+),H:([0-9.]+)/', $output, $m)) {
$temp = (float)$m[1];
$humi = (float)$m[2];
} else {
error_log("Sensor read failed: " . escapeshellarg($output));
}
- 确保 PHP 进程用户(如
www-data)已加入dialout组:sudo usermod -a -G dialout www-data - Python 脚本需有执行权限:
chmod +x sht30_reader.py - 避免在 Web 请求中频繁 fork 进程;高并发下建议改用 socket 或 systemd socket 激活的守护进程
替代方案:用 php_serial.class.php(不推荐)
这是一个老旧的纯 PHP 串口封装类,依赖 exec('stty') 和 fopen(),在现代 Linux(尤其是 systemd 环境)下基本不可靠。
- 无法处理非标准波特率(如 115200)、不兼容 termios 新特性
- PHP-FPM 下
exec('stty')常因权限/环境变量缺失而静默失败 - GitHub 上最后更新是 2014 年,无维护,不兼容 PHP 8+
若仍想试,至少加强制错误捕获:
$serial->deviceSet("/dev/ttyUSB0");
$serial->confBaudRate(9600);
$serial->confParity("none");
$serial->confCharacterLength(8);
$serial->confStopBits(1);
$serial->deviceOpen();
if (!$serial->status) {
throw new RuntimeException("Serial open failed: " . $serial->errorMessage);
}
更健壮的长期选择:用 Node.js 或 Rust 写串口服务
当传感器数量增加、需多路轮询或实时推送时,PHP 直接调脚本会成为瓶颈。此时应剥离串口逻辑,构建独立服务:
- 用 Node.js(
serialport包)监听串口,通过 HTTP API 或 WebSocket 提供/api/sensor?sensor=sht30 - 或用 Rust(
tokio-serial)写轻量 daemon,监听 Unix socket,PHP 用stream_socket_client()连接 - 关键点:服务进程由 systemd 管理,拥有固定 UID/GID 和串口权限,与 Web 层完全解耦
串口通信的可靠性不在语言,而在权限、超时、重试、帧校验——这些 PHP 很难干净地做。把脏活交给专精的工具,PHP 安心做业务逻辑,才是实际项目里少踩坑的路径。











