Workerman 可在树莓派运行，但需 PHP 8.1+ ARM64 环境、启用 pcntl/posix/sockets 扩展，禁用 x86 不兼容扩展（如 Swoole），绑定 IPv4 地址并调优进程数与事件驱动。
能跑，但必须用 PHP 8.1+ + ARM64 编译的扩展，且不能依赖 x86 专属的 Swoole 或 ReactPHP 底层。
Workerman 在树莓派上启动失败的常见报错
很多人一执行 php start.php start -d 就卡住或直接退出，日志里看不到错误——这通常不是 Workerman 本身的问题，而是它依赖的 PHP 扩展没装对。比如：
-
PHP Warning: Module 'swoole' already loaded in Unknown on line 0：说明误装了 x86 的 Swoole 扩展（.so 文件不兼容 ARM） - 进程启动后立即消失，
ps aux | grep workerman查不到：PHP 没启用pcntl或posix扩展，而 Workerman 默认靠这两个做进程管理 -
stream_socket_server(): unable to connect to tcp://0.0.0.0:2345 (Address family not supported by protocol)：IPv6 配置异常，树莓派某些旧内核对AF_INET6支持不稳，建议显式绑定127.0.0.1
树莓派 4B/5 安装 PHP 和 Workerman 的实操要点
Workerman 是纯 PHP 实现的，不编译 C 扩展也能跑，但要稳定、支持多进程，就得补全基础扩展。关键不是“能不能装”，而是“装哪个版本”：
- 系统必须是
Raspberry Pi OS 64-bit（即aarch64），用uname -m确认输出为aarch64 - PHP 版本推荐
8.2或8.3（Debian 12/Bookworm 源自带），避免用 apt 装 PHP 8.0 以下——老版本对 ARM 的pcntl_fork()调用有信号处理缺陷 - 必须启用的扩展：
pcntl、posix、sockets、json；用php -m | grep -E "pcntl|posix|sockets"检查 - Workerman 本身不用编译，
composer require workerman/workerman即可，但注意 Composer 要用 PHP 8.1+ 运行，否则 autoload 会报Attribute解析错误
性能瓶颈和绕过方案
Workerman 在树莓派上不是不能扛并发，而是容易在几个地方被拖慢：
- CPU 占满时，
pcntl_fork()创建子进程延迟明显升高（尤其树莓派 4B 的 A72 核没有大核调度优势），建议用$worker->count = 2控制进程数，别盲目设成cpu_count * 2 - 默认使用
select()事件轮询，在连接数 >1000 时响应变慢；可改用libevent扩展（ARM64 下需源码编译libevent-dev+pecl install libevent），然后在 Worker 构造时传['event' => 'libevent'] - 文件描述符限制低（默认 1024），
ulimit -n 65535要加进/etc/security/limits.conf，否则大量连接时出现Too many open files
真正麻烦的不是 Workerman 本身，而是你顺手引入的组件——比如用 monolog 写日志到 SD 卡，高频写入会让 MicroSD 寿命骤减且 I/O 延迟飙升；又比如用 redis 扩展连本地 Redis，结果发现 ARM 版 php-redis 的 socket 超时逻辑在高负载下偶发 hang 死。这些细节，比“能不能跑”更决定你最后能不能用得下去。
