phpEnv 默认不启用 SysvSemaphore 扩展，需手动编译并配置 --enable-sysvsem；验证可用性应执行 php -r "var_dump(function_exists('sem_get'));"，返回 false 或报错即未启用，且须通过 ftok+sem_get 实际调用测试内核级功能是否正常。
phpEnv 默认不启用 SysvSemaphore 扩展，必须手动编译并配置；它和 shmop、sysvshm 属于不同扩展，不能靠开启一个就自动带上另一个。
确认 phpEnv 当前 PHP 是否支持 SysV IPC
phpEnv 是基于多版本 PHP 切换的环境管理工具，其底层仍是标准 PHP 编译产物。SysV 信号量（SysvSemaphore）依赖内核支持和 PHP 编译时启用 --enable-sysvsem，而 phpEnv 的预编译包通常**默认关闭该选项**。
执行以下命令快速验证：
php -r "var_dump(function_exists('sem_get'));"
返回 bool(false) 即表示未启用；若报错 Call to undefined function sem_get()，也说明扩展缺失。
立即学习“PHP免费学习笔记（深入）”；
- 不要依赖
php -m | grep sysv—— phpEnv 下该命令可能只显示已加载的扩展名，但sysvsem在 PHP 7.4+ 后已不再作为独立模块名出现在php -m输出中 - 检查
phpinfo()页面搜索sysvsem或SysV Semaphores更可靠 - Linux 系统需确保内核启用
CONFIG_SYSVIPC=y（绝大多数发行版默认开启，无需额外操作）
为 phpEnv 中某 PHP 版本手动编译启用 sysvsem
phpEnv 不提供一键开启 sysvsem 的命令，必须进入对应 PHP 源码目录重新 configure + make。关键点在于：不能用 phpEnv 的 install 命令重装整个版本（会丢失已有扩展配置），而是要「原地重编译」。
- 先定位目标 PHP 版本源码路径，例如：
~/.phpenv/sources/8.2.12/ - 进入该目录后执行：
./configure --prefix=$HOME/.phpenv/versions/8.2.12 \ --with-config-file-path=$HOME/.phpenv/versions/8.2.12/etc \ --enable-sysvsem \ --enable-sysvshm \ --enable-sysvmsg \ [其他你原本启用的选项，务必保持一致]
- ⚠️ 必须复用原有 configure 参数，否则会丢掉
pdo_mysql、openssl等已有功能；可查历史记录：cat ~/.phpenv/sources/8.2.12/config.log | head -20或翻看 phpenv 安装日志 - 执行
make -j$(nproc) && make install，完成后重启 PHP 进程（如 php-fpm）或终端会话
验证 sysvsem 功能是否真正可用
即使 sem_get() 函数存在，也不代表能正常工作——常见失败原因是权限或 key 冲突。
php -r " \$key = ftok(__FILE__, 'a'); \$sem = sem_get(\$key, 1, 0600, 1); var_dump(\$sem !== false); if (\$sem) sem_remove(\$sem); "
- 如果报错
PHP Warning: sem_get(): failed to acquire semaphore，大概率是ftok()生成的 key 已被其他进程占用，换一个 project ID 字符（如'b'）再试 - 若提示
Permission denied，说明当前用户无权创建 SysV 对象，检查/proc/sys/kernel/sem值是否过小（如250 32000 32 128是安全下限） -
sem_remove()只释放信号量值，不销毁内核对象；真正清理要用ipcs -s+ipcrm -s <semid>
为什么不用 shmop 替代 SysvSemaphore？
有人试图用 shmop 模拟信号量（比如共享内存里存个计数器 + 轮询），这在高并发下极不可靠，且违背设计初衷。
-
shmop无原子操作保障，sem_get/sem_acquire才是内核级互斥原语 -
SysvSemaphore支持阻塞等待（sem_acquire($sem, true)）、超时、递归锁等特性，shmop完全无法替代 - PHP 8.0+ 中
SysvSemaphore类仍被保留，未标记 deprecated，说明它仍是合法的进程同步方案
真正容易被忽略的是：SysV IPC 对象生命周期独立于 PHP 进程，sem_remove() 只影响当前引用，不等于销毁系统资源；调试时残留的 semid 往往是后续测试失败的根源。
