Mac环境下为PHP8.1.13安装Redis扩展

前言

Redis是一种流行的内存数据库，在PHP项目中经常用于缓存、会话存储等场景。本文将介绍如何在Mac系统的MAMP环境中为PHP8.1.13安装Redis扩展。

步骤一：下载源码

从GitHub下载phpredis最新稳定版源码：

1
2
# 下载6.2.0版本的源码包
curl -LO https://github.com/phpredis/phpredis/archive/refs/tags/6.2.0.tar.gz

步骤二：编译安装扩展

1
2
3
4
5
6
7
8
9
10
11
# 解压源码
tar -zxvf phpredis-6.2.0.tar.gz

# 进入源码目录
cd phpredis-6.2.0

# 配置编译环境（注意：在M1/M2芯片的Mac上需要使用arch -x86_64前缀）
arch -x86_64 ./configure --with-php-config=/Applications/MAMP/bin/php/php8.1.13/bin/php-config

# 编译并安装
arch -x86_64 make && make install

步骤三：配置PHP加载Redis扩展

首先查看PHP配置文件位置：

1
2
3
4
5
6
php --ini
# 输出信息
# Configuration File (php.ini) Path: /Applications/MAMP/bin/php/php8.1.13/conf
# Loaded Configuration File:         /Applications/MAMP/bin/php/php8.1.13/conf/php.ini
# Scan for additional .ini files in: (none)
# Additional .ini files parsed:      (none)

然后编辑php.ini文件，添加以下行：

1
extension=redis.so

步骤四：验证安装

重启MAMP后，执行以下命令验证Redis扩展是否成功安装：

1
php --ri redis

如果看到Redis扩展的详细信息，则表示安装成功。

常见问题

  1. 如果遇到”找不到redis.so”错误，请确认扩展编译后的实际位置，可能需要提供完整路径
  2. 对于M1/M2芯片的Mac，使用arch命令确保在正确的架构下编译扩展
  3. 安装完成后务必重启PHP-FPM或Web服务器

参考资料