PHP7添加redis扩展

封面图 • 2025-05-02 • PHP

在 PHP 7 中添加 Redis 扩展，通常需要安装 `php-redis` 扩展。以下是详细的步骤：

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

首先，检查你的 PHP 环境中是否已经安装了 Redis 扩展。可以通过以下命令查看：

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

如果输出了 `redis`，说明已经安装了 Redis 扩展。如果没有输出，则需要手动安装。

### 2. 安装 Redis 扩展

#### 方法一：通过 PECL 安装

PECL 是 PHP 的扩展包管理工具，可以方便地安装各种 PHP 扩展。

1. **安装 PECL**（如果尚未安装）

在大多数 Linux 发行版上，PECL 已经包含在 PHP 包中。如果没有安装，可以通过包管理器安装：

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

2. **安装 Redis 扩展**

使用以下命令安装 `php-redis` 扩展：

```bash
   pecl install redis
   ```

3. **启用 Redis 扩展**

安装完成后，编辑 PHP 配置文件 `php.ini`，添加以下内容以启用 Redis 扩展：

```bash
   echo "extension=redis.so" >> /etc/php/7.x/cli/php.ini
   ```

如果你使用的是 PHP-FPM 或 Apache，请确保将 `redis.so` 添加到对应的 `php.ini` 文件中。例如：

- 对于 FPM：
     ```bash
     echo "extension=redis.so" >> /etc/php/7.x/fpm/php.ini
     ```
   - 对于 Apache：
     ```bash
     echo "extension=redis.so" >> /etc/php/7.x/apache2/php.ini
     ```

4. **重启 Web 服务器或 PHP-FPM**

修改完配置后，重启 Web 服务器或 PHP-FPM 服务以使更改生效：

```bash
   sudo systemctl restart apache2  # 如果使用 Apache
   sudo systemctl restart php7.x-fpm  # 如果使用 PHP-FPM
   ```

5. **验证安装**

再次运行以下命令，确认 Redis 扩展已成功加载：

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

如果看到 `redis`，说明安装成功。

---

#### 方法二：从源码编译安装

如果你无法使用 PECL 安装 Redis 扩展，可以选择从源码编译安装。

1. **下载 Redis 扩展源码**

你可以从 [GitHub](https://github.com/phpredis/phpredis) 下载 Redis 扩展的源码。

```bash
   git clone https://github.com/phpredis/phpredis.git
   cd phpredis
   ```

2. **编译和安装**

使用以下命令编译并安装 Redis 扩展：

```bash
   phpize
   ./configure
   make
   sudo make install
   ```

3. **启用 Redis 扩展**

编译完成后，编辑 `php.ini` 文件，添加以下内容：

```bash
   extension=/path/to/redis.so
   ```

其中 `/path/to/redis.so` 是编译生成的 `.so` 文件的路径。

4. **重启 Web 服务器或 PHP-FPM**

同样需要重启 Web 服务器或 PHP-FPM 服务以应用更改。

---

### 3. 测试 Redis 扩展

编写一个简单的 PHP 脚本测试 Redis 扩展是否正常工作：

```php
<?php
$redis = new Redis();
$redis->connect('127.0.0.1', 6379);

if ($redis->ping() === '+PONG') {
    echo "Redis 连接成功！";
} else {
    echo "Redis 连接失败！";
}
?>
```

将上述代码保存为 `test_redis.php`，然后在浏览器或命令行中运行：

```bash
php test_redis.php
```

如果输出 `Redis 连接成功！`，说明 Redis 扩展已正确安装并可以正常使用。

---

### 4. 常见问题及解决方法

#### 问题 1：找不到 `phpize`

如果你在安装过程中遇到 `phpize` 未找到的问题，可以尝试安装 `php-dev` 包：

```bash
sudo apt-get install php7.x-dev
```

#### 问题 2：扩展未加载

如果 Redis 扩展没有加载，检查以下几点：
- 确保 `extension=redis.so` 正确写入了正确的 `php.ini` 文件。
- 确保 `php.ini` 文件的路径正确，并且没有拼写错误。
- 确保 Web 服务器或 PHP-FPM 已重新启动。

#### 问题 3：Redis 服务未启动

确保 Redis 服务正在运行：

```bash
sudo systemctl status redis
```

如果 Redis 服务未运行，可以启动它：

```bash
sudo systemctl start redis
```

---

通过以上步骤，你应该能够成功在 PHP 7 中安装并使用 Redis 扩展。如果有其他问题，请随时提问！