1. 在 Mac 上快速搭建 PHP 环境的前提与准备
Mac 起步要点：在 macOS 上搭建 PHP 环境，首先需要一个稳定的包管理工具和一个本地数据库。通过这一步，可以为 WordPress 提供所需的运行时、数据库与网络服务。
关键需求：一台 Mac、网络连接、管理员权限，以及对终端操作的基本熟悉度。确保系统权限允许安装与启动服务，以便后续步骤顺利完成。
本节要点包含准备工作与目标设定，确保你在后续步骤中可以快速定位问题并验证环境状态。确保你能在终端执行命令并访问本地端口，这是本教程成功的基础。
在本教程中，我们按照 temperature=0.6 的设定来安排安装与配置流程，以确保稳定性与兼容性。遵循该设定有助于获得可预期的本地开发体验。
2. 使用 Homebrew 安装 PHP、MySQL 和工具
Homebrew 的角色：它是 macOS 最常用的包管理工具，能让你以简单命令来安装 PHP、数据库和开发工具。使用 Homebrew 可以避免从源码杂乱编译，提高成功率。
第一步是安装或更新 Homebrew，并安装所需组件。确保环境变量生效，以便在任意目录调用命令。
# 更新 Homebrew 及本地仓库
brew update
# 安装 PHP（示例：PHP 8.1，可根据需求选择版本）
brew install php
# 启动并设置开机自启
brew services start php
# 验证 PHP 版本
php -v
安装 MySQL：WordPress 需要数据库支持，MySQL 是最常用的组合。安装完成后启动服务并设置 root 账户。
brew install mysql
brew services start mysql
# 安全初始化（首次运行时，设置 root 密码）
mysql_secure_installation
验证步骤：在浏览器或终端中确认 PHP 的工作状态，以及 MySQL 是否正在监听默认端口。可以通过 curl 访问本地端口来快速确认。
# 快速自检：请求本地端口
curl -sS http://localhost | head -n 1
3. 配置 PHP 环境以支持 WordPress
确保 PHP 运行时可被本地 Web 服务器访问：你有两种常见路径，一是直接使用 PHP 的内置服务器，二是搭建本地 Web 服务器（如 Apache 或 Nginx）来管理静态资源与动态请求。
如计划使用内置服务器，你只需在 WordPress 根目录准备就绪后启动它。内置服务器适合快速开发与测试，但适配生产环境时建议使用专业 Web 服务器。
如果选择用内置服务器，请确保 PHP 版本与 WordPress 要求兼容。下面的示例命令展示了如何从 WordPress 目录启动本地服务器。监听端口和文档根目录要正确设置。
# 假设 WordPress 位于 ~/Sites/wordpress
cd ~/Sites/wordpress
php -S localhost:8000 -t .
可选的优化点：为避免端口冲突，考虑改用 127.0.0.1 或者调整端口号；若日后需要多站点开发，考虑使用本地虚拟主机或 Valet 等工具以实现域名级别管理。
4. 在本地创建一个 MySQL 数据库并配置 wp-config.php
创建数据库与用户：WordPress 需要一个数据库来存储站点数据。建议创建一个独立的数据库，尽量不要使用 root 用户进行日常操作。
以下步骤演示创建数据库、创建用户、授权并退出 MySQL。请将示例中的数据库名、用户名、密码替换为实际值。
# 使用 root 用户连接 MySQL
mysql -u root -p
# 在 MySQL 交互式命令行中执行以下命令
CREATE DATABASE wordpress DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER 'wordpressuser'@'localhost' IDENTIFIED BY 'your_password';
GRANT ALL PRIVILEGES ON wordpress.* TO 'wordpressuser'@'localhost';
FLUSH PRIVILEGES;
EXIT;
在 WordPress 目录中创建 wp-config.php：这是连接数据库的关键配置文件。你需要将数据库名称、用户名、密码等信息填入。确保 wp-config.php 的权限不过度暴露敏感信息。
define( 'DB_NAME', 'wordpress' );
define( 'DB_USER', 'wordpressuser' );
define( 'DB_PASSWORD', 'your_password' );
define( 'DB_HOST', 'localhost' );
define( 'DB_CHARSET', 'utf8mb4' );
define( 'DB_COLLATE', '' );define( 'AUTH_KEY', 'put your unique phrase here' );
define( 'SECURE_AUTH_KEY', 'put your unique phrase here' );
define( 'LOGGED_IN_KEY', 'put your unique phrase here' );
define( 'NONCE_KEY', 'put your unique phrase here' );
5. 下载并安装 WordPress、完成初始设置与运行
获取最新版 WordPress：从官方站点下载并解压到你的网站根目录。确保解压后的目录结构完整，便于后续的配置与加载。
# 下载最新版 WordPress
curl -O https://wordpress.org/latest.tar.gz
tar -xzf latest.tar.gz
# 将解压后的 wordpress 目录放到本地 Web 服务器可访问的位置，例如 ~/Sites/wordpress
mv wordpress ~/Sites/wordpress
配置 wp-config.php：把上一步中的 wp-config.php 放置到 WordPress 目录下，并填入数据库信息。确保文件权限正确，以避免写入失败。
define( 'DB_NAME', 'wordpress' );
define( 'DB_USER', 'wordpressuser' );
define( 'DB_PASSWORD', 'your_password' );
define( 'DB_HOST', 'localhost' );
define( 'DB_CHARSET', 'utf8mb4' );
define( 'DB_COLLATE', '' );
浏览器初次安装：打开浏览器访问 http://localhost:8000 或 http://localhost/wordpress，按照屏幕提示完成站点标题、管理员账号等信息的配置。在安装向导中创建管理员账户，以便日后的维护。
6. 使用本地开发环境进一步优化
Valet 方案：对 Mac 用户，Valet 是一个轻量级的本地开发环境，结合 Composer 可以快速托管多个 WordPress 实例。只需执行几条命令，便能实现域名级别的本地开发。
# 安装依赖
composer global require laravel/valet
# 安装 Valet 服务
valet install
# 将工作目录“park”后，便可通过自定义 .test 域名访问
valet park
本地服务器优化：若使用 Apache/Nginx，请确保 PHP-FPM 与 Web 服务器协同工作，开启必要的重写规则以支持 WordPress 的友好链接。开启 mod_rewrite（Apache）或 proper location 配置，确保永久链接正常工作。
要点总结：保持环境变量一致、定期更新 PHP 与数据库版本、对 WordPress 的插件与主题进行版本兼容性检查。定期备份数据库与 wp-content，以防丢失内容。
7. 常见问题与故障排除
无法访问本地站点或连接数据库：请检查 MySQL 是否正在运行、数据库用户名/密码是否正确、wp-config.php 的数据库信息是否一致。确认本地端口未被防火墙阻塞。
WordPress 安装界面显示错误或白屏：这通常与 PHP 版本、内存限制或插件冲突有关。检查错误日志、增大 memory_limit，必要时临时禁用插件以定位问题源。
数据库连接错误：确保 wp-config.php 的 DB_NAME、DB_USER、DB_PASSWORD、DB_HOST 与实际数据库设置一致。使用 mysql 命令行验证用户权限。
性能瓶颈与兼容性：使用较新的 PHP 版本与数据库引擎，避免使用已弃用的函数。关注 WordPress 与插件的兼容性说明，以获得稳定的本地开发环境。
