命令行执行php出现PHP Fatal error Class Redis not found in

封面图 • 2025-11-10 • PHP

出现错误：

```
PHP Fatal error: Class 'Redis' not found in ...
```

这表示你的 PHP 环境中 **没有安装或启用 Redis 扩展**。

---

### ✅ 解决方法如下：

#### 1. 检查是否安装了 Redis 扩展

在命令行中运行：

```bash
php -m | grep redis
```

如果输出为空，说明 Redis 扩展未安装或未启用。

---

#### 2. 安装 Redis 扩展（根据系统不同）

##### 🐧 Linux（Ubuntu/Debian）：

```bash
sudo apt-get install php-redis
```

或者使用 `pecl` 安装：

```bash
sudo pecl install redis
```

然后在 `php.ini` 中添加：

```ini
extension=redis.so
```

最后重启 Web 服务器（如 Apache 或 Nginx）和 PHP-FPM（如果使用）：

```bash
sudo service apache2 restart
# 或
sudo systemctl restart php-fpm
```

---

##### 🍎 macOS（使用 Homebrew）：

```bash
brew install php@8.1  # 根据你安装的 PHP 版本调整
brew services start php
```

然后安装 Redis 扩展：

```bash
pecl install redis
```

再编辑 `php.ini` 添加：

```ini
extension=redis.so
```

---

##### Windows（XAMPP/Laragon 等）：

1. 下载对应的 `php_redis.dll` 文件（从 [PECL](https://pecl.php.net/package/redis) 下载与你的 PHP 版本匹配的 DLL 文件）。
2. 将 `php_redis.dll` 放入 `ext` 目录（例如：`C:\xampp\php\ext`）。
3. 在 `php.ini` 中添加：

```ini
   extension=php_redis.dll
   ```

4. 重启 Apache 或 PHP 服务。

---

#### 3. 验证是否安装成功

创建一个 `info.php` 文件：

```php
<?php
phpinfo();
?>
```

访问这个文件，搜索 "redis"，如果看到 Redis 的信息，说明扩展已成功加载。

---

### 🔁 如果你用的是 CLI（命令行执行 PHP）

确保你使用的 PHP 是你实际想要的版本，并且该版本的 `php.ini` 已配置好 Redis 扩展。

你可以查看当前使用的 PHP 路径：

```bash
which php
```

然后查看其 `php.ini` 的位置：

```bash
php --ini
```

---

### 🛠 常见问题排查

| 问题 | 解决方法 |
|------|----------|
| `php -m` 不显示 redis | 检查 `php.ini` 是否正确配置 |
| 无法找到 `redis.so` 或 `php_redis.dll` | 确认扩展已正确安装并放置到正确的目录 |
| 使用了多个 PHP 版本 | 确保你安装的扩展是对应 PHP 版本的 |

---

如果你告诉我你使用的操作系统、PHP 版本和环境（如 XAMPP、Laragon、原生 PHP 等），我可以提供更具体的步骤。