Ubuntu与Debian系统下PHP dio扩展串口读写故障问题

核心问题分析 #

你的代码在Mac/Windows正常但Linux失效，主要原因有两点：串口参数未配置、不必要的O_CREAT标志，权限问题是次要但需排查的点。

具体修复步骤 #

1. 移除O_CREAT标志 #

Linux下/dev/ttyUSB0是现成的设备节点，O_CREAT会尝试创建同名文件（如果权限允许），导致你实际操作的不是串口设备。修改打开代码：

$bbSerialPort = dio_open($portName, O_RDWR);

2. 强制配置串口参数 #

minicom会自动设置波特率、奇偶校验等参数，但PHP dio扩展打开串口后使用默认参数，大概率和设备要求不匹配。添加dio_tcsetattr配置：

// 打开串口后立即配置参数，需和minicom测试时的配置完全一致
dio_tcsetattr($bbSerialPort, array(
    'baud' => 9600, // 替换为你的设备实际波特率
    'bits' => 8,
    'stop'  => 1,
    'parity' => 0
));

3. 验证用户权限 #

确保运行PHP的用户（如web环境的www-data，CLI环境的当前用户）属于dialout组（Linux下串口设备默认归属该组）：

# 查看用户当前所属组
groups www-data
# 将用户添加到dialout组
sudo usermod -aG dialout www-data
# web环境需重启PHP-FPM/Apache，CLI环境需重新登录生效

4. 调试验证 #

• 用dio_stat($bbSerialPort)检查打开的设备信息，确认是串口设备而非普通文件
• 用strace跟踪PHP进程，查看底层系统调用的返回值，定位潜在错误：

strace -e open,write,read php your_script.php

内容的提问来源于stack exchange，提问作者Andy Slade