sysvsem 扩展必须在编译 PHP 时通过 --enable-sysvsem 启用，因其是内置模块而非动态扩展，依赖系统 SysV IPC 支持；若编译未开启，则 php.ini 中 extension=sysvsem.so 无效，且无对应 so 文件。
phpenv 默认不启用 sysvsem 扩展，必须在编译 PHP 时显式开启 —— 它不是运行时通过 extension= 启用的常规扩展。
为什么 sysvsem 不能像 redis.so 那样直接加 extension？
因为 sysvsem 是 PHP 内置模块（built-in），不是动态加载的 PECL 扩展。它依赖系统级 SysV IPC 支持（semget/semctl 等系统调用），PHP 编译时需链接 libc 并定义宏才能暴露 sem_get、sem_acquire 等函数。若编译时没开，即使把 extension=sysvsem.so 写进 php.ini 也无效——根本不存在这个 so 文件。
- 运行
php -m | grep sysv返回空，大概率是编译漏了 -
php -r "var_dump(function_exists('sem_get'));"返回bool(false)，确认未启用 - Linux 系统需确保内核支持 SysV IPC（现代发行版默认开启，但容器或精简镜像可能关闭）
用 phpenv 编译带 sysvsem 的 PHP 版本
关键是在 php-build 的 configure 阶段传入 --enable-sysvsem。如果你已配置过全局 default_configure_options，需要追加这一项：
- 编辑配置文件：
vim ~/.phpenv/plugins/php-build/share/php-build/default_configure_options - 在已有参数末尾添加：
--enable-sysvsem --enable-sysvshm --enable-sysvmsg（三者常一起启用，分别对应信号量、共享内存、消息队列） - 保存后执行：
phpenv install 8.3.5（替换为你想装的版本） - 装完切版本：
phpenv global 8.3.5，再验证：php -r "echo extension_loaded('sysvsem') ? 'ok' : 'fail';"
常见失败点和绕过方式
即使加了 --enable-sysvsem，仍可能报错或函数不可用：
立即学习“PHP免费学习笔记（深入）”；
- 编译报
configure: error: sysvsem support requires sysv semaphore support in your system→ 检查系统是否禁用了 SysV IPC，例如某些 Alpine 容器默认不带sysvsem内核模块；可换用 Debian/Ubuntu 基础镜像，或手动加载：modprobe sysvsem（需 root） - 函数存在但调用失败，错误如
sem_get(): failed to get semaphore: No space left on device→ 不是磁盘满，而是内核信号量限制耗尽；查当前使用：ipcs -s，清理残留：ipcs -s | awk '/^0x/ {print $2}' | xargs -I{} ipcrm -s {} - macOS 上完全不可用 —— Darwin 内核不提供 SysV semaphores，
sysvsem在 macOS 下编译会静默跳过，函数始终不存在；必须改用sync扩展或文件锁替代
真正麻烦的从来不是加一行 --enable-sysvsem，而是确认目标环境内核是否真支持、是否有权限操作、以及旧进程是否遗留了未释放的信号量 ID —— 这些问题不会在 php -v 里报错，只会在业务逻辑卡死时才暴露。
