1. Mac 上快速搭建 PHP 环境并运行 WordPress 的详细教程：概览
1.1 为什么在 Mac 上搭建本地开发环境对 WordPress 有帮助
在 Mac 上快速搭建 PHP 环境并运行 WordPress，可以实现本地开发、快速测试插件与主题、以及离线演示。通过本地环境，可以避免线上服务器的风险与延迟，提升迭代效率，并且便于调试 PHP、数据库和 URL 重写等关键能力。
本教程聚焦的是在 Mac OS 系统上利用常见工具链快速搭建，包含 PHP、MySQL、以及 WordPress 的全流程。核心要点是先搭建稳定的本地运行环境，再逐步部署 WordPress 站点，确保能够无缝体验正式站点的开发工作流。
1.2 快速路径与两个常见选择
为实现“快速搭建”，本文给出两条路径：一是使用 Homebrew 直接在终端安装 PHP、MySQL、以及相关工具，灵活性高且便于后续扩展；二是使用图形化工具如 MAMP 或 Local，实现“一键启动”的本地环境，适合需要快速落地的场景。两者都能让你在 Mac 上实现 WordPress 的本地运行。
2. 准备工作：安装 Homebrew 与环境依赖
2.1 安装 Homebrew（Mac 的包管理器）
在本地快速搭建开发栈前，Homebrew 是最受欢迎的工具之一，它能帮助你用简单命令安装 PHP、MySQL、以及其他依赖。确保网络稳定，并遵循官方指引完成安装。
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"安装完成后，记得执行 brew doctor 和 brew update，以保障环境健康，并将 Homebrew 的可执行文件路径加入 PATH。
2.2 验证环境并安装基础工具
完成 Homebrew 安装后，应通过 brew —version 验证版本，并确保可以正常安装后续依赖。此处的关键点在于建立一个稳定的开发环境，确保 PHP 与数据库组件的兼容性。
brew update
brew upgrade
此外，可以在此阶段安装一些有用的开发辅助工具，例如 WP-CLI、Composer 等，以便后续管理 WordPress 更高效。
3. 安装 PHP 与数据库等核心组件
3.1 安装并配置 PHP
使用 Homebrew 安装最新稳定版的 PHP，确保 CLI 与 FPM 模块都可用，以便本地站点的多场景运行。安装完成后，确认 php -v，并将 PHP 路径加入系统变量，确保全局可用。
brew install php
php -v
echo 'export PATH="/usr/local/opt/php/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
接下来，可以按需启用或禁用 PHP 的扩展，例如 pdo_mysql、gd、curl 等，确保 WordPress 能与数据库及图片处理等功能顺畅协作。
3.2 安装并启动 MySQL
本地 WordPress 需要一个数据库来存放内容与设置。通过 Homebrew 安装 MySQL，并将服务设为开机自启（或你需要时手动启动），以实现快速开发循环。
brew install mysql
brew services start mysql
初次连接时，可以以 root 用户进入数据库，创建一个专用于 WordPress 的数据库和用户，以提升安全性与可维护性。
3.3 安装 Composer 与 WP-CLI（可选但推荐）
Composer 是 PHP 的依赖管理工具，便于管理 WordPress 插件和相关依赖。并且，WP-CLI 能让你通过命令行直接管理 WordPress，极大提升开发效率。
brew install composer
composer --version
curl -LO https://raw.githubusercontent.com/wp-cli/builds/gh-pages/phar/wp-cli.phar
chmod +x wp-cli.phar
sudo mv wp-cli.phar /usr/local/bin/wp
安装完成后，可以通过 wp core download、wp config、以及其他 WP-CLI 命令来简化 WordPress 的搭建与维护过程。
4. 本地 WordPress 站点的搭建流程
4.1 下载并准备 WordPress 代码
前往 WordPress.org 获取最新版的 WordPress 包，并解压到你的工作目录。确保该目录具备合适的读写权限，便于后续插件和主题的安装与更新。将 WordPress 的根目录设为未来站点的根路径，这是后续步骤的基础。
cd ~/Sites
wget https://wordpress.org/latest.zip
unzip latest.zip -d wordpress-site
工作目录 应该是你日常开发的核心位置，便于统一管理诸如数据库、站点文件和备份。
4.2 创建数据库与用户
在 MySQL 中创建一个专门用于 WordPress 的数据库，以及一个具备权限的数据库用户。下面是常见的创建流程示例。
CREATE DATABASE wordpress;
CREATE USER 'wp_user'@'localhost' IDENTIFIED BY 'secure_password';
GRANT ALL PRIVILEGES ON wordpress.* TO 'wp_user'@'localhost';
FLUSH PRIVILEGES;
确保你为数据库用户设置了一个安全密码，并将该信息保存在 wp-config.php 中使用。
4.3 配置 wp-config.php
将 wp-config-sample.php 复制为 wp-config.php，并填写数据库名称、用户名、密码、主机等信息，以便 WordPress 能与数据库建立连接。
完成后，WordPress 的安装向导将自动引导你完成站点信息设置和管理员账户创建。这里的 DB_NAME、DB_USER、DB_PASSWORD、DB_HOST 等字段是核心配置。
4.4 站点目录结构与权限管理
确保 WordPress 目录对运行 Web 服务器的用户具有写权限，常见做法是将目录所有权设置为当前用户组，或使用 chmod 与 chown 调整权限，以保证主题、插件和媒体文件的可写性。
sudo chown -R $(whoami):staff wordpress-site
chmod -R 755 wordpress-site
5. 启动本地服务器：内置 PHP 服务器 vs Nginx/Apache
5.1 使用 PHP 内置服务器快速验证
为了快速验证 WordPress 是否能够跑起来，可以使用 PHP 自带的开发服务器进行初步测试。该方式简单直观，适合初期调试和快速演示。
cd ~/Sites/wordpress-site
php -S localhost:8000 -t .
访问 http://localhost:8000 即可看到 WordPress 安装向导。注意：内置服务器对高并发或生产环境不适用，但非常合适本地测试与学习。
5.2 使用 Nginx/Apache 作为正式的本地运行环境
若需要更接近正式部署的环境，可以在 Mac 上使用 Nginx 或 Apache。通过 Homebrew 安装并配置，确保 PHP-FPM 与所选 Web 服务器正确集成。
brew install nginx
brew services start nginx
在 Nginx 配置中，将 root 指向 WordPress 的根目录，配置 PHP 处理请求的 fastcgi 参数；对于 Apache，则开启 PHP 模块或 FPM，并将站点目录设置为 DocumentRoot。
# Nginx 常见配置片段
server {listen 8080;server_name localhost;root /Users/yourname/Sites/wordpress-site;index index.php index.html;location / {try_files $uri $uri/ /index.php?$args;}location ~ \.php$ {fastcgi_pass 127.0.0.1:9000;include fastcgi_params;}
}
6. 运营与维护：备份、更新与调试
6.1 使用 WP-CLI 进行快速管理
在本地开发中，WP-CLI 是强大且高效的工具。你可以使用它来安装、更新 WordPress 核心、插件与主题，以及执行数据库导入导出等常规任务。
wp core download --path=/Users/yourname/Sites/wordpress-site
wp config create --dbname=wordpress --dbuser=wp_user --dbpass=secure_password --path=/Users/yourname/Sites/wordpress-site
wp core install --url="http://localhost:8000" --title="Local WP" --admin_user="admin" --admin_password="admin_pass" --admin_email="you@example.com"
通过 WP-CLI，你还能快速管理插件、主题、数据库备份等任务，提高日常维护效率。
6.2 数据备份与调试实践
定期对数据库和 wp-content 目录进行备份，是保障开发进度的关键实践。结合 mysqldump 和简单的本地快照策略，可以快速恢复到某个开发节点。
mysqldump -u wp_user -p wordpress > wordpress.sql
tar -czf wordpress-content-backup.tar.gz wordpress-site/wp-content
当遇到站点错误时，建议先检查 error_log、浏览器控制台以及 PHP 的错误日志，以定位 PHP 脚本、数据库连接、以及重写规则等问题。
