PHP信号量必须先用sem_get()创建句柄，否则sem_acquire()会报错；需用ftok()生成稳定键值，设置$auto_create=true确保创建；高并发下须用非阻塞模式加超时重试，避免永久阻塞。
PHP信号量函数必须用sem_get()创建
PHP本身没有原生的“信号量对象”，所有信号量操作都依赖系统级IPC（进程间通信）设施，必须先调用sem_get()获取一个信号量键值句柄。不调用它就直接sem_acquire()会报Warning: sem_acquire(): Invalid semaphore key——这是新手最常踩的坑。
注意：sem_get()第一个参数是整数键（$key），不是字符串名；建议用ftok(__FILE__, 'a')生成稳定键值，避免硬编码数字引发冲突：
if (!extension_loaded('sysvsem')) {
die('sysvsem extension required');
}
$sem_key = ftok(__FILE__, 'a'); // 生成唯一键
$sem = sem_get($sem_key, 1, 0666, true); // 初始值1，权限0666，$auto_create=true其中第四个参数$auto_create设为true很重要：它确保即使信号量尚不存在也能创建，否则并发请求可能因抢不到已存在的信号量而失败。
高并发下sem_acquire()要加超时和重试逻辑
sem_acquire()默认阻塞等待，一旦某个进程崩溃未释放信号量，其他所有请求就会永久卡住。生产环境绝不能依赖默认行为。
立即学习“PHP免费学习笔记（深入）”；
必须显式传入$nowait = false以外的控制方式，并配合循环与超时判断：
- 使用
sem_acquire($sem, false)（即$nowait = false）会阻塞，风险极高 - 推荐用
sem_acquire($sem, true)（$nowait = true）做非阻塞尝试，失败后sleep再重试 - 总等待时间建议控制在500ms内，避免用户感知卡顿
示例节选：
$max_retries = 5;
$retry_delay_ms = 100;
for ($i = 0; $i < $max_retries; $i++) {
if (sem_acquire($sem, true)) {
break;
}
usleep($retry_delay_ms * 1000);
}
if ($i === $max_retries) {
throw new RuntimeException('Failed to acquire semaphore after ' . $max_retries . ' retries');
}必须配对调用sem_release()且放在finally块中
PHP没有try/finally的自动资源释放机制（尤其在早期版本），但信号量一旦acquire成功却未release，整个信号量就会被锁死，后续所有请求全部挂起。
务必把sem_release()放在明确的清理位置，最好用register_shutdown_function()兜底，或在现代PHP中用try/finally：
try {
if (!sem_acquire($sem, true)) {
throw new Exception('Cannot acquire semaphore');
}
// 执行临界区逻辑（如扣减库存、写日志等）
} finally {
if (isset($sem) && is_resource($sem)) {
sem_release($sem);
}
}注意：sem_release()不会校验调用者是否是持有者——它只是把计数器+1。所以多个进程误释放同一个信号量也不会报错，但会导致逻辑失控，这点和Redis分布式锁完全不同。
信号量不是万能的，别在Web请求中滥用
PHP-FPM或Apache模块模式下，每个请求由独立进程/线程处理，sysvsem信号量确实能跨进程生效。但它有严重局限：
- 仅限同一台机器上的进程，无法用于多实例部署场景
- 信号量键值受系统
SEMMSL/SEMMNI等内核参数限制，大量动态创建易触发PHP Warning: sem_get(): No space left on device - 没有TTL，无法自动过期，崩溃后需手动
ipcs -s+ipcrm清理
如果你的应用已上K8s或用了多台PHP服务器，应该换用Redis + Lua或数据库行锁；只有单机、短临界区、低QPS的后台脚本才适合用sysvsem。
真正容易被忽略的是：信号量只控制“进入顺序”，不解决数据一致性。比如两个进程都成功acquire后去读DB再更新，仍可能产生竞态——它只是门禁，不是数据库事务。
