PHP默认采用单线程执行模型，常规的业务逻辑不需要考虑多线程问题，但如果需要通过PHP扩展实现并行计算、异步任务处理等能力，就需要在扩展层面适配多线程场景，核心是要解决线程安全和多线程协作的问题。
PHP扩展多线程的核心前提：理解TSRM机制
PHP为了支持多线程环境下的运行，设计了TSRM（Thread Safe Resource Manager）线程安全资源管理器，所有需要在多线程环境下共享或隔离的资源，都需要通过TSRM来分配和管理。如果扩展要支持多线程，首先必须开启TSRM适配，在扩展的config.m4配置中添加线程安全相关的编译选项，确保扩展在编译时支持TSRM模式。
TSRM的核心作用是为每个线程分配独立的资源副本，避免多个线程同时操作同一块内存导致数据错乱。在扩展中访问全局变量、持久化资源时，不能直接使用普通的全局变量定义，必须通过TSRM提供的宏来声明和获取资源。
PHP扩展多线程的实现思路
1. 线程安全资源的声明与使用
扩展中如果需要定义线程内共享或者线程隔离的全局资源，要使用TSRM的相关宏。比如声明一个线程安全的全局计数器，代码示例如下：
#include "tsrm.h"
// 声明线程安全的全局资源ID
int my_counter_id;
// 每个线程对应的计数器结构体
typedef struct {
zend_long count;
} my_counter_t;
// 扩展启动时初始化资源
PHP_MINIT_FUNCTION(myext)
{
// 分配TSRM资源ID，指定资源析构函数
my_counter_id = ts_allocate_id(sizeof(my_counter_t), (ts_allocate_ctor) my_counter_ctor, (ts_allocate_dtor) my_counter_dtor);
return SUCCESS;
}
// 资源构造函数，每个线程首次访问时调用
static void my_counter_ctor(my_counter_t *counter)
{
counter->count = 0;
}
// 资源析构函数，线程销毁时调用
static void my_counter_dtor(my_counter_t *counter)
{
// 无需额外操作，基础类型不需要释放
}
// 扩展中获取当前线程的计数器
static my_counter_t *get_my_counter()
{
// 通过TSRM获取当前线程对应的资源指针
return (my_counter_t *) ts_resource(my_counter_id);
}
2. 多线程任务的创建与管理
PHP扩展本身不直接提供线程创建接口，需要依赖操作系统的线程库（比如POSIX的pthread库）来创建线程。需要注意的是，新创建的线程不能直接调用Zend引擎的大部分API，因为Zend引擎的很多接口不是线程安全的，除非你在调用前做好线程隔离和状态初始化。
如果要在扩展中创建线程执行任务，建议将线程任务设计为纯计算逻辑，或者只操作通过TSRM管理的线程安全资源，避免直接操作PHP的变量、函数调用等Zend相关结构。基础的多线程创建示例：
#include <pthread.h>
// 线程执行的函数
static void *thread_task(void *arg)
{
// 获取当前线程的计数器资源
my_counter_t *counter = get_my_counter();
counter->count++;
// 线程任务逻辑，避免调用Zend API
return NULL;
}
// 扩展中提供的PHP函数，用于触发多线程任务
PHP_FUNCTION(myext_start_threads)
{
pthread_t tids[4];
int i;
// 创建4个线程
for (i = 0; i < 4; i++) {
pthread_create(&tids[i], NULL, thread_task, NULL);
}
// 等待所有线程执行完成
for (i = 0; i < 4; i++) {
pthread_join(tids[i], NULL);
}
// 获取主线程的计数器值返回
my_counter_t *counter = get_my_counter();
RETURN_LONG(counter->count);
}
3. 共享数据的同步处理
如果多个线程需要操作同一份共享数据，必须使用线程同步机制避免竞态条件，常用的同步方式有互斥锁、信号量等。比如使用互斥锁保护共享计数器的修改：
#include <pthread.h>
// 声明互斥锁，同样通过TSRM管理保证线程安全
pthread_mutex_t *mutex_id;
PHP_MINIT_FUNCTION(myext)
{
// 初始化互斥锁资源ID
mutex_id = ts_allocate_id(sizeof(pthread_mutex_t), (ts_allocate_ctor) mutex_ctor, (ts_allocate_dtor) mutex_dtor);
return SUCCESS;
}
static void mutex_ctor(pthread_mutex_t *mutex)
{
pthread_mutex_init(mutex, NULL);
}
static void mutex_dtor(pthread_mutex_t *mutex)
{
pthread_mutex_destroy(mutex);
}
// 带锁保护的计数器修改
static void safe_increment_counter()
{
pthread_mutex_t *mutex = (pthread_mutex_t *) ts_resource(mutex_id);
my_counter_t *counter = get_my_counter();
pthread_mutex_lock(mutex);
counter->count++;
pthread_mutex_unlock(mutex);
}
注意事项与限制
首先，PHP的CLI模式对多线程的支持相对较好，但FPM模式下默认是多进程模型，扩展的多线程逻辑在FPM下可能会和进程管理逻辑冲突，需要谨慎测试。其次，Zend引擎的大部分API（比如创建PHP变量、调用PHP函数、访问PHP超全局变量）都不是线程安全的，新创建的线程中尽量不要调用这些接口，否则很容易导致进程崩溃。最后，扩展的多线程逻辑会增加调试难度，建议先通过单线程逻辑验证功能，再逐步添加多线程适配。
总结
PHP扩展支持多线程的核心思路是结合TSRM管理线程安全资源，依赖操作系统线程库创建线程，同时使用同步机制处理共享数据冲突，并且尽量避免在新线程中调用非线程安全的Zend API。实际开发中需要根据具体的业务场景评估是否有必要在扩展层实现多线程，很多时候通过PHP的多进程或者Swoole等第三方扩展的协程能力，也能达到类似的性能提升效果，且开发成本更低。