php安装redis扩展 ts和nts的区别 (redis中碰到)

封面图 • 2025-11-10 • redis

在 PHP 中安装 Redis 扩展时，你可能会看到两种版本的扩展：`ts` 和 `nts`。这两个缩写分别代表 **Thread Safe**（线程安全）和 **Non-Thread Safe**（非线程安全）。它们的区别主要在于 PHP 的运行方式。

---

## 🔹 一、什么是 `ts` 和 `nts`？

| 类型 | 缩写 | 全称 | 是否支持多线程 |
|------|------|------|----------------|
| 1    | `ts` | Thread Safe | ✅ 支持（适用于多线程环境） |
| 2    | `nts` | Non-Thread Safe | ❌ 不支持（适用于单线程环境） |

---

## 🔹 二、PHP 是如何决定使用哪个版本的？

PHP 在编译时会根据是否启用线程支持来生成不同的版本：

- **`php -i` 命令输出中可以看到：**
  ```bash
  Thread Safety => Enabled   # ts 版本
  Thread Safety => Disabled  # nts 版本
  ```

---

## 🔹 三、Redis 扩展为什么要区分 `ts` 和 `nts`？

Redis 扩展本身是用 C 编写的，它依赖于 PHP 的运行环境是否是线程安全的。如果你使用的 PHP 是 **线程安全版本（TS）**，那么必须使用 **ts 版本的 Redis 扩展**；如果 PHP 是 **非线程安全版本（NTS）**，就必须使用 **nts 版本的 Redis 扩展**。

否则会出现如下错误：

```text
PHP Warning:  PHP Startup: redis: Unable to initialize module
Module 'redis' already loaded
```

或者直接无法加载扩展。

---

## 🔹 四、如何判断当前 PHP 使用的是 ts 还是 nts？

运行以下命令查看：

```bash
php -i | grep 'Thread Safety'
```

输出示例：

- 如果是 `Thread Safety => Enabled` → 使用的是 **ts** 版本
- 如果是 `Thread Safety => Disabled` → 使用的是 **nts** 版本

---

## 🔹 五、如何选择正确的 Redis 扩展版本？

| PHP 线程安全状态 | 应该安装的 Redis 扩展版本 |
|------------------|---------------------------|
| Thread Safe (TS) | `redis.so`（ts 版本）     |
| Non-Thread Safe (NTS) | `redis.so`（nts 版本） |

---

## 🔹 六、如何下载对应的 Redis 扩展？

你可以通过以下方式获取：

### 1. 使用 `pecl` 安装（自动适配）

```bash
pecl install redis
```

这个命令会根据你的 PHP 环境自动选择正确的版本。

---

### 2. 手动下载 `.so` 文件

你可以从 [PECL 官网](https://pecl.php.net/package/redis) 下载对应版本的源码或预编译的 `.so` 文件。

注意：预编译文件通常需要与你的 PHP 版本、架构（32/64位）、线程安全状态完全匹配。

---

## 🔹 七、常见问题解决

### 🚨 问题：加载 Redis 扩展时报错

```text
PHP Warning:  PHP Startup: redis: Unable to initialize module
Module 'redis' already loaded
```

#### 解决方法：

- 检查 `php.ini` 中是否重复加载了 `redis` 扩展。
- 确保你安装的 Redis 扩展版本与 PHP 的线程安全状态一致（ts vs nts）。

---

## 🔹 八、总结

| 项目 | 内容 |
|------|------|
| ts | Thread Safe，适用于多线程环境（如 Apache + mod_php） |
| nts | Non-Thread Safe，适用于单线程环境（如 FPM 或 CLI） |
| Redis 扩展 | 必须与 PHP 的线程安全状态一致（ts/nts） |
| 安装建议 | 使用 `pecl install redis` 自动适配 |

---

如果你能提供你当前的 PHP 环境信息（比如 PHP 版本、线程安全状态），我可以帮你更准确地推荐 Redis 扩展版本。