PHP扩展支持多线程有四种方案：一、启用ZTS编译并使用线程安全API；二、嵌入pthread库手动管理线程；三、用pcntl_fork或proc_open进程隔离替代线程；四、借助Swoole协程引擎实现伪多线程。
PHP扩展若需支持多线程，需绕过PHP核心的ZTS（Zend Thread Safety）限制与扩展自身的资源管理约束。以下是几种可行的实现思路：
一、启用ZTS编译并使用线程安全API
ZTS模式是PHP官方提供的线程安全基础，要求扩展在编译时链接ZTS版本的PHP，并全程使用Zend提供的线程安全宏与API访问全局变量和资源。
1、下载PHP源码，配置时添加--enable-zts参数重新编译PHP。
2、在扩展的config.m4中添加PHP_REQUIRE_ZTS检查，确保仅在ZTS环境下编译。
立即学习“PHP免费学习笔记（深入）”；
3、将所有全局静态变量替换为TSRMLS_DC传递的线程局部存储结构，例如使用zend_hash_init(&my_hash, 0, NULL, NULL, 1)中的最后一个参数设为1启用线程安全哈希。
4、调用tsrm_ls获取当前线程的资源管理器句柄，避免直接访问EG()或PG()等非线程安全宏。
二、在扩展内嵌入pthread库（Linux/macOS）
通过手动集成POSIX线程库，使扩展在ZTS或非ZTS环境下均可启动独立线程，但需自行管理线程生命周期与PHP变量跨线程传递。
1、在config.m4中检测pthread库存在，并添加-lpthread链接选项。
2、定义线程执行函数，使用zend_object_std_init初始化线程私有zval容器，避免共享zval结构体。
3、使用php_thread_t结构体封装线程ID、参数zval指针及回调函数指针，在pthread_create前完成参数序列化或引用计数保护。
4、在线程函数入口调用ts_resource_ex(0, NULL)初始化当前线程的TSRM资源，确保EG()等宏可安全使用。
三、采用进程隔离替代线程（跨平台兼容方案）
规避线程同步复杂性，改用pcntl_fork或proc_open启动子进程执行耗时任务，主进程通过管道或共享内存交换数据。
1、在扩展中封装pcntl_fork()调用，子进程中调用zend_register_extension重新加载扩展上下文。
2、使用shmop_open创建共享内存段，将任务参数序列化为msgpack格式写入，子进程读取后反序列化执行。
3、父进程调用pcntl_waitpid阻塞等待子进程退出，子进程退出前将结果写回共享内存并触发信号量。
4、扩展导出的PHP函数返回一个资源句柄，该句柄绑定到shmop标识符与信号量ID，供后续get_result函数轮询读取。
四、利用Swoole协程引擎注入C级协程支持
借助Swoole已实现的协程调度器，在扩展中注册协程唤醒回调，使C函数可挂起并交还控制权，实现伪多线程语义。
1、检测运行环境中是否存在swoole_version()函数，确认Swoole扩展已加载且版本≥4.8.0。
2、调用sw_coro_create创建协程上下文，在其中执行阻塞式C逻辑，如网络IO或加密计算。
3、在阻塞点插入sw_coro_yield让出CPU，待事件就绪后由Swoole调度器调用注册的onResume回调恢复执行。
4、使用sw_zval_dup对传入zval进行深拷贝，避免协程间zval引用计数冲突，所有zval操作必须在协程栈内完成，不可跨协程共享原始zval指针。
