本文聚焦在在Mac上快速搭建开发环境的详细教程,覆盖从工具安装到扩展配置与简单验证的完整流程,尤其关注 在Mac上如何快速搭建PHP+Redis开发环境?详细教程 的核心要点。
1. 系统准备与目标
目标与版本定位
在本节中 明确目标,包括可重复性、可维护性和本地调试能力,确保后续步骤顺利进行。我们以 macOS 13/14 为常见场景来说明安装与配置要点。
此外,本文强调通过 Homebrew 作为包管理入口,以保障 PHP、Redis 等组件的版本可控与易于升级。

2. 安装工具与环境
安装 Homebrew
Homebrew 是 macOS 的核心包管理工具,提供统一的安装与更新入口。通过官方脚本安装后,brew 命令会成为系统级别工具,便于后续的组件安装与版本管理。
对于 Apple Silicon 用户,/opt/homebrew 是默认路径,请将 PATH 更新为 /opt/homebrew/bin,以确保命令可用性与一致性。
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
安装完成后,建议执行 brew doctor 与 brew update 来验证环境健康并同步最新公式。
brew doctor
brew update
3. 安装 PHP 与 PHP-FPM
安装 PHP
通过 Homebrew 安装 PHP 可以获得最新的可用版本,并且可以选择独立的 CLI 与 FPM 服务。执行 brew install php 将安装默认版本的 PHP。
安装完成后,验证 php -v 的输出以确认版本一致性,并确保 PHP 的 CLI 可用。若需要特定版本,可以指定版本号,例如 php@8.1。
brew install php
php -v
要启动 PHP-FPM 服务,可使用 brew services start php。如果你计划使用 Nginx 或 Apache 做前端服务器,FPM 将承担后端 PHP 请求处理的职责。
brew services start php
4. 安装 Redis
安装 Redis
Redis 作为内存数据存储与缓存组件,使用 brew install redis 即可安装。安装完成后,Redis 配置与启动选项会提示你如何使用。brew services 可以帮助你实现开机自启或手动启动。
默认的 Redis 配置文件通常位于 /usr/local/etc/redis.conf,在 Apple Silicon 上也可能是 /opt/homebrew/etc/redis.conf,请根据实际路径确认。
brew install redis
安装完成后,使用以下命令启动 Redis 服务并进行简单连通性测试:
brew services start redis
redis-cli ping
5. 集成 PHP 与 Redis
安装 PHP Redis 扩展
Redis 的 PHP 扩展提供了 PHP 与 Redis 之间的原生通信能力,通常通过 pecl 安装,然后在 PHP 配置中加载扩展。
执行下列步骤来完成扩展安装与加载,确保系统 PATH 上的 PHP 版本与 cli 的版本匹配,以避免扩展版本不一致的问题。
pecl install redis
extension=redis.so
如果 pecl 安装遇到编译问题,请先确保已安装 Xcode Command Line Tools,以提供编译所需的 gcc 等工具。
xcode-select --install
另外,通过 php --ini 可以查看当前加载的 php.ini 路径,之后在该文件中加入上述扩展配置,以确保扩展在 CLI 与 FPM 环境中均可用。
php --ini
6. 验证与简单测试
编写并运行测试脚本
创建一个简单的 PHP 脚本,用于连接本地 Redis 服务并执行基本的 SET/GET 操作。确保 Redis 地址为 127.0.0.1,端口为 6379。
该测试脚本可以放在任意目录,例如 /Users/你的用户名/Scripts/redis_test.php,然后通过 php redis_test.php 进行执行,观察输出结果。
connect('127.0.0.1', 6379);
$redis->set('hello','world');
echo $redis->get('hello');
?>
若输出 world,则表示本地 PHP 与 Redis 的连接已建立且数据写入成功。
通过以上步骤,您已经在 Mac 上完成了 PHP 与 Redis 的本地开发环境搭建与集成测试,包含工具安装、组件配置、扩展加载以及基本验证,形成一个可用于日常开发的工作流。


