php串口超时无效的根本原因是阻塞式read()陷入内核态，使php计时器失效；正确方案是用stream_select()配合非阻塞模式或使用php-ext-serialport扩展实现可控超时。
PHP 本身不原生支持串口通信，所谓“PHP 串口超时”问题，本质是调用外部工具（如 stty + cat/echo）或扩展（如 php_serial、php-ext-serialport）时，底层系统调用未设置超时导致的永久阻塞。直接在 PHP 层用 set_time_limit() 或 ini_set('max_execution_time') 无法中断正在等待串口数据的系统调用。
为什么 set_time_limit() 对串口读写无效
PHP 的执行时间限制只作用于 PHP 用户态代码，而串口读写（如 fread()、stream_get_contents()）在阻塞模式下会陷入内核态的 read() 系统调用。此时 PHP 解释器已暂停调度，计时器停止，超时机制完全失效。
-
fopen('/dev/ttyUSB0', 'r+')后直接fread($fp, 1024)—— 若设备无响应，PHP 进程将卡死 -
pcntl_alarm()在大多数 Linux 发行版中无法中断read()，尤其当串口被stty配置为 canonical 模式时 - 即使使用
stream_set_timeout()，它仅对 socket 流生效，对串口文件流（php://以外的普通文件路径）完全不生效
正确做法：用 stream_select() 实现非阻塞轮询
必须将串口文件描述符设为非阻塞，并用 stream_select() 管理 I/O 就绪状态。这是唯一可移植、可控的 PHP 层超时方案。
- 打开串口后，立即调用
stream_set_blocking($fp, false) - 每次读取前，用
stream_select()检查流是否就绪，指定超时秒数和微秒数 - 若
stream_select()返回 0，说明超时；返回 >0 才调用fread() - 注意：串口需提前用
stty配置为 raw 模式，否则可能因行缓冲行为导致stream_select()始终不就绪
#!/usr/bin/env php
<?php
$fp = fopen('/dev/ttyUSB0', 'r+');
if (!$fp) die("无法打开串口\n");
// 设置为非阻塞
stream_set_blocking($fp, false);
// 配置 stty（实际项目中建议提前执行一次）
exec('stty -F /dev/ttyUSB0 9600 cs8 -cstopb -parenb -icanon -echo -echoe -echok -echoctl -echoke -ixon -crtscts');
// 准备 select
$read = [$fp];
$write = null;
$except = null;
// 等待最多 2 秒
if (stream_select($read, $write, $except, 2, 0) > 0) {
$data = fread($fp, 1024);
echo "收到: " . bin2hex($data) . "\n";
} else {
echo "串口读取超时\n";
}
fclose($fp);
?>
更可靠的方案：改用 php-ext-serialport 扩展
社区维护的 php-ext-serialport（GitHub 可搜）提供了真正的带超时参数的读写函数，底层封装了 select() 和 ioctl() 控制，比纯 PHP 轮询更稳定。
立即学习“PHP免费学习笔记（深入）”；
- 安装后可用
SerialPort::open()，传入['timeout' => 3000]（毫秒） -
$port->read(1024)会在超时后抛出SerialPortException，而非阻塞 - 避免手动处理
stty、非阻塞标志、信号中断等底层细节 - 注意：该扩展需编译安装，不支持 Windows；PHP 8.1+ 需确认兼容性
真正决定串口是否超时的，从来不是 PHP 的时间配置，而是你有没有让内核放弃「等数据来」的执念。用 stream_select() 或专用扩展，本质上是在告诉操作系统：“我只等 X 秒，过了就继续干活”。漏掉这步，所有 PHP 层的 timeout 设置都是幻觉。
