根本原因是系统缺少libevent-devel（CentOS/RHEL）或libevent2-dev（Debian/Ubuntu）开发包，需先卸载旧版、安装对应版本的开发包，验证/usr/include/event2/event.h存在后，再用对应PHP版本pecl重装event扩展并重启Workerman进程。

Workerman安装event扩展时提示“checking for include/event2/event.h not found”，说明编译器找不到libevent的开发头文件，根本原因是系统缺少libevent-devel（CentOS/RHEL）或libevent2-dev（Debian/Ubuntu）包，而非PHP扩展本身的问题。

确认缺失的是头文件而非运行库

执行 yum list installed | grep libevent（CentOS）或 dpkg -l | grep libevent（Ubuntu），若只显示 libevent 而无 libevent-devel 或 libevent2-dev，则证实是开发头文件包未装——运行库不能用于编译，必须单独安装开发包。

这一步操作起来很简单，直接把文件拖进去就行。

分系统安装对应开发包

方法一：CentOS/RHEL 7/8

先彻底卸载旧版残留：yum remove libevent-devel libevent

再安装正确版本：yum install libevent2-devel

【注意：libevent-devel ≠ libevent2-devel】 旧版 libevent-devel 对应 libevent 1.x，而 event 扩展强制要求 libevent 2.0+ 的头文件结构；若装错，configure 仍会报找不到 event2/event.h。

方法二：Ubuntu/Debian

apt-get update && apt-get install libevent-2.1-7 libevent-2.1-dev

不要只装 libevent-dev——它在较新发行版中已指向 libevent 1.x，必须显式指定 2.1 版本号。

验证头文件是否真正到位

执行 find /usr -name "event.h" 2>/dev/null，正常应返回类似路径：/usr/include/event2/event.h 或 /usr/include/event2/event_struct.h。

若无任何输出，说明开发包安装失败或安装路径异常；此时不要继续 pecl install，否则必然卡在 configure 阶段。

若路径存在但不在标准搜索目录（如装到了 /opt/libevent/include），则需手动指定：pecl install event --with-event-libevent-dir=/opt/libevent。

重新编译安装event扩展

第一步：清理上次失败残留

rm -rf /tmp/pear/download/event*

第二步：用对应 PHP 版本的 pecl 命令重试

/www/server/php/74/bin/pecl install event（路径按你实际 PHP 版本调整）

第三步：检查生成的 so 文件是否存在

ls -l /www/server/php/74/lib/php/extensions/no-debug-non-zts-20200930/event.so

若该文件不存在，说明编译中途失败，需回看上一步终端输出的最后 5 行错误——90% 是头文件路径问题未解决。

第四步：写入 php.ini 并重启 Workerman 进程

echo "extension=event.so" >> /www/server/php/74/etc/php.ini

【关键动作：必须停掉所有 workerman 进程再重启】 Workerman 是常驻内存进程，改完配置不重启等于没改。