webman不适合直接驱动树莓派gpio或直连传感器，因其为php高性能web框架，不支持稳定调用linux gpio接口，且事件循环无法处理硬件中断、adc采样或pwm输出；强行在控制器中执行系统命令会导致进程阻塞、权限错误和无超时挂起，正确做法是分层架构：webman仅作api网关，硬件控制交由python/c守护进程通过tcp或unix socket通信。
Webman 不适合直接驱动树莓派 GPIO 或直连传感器，它不是嵌入式运行时，而是 PHP 的高性能 Web 服务框架——用它做控制中心，必须搭配独立的硬件通信层（如 Python/Node.js 代理或 Workerman TCP 进程）。
为什么不能把 DHT22 或继电器逻辑写进 Webman 控制器
Webman 是常驻内存的异步 PHP 框架，但 PHP 本身不支持直接操作 Linux GPIO（sysfs 或 libgpiod 调用在 PHP 中极不稳定），且 Webman 的事件循环不处理硬件中断、ADC 采样或 PWM 输出。强行在 IndexController::index() 里调用 exec('gpio read 4') 会导致：
- 阻塞整个 Worker 进程，数千并发请求中只要一个读 DHT22 失败，就卡死该进程
- GPIO 文件系统权限问题频发（
/sys/class/gpio/gpio4/value默认仅 root 可写） - 没有超时控制，
file_get_contents('/sys/bus/i2c/devices/1-0023/light')可能挂起 5 秒以上
正确的分层架构：Webman 只管 HTTP/API，硬件交给专用进程
实际部署中，你得拆成两层：
- 底层：一个用 Python（
RPi.GPIO）或 C（wiringPi）写的守护进程，监听本地tcp://127.0.0.1:8081或 Unix Socket，接收 JSON 指令（如{"cmd":"relay","id":1,"state":1}），并返回采集数据（{"temp":26.3,"humid":48}） - 上层：Webman 作为 API 网关，用
stream_socket_client()或ReactPHP异步连接该守护进程，转发用户请求、聚合设备状态、处理鉴权和 WebSocket 推送
这种设计下，Webman 的高并发优势才真正落地——它不碰硬件，只做协议转换、状态缓存和权限校验。
Webman 2.2.0
下载
Webman 2.2.0版本强化了 TCP/UDP 服务支持，优化路由组管理，并增强异步任务处理能力。结合协程与连接池技术，Webman 能轻松应对高并发场景，适用于网站、接口服务、即时通讯、物联网及游戏开发，兼具高性能、灵活扩展与稳定可靠，是多场景 PHP 服务开发的理想选择。
Webman 中对接硬件代理的关键代码片段
不要在控制器里硬编码 socket 连接。用 Webman 的 process 目录启动一个长连接管理进程，避免每次 HTTP 请求都重连：
// app/process/HardwareProxy.php
namespace app\process;
use Webman\Process;
use Workerman\Connection\TcpConnection;
class HardwareProxy extends Process
{
protected $connection;
public function onWorkerStart()
{
$this->connection = stream_socket_client('tcp://127.0.0.1:8081', $errno, $errstr, 3);
if (!$this->connection) {
throw new \Exception("Hardware proxy connect failed: $errstr");
}
// 设置非阻塞，适配 Webman 异步模型
stream_set_blocking($this->connection, false);
}
public function onWorkerStop()
{
if ($this->connection) fclose($this->connection);
}
}
然后在控制器中复用这个连接句柄，而不是每次都 fopen()；同时务必加 try/catch 和超时判断，硬件链路不可靠是常态。
容易被忽略的三个硬伤点
真实跑起来后，你会反复踩到这些坑：
-
stream_socket_client()默认启用 DNS 解析，若本地/etc/hosts未配好，会卡住 30 秒才超时——务必显式传['dns_disable' => true]配置 - 树莓派的
systemd会 kill 掉非 session 进程，硬件代理进程必须用systemctl --user或supervisord托管，不能只靠php start.php start -d - Webman 的
json()响应默认不带 CORS 头，手机 App 或跨域 Web 页面调用会失败，需在中间件里加$response->withHeader('Access-Control-Allow-Origin', '*')
真正的智能家居控制中心，90% 的工作量不在 Webman 代码里，而在硬件通信的健壮性设计上——它不炫技，但容错、重试、心跳、日志缺一不可。
