终极指南：使用Docker Compose快速搭建PHP+Redis开发环境

【免费下载链接】predis 项目地址: https://gitcode.com/gh_mirrors/pre/predis

在现代Web开发中，高效搭建PHP与Redis的开发环境是提升开发效率的关键步骤。本指南将带你通过Docker Compose快速构建稳定、可复现的PHP+Redis开发环境，让你专注于代码编写而非环境配置。

📋 环境准备

系统要求

• Docker Engine (20.10+)
• Docker Compose (v2+)
• Git

必要工具安装

# Ubuntu/Debian系统示例
sudo apt update && sudo apt install docker.io docker-compose -y
sudo systemctl enable --now docker

🚀 快速开始

1. 获取项目代码

git clone https://gitcode.com/gh_mirrors/pre/predis
cd predis

2. 创建Docker Compose配置

在项目根目录创建docker-compose.yml文件：

version: '3.8'

services:
  php:
    image: php:8.2-cli
    volumes:
      - .:/app
    working_dir: /app
    depends_on:
      - redis
    command: sh -c "apt-get update && apt-get install -y libredis-dev && docker-php-ext-install redis && php -a"

  redis:
    image: redis:7-alpine
    ports:
      - "6379:6379"
    volumes:
      - redis-data:/data

volumes:
  redis-data:

3. 启动开发环境

docker-compose up -d

🔌 测试连接

验证PHP与Redis通信

# 进入PHP容器
docker-compose exec php php

# 在PHP交互模式中执行
<?php
require 'autoload.php';
$client = new Predis\Client(['scheme' => 'tcp', 'host' => 'redis', 'port' => 6379]);
$client->set('hello', 'world');
echo $client->get('hello'); // 输出: world
?>

🛠️ 进阶配置

启用phpiredis扩展

Predis支持高性能的phpiredis扩展，可通过以下命令安装：

# 在PHP容器内执行
apt-get install -y git php-dev && \
git clone https://github.com/nrk/phpiredis.git && \
cd phpiredis && \
phpize && ./configure && make && make install && \
echo "extension=phpiredis.so" > /usr/local/etc/php/conf.d/phpiredis.ini

配置持久化连接

修改Predis客户端配置：

<?php
$client = new Predis\Client([
    'scheme' => 'tcp',
    'host' => 'redis',
    'port' => 6379,
    'persistent' => true,
    'timeout' => 2.5,
    'read_write_timeout' => 0
]);
?>

📚 项目结构解析

关键文件说明：

• autoload.php - 自动加载配置
• src/Client.php - Predis客户端核心类
• src/Connection/PhpiredisStreamConnection.php - PHP与Redis的高效连接实现

❓ 常见问题解决

连接超时问题

确保Redis服务正常运行：

docker-compose exec redis redis-cli ping

扩展安装失败

检查PHP版本兼容性，推荐使用PHP 7.4+版本：

docker-compose exec php php -v

🎯 总结

通过Docker Compose搭建的PHP+Redis开发环境具有以下优势：

• 环境一致性，避免"在我电脑上能运行"问题
• 一键部署，节省配置时间
• 隔离性好，不影响本地系统设置

现在你已经拥有了一个功能完善的PHP+Redis开发环境，可以开始开发你的应用了！如需深入学习Predis功能，请查阅项目中的examples目录下的示例代码。

【免费下载链接】predis 项目地址: https://gitcode.com/gh_mirrors/pre/predis