在 ServBay 环境中安装和配置 WordPress
概述
WordPress 是一个功能强大且广受欢迎的开源内容管理系统(CMS),基于 PHP 和 MySQL 构建。它是全球领先的网站和博客创建平台,拥有庞大的社区支持、丰富的插件和主题生态系统,适用于构建从个人博客到复杂的电子商务网站等各种类型的项目。
ServBay 是一个专为 macOS 设计的本地 Web 开发环境,提供了一站式的解决方案,集成了多种版本的 PHP、主流数据库(如 MySQL, PostgreSQL, MongoDB)、Web 服务器(Caddy, Nginx)以及 Redis 等工具。利用 ServBay,开发者可以轻松地在本地搭建隔离、灵活且高性能的开发环境,这使得在本地安装和测试 WordPress 变得极其便捷。
本文将详细指导你如何在 ServBay 环境中下载、安装和配置 WordPress,助你快速启动本地的 WordPress 开发工作。
前提条件
在开始之前,请确保满足以下条件:
- 你的 macOS 系统上已成功安装并运行 ServBay。
- ServBay 中已安装并启动了至少一个 PHP 版本(WordPress 需要 PHP 7.4 或更高版本)以及 MySQL 或 MariaDB 数据库软件包。
- 对基本的 Web 服务器、数据库概念以及终端命令行操作有初步了解。
安装 WordPress 的步骤
以下是在 ServBay 环境中安装和配置 WordPress 的详细步骤:
步骤 1:下载并解压 WordPress
首先,我们需要获取最新版本的 WordPress 程序文件,并将其放置到 ServBay 配置的网站根目录 (/Applications/ServBay/www
) 下的子目录中。
切换到 ServBay 网站根目录
打开终端应用,执行以下命令切换到 ServBay 的默认网站根目录:
bashcd /Applications/ServBay/www
1下载最新版 WordPress
使用
curl
命令下载最新版本的 WordPress 压缩包:bashcurl https://wordpress.org/latest.tar.gz -o wordpress.tar.gz
1创建项目目录并解压 WordPress
创建一个新的目录用于存放你的 WordPress 网站文件(例如
servbay-wordpress-app
),并将下载的压缩包内容解压到该目录中。--strip-components 1
参数用于移除压缩包中的顶层wordpress
目录,直接将内容解压到指定目录内。bashmkdir servbay-wordpress-app tar zxf wordpress.tar.gz --strip-components 1 -C servbay-wordpress-app
1
2现在,你的 WordPress 文件应该位于
/Applications/ServBay/www/servbay-wordpress-app
目录下。
步骤 2:创建数据库和数据库用户
WordPress 需要一个数据库来存储其所有内容和设置(如文章、页面、评论、插件配置等)。我们将在 ServBay 的数据库服务中创建一个新的数据库和一个专门用于访问该数据库的用户。
访问 ServBay 内置的数据库管理工具
ServBay 默认提供了 phpMyAdmin 或 Adminer(取决于你的 ServBay 配置)作为数据库管理工具。打开浏览器,访问 ServBay 的默认首页
https://servbay.host/
,然后点击页面上的「phpMyAdmin」或「Adminer」链接,进入数据库管理界面。登录数据库管理工具
使用 ServBay 默认的数据库
root
用户和你在 ServBay 安装过程中设置的 root 密码登录。创建新的数据库
在数据库管理工具界面中,执行以下操作创建一个新的数据库:
- 通常在左侧导航栏或主页面找到「新建」(New)或「创建数据库」(Create database)选项。
- 在「数据库名」(Database name)字段中输入一个名称,例如
servbay_wordpress_db
。 - 选择字符集为
utf8mb4
,排序规则(Collation)为utf8mb4_unicode_ci
。这是 WordPress 推荐的设置,以支持更广泛的字符集,包括 Emoji。 - 点击「创建」(Create)按钮。
创建数据库用户并赋予权限
出于安全考虑,建议为 WordPress 创建一个拥有特定数据库权限的专用数据库用户,而不是使用
root
用户。- 在数据库管理工具中,导航到「用户账户」(User accounts)页面。
- 点击「添加用户账户」(Add user account)。
- 填写用户详细信息:
- 用户名(User name):输入
wordpress_user
。 - 主机名(Host name):选择或输入
localhost
。 - 密码(Password):输入一个强密码。切勿使用弱密码如
password123
。建议使用密码生成器生成一个复杂的密码。请记下这个密码,稍后会用到。例如,使用占位符your_strong_password_here
。 - 重新输入(Re-type):再次输入密码。
- 用户名(User name):输入
- 重要: 在「全局权限」(Global privileges)部分,不要勾选「全选」(Check All)或「授予所有权限」(Grant all privileges)。我们只为该用户授予特定数据库的权限。
- 点击页面底部的「执行」(Go)或「添加用户」(Add user)按钮。
创建用户后,需要为其赋予访问
servbay_wordpress_db
数据库的权限:- 回到「用户账户」(User accounts)页面。
- 找到刚刚创建的
wordpress_user@localhost
用户,点击其对应的「编辑权限」(Edit privileges)。 - 向下滚动到「数据库特定权限」(Database-specific privileges)部分。
- 在「添加到以下数据库的权限」(Add privileges to the following database)下拉菜单中,选择之前创建的
servbay_wordpress_db
。 - 点击「执行」(Go)。
- 在新页面中,勾选「全选」(Check All)来授予该用户在该数据库上的所有权限(数据、结构、管理权限)。
- 点击页面底部的「执行」(Go)按钮保存更改。
步骤 3:在 ServBay 中配置网站
接下来,我们需要告诉 ServBay 如何处理对你的 WordPress 网站域名的访问请求,将请求指向正确的网站文件目录。
打开 ServBay 应用
启动 ServBay 应用。
添加新的网站配置
在 ServBay 应用界面中,点击侧边栏的「网站」(Websites)标签页。然后点击左下角的「+」按钮,选择「添加网站」(Add Website)。
填写网站配置信息
在弹出的窗口中,填写以下信息:
- 名字(Name):输入一个易于识别的网站名称,例如
ServBay WordPress Dev
。 - 域名(Domain):输入你希望在本地访问该网站的域名,例如
servbay-wordpress.demo
。ServBay 将会自动帮你创建这个域名并允许本地访问。 - 网站类型(Site Type):选择
PHP
。 - PHP 版本(PHP Version):从下拉菜单中选择一个适合 WordPress 的 PHP 版本(建议使用 ServBay 中提供的最新稳定版本,如 PHP 8.x)。ServBay 支持同时运行多个 PHP 版本。
- 网站根目录(Site Root):点击文件夹图标,选择或手动输入 WordPress 文件所在的目录:
/Applications/ServBay/www/servbay-wordpress-app
。
- 名字(Name):输入一个易于识别的网站名称,例如
保存配置
填写完毕后,点击「保存」(Save)按钮。ServBay 会自动应用新的配置,并可能提示重启相关的 Web 服务器软件包。确认重启。
得益于 ServBay 的自动化配置,访问
servbay-wordpress.demo
时,ServBay 会自动为你生成并配置本地信任的 SSL 证书,实现 HTTPS 安全连接。
步骤 4:完成 WordPress 安装向导
现在,数据库已准备好,网站配置也已完成。最后一步是通过 Web 浏览器访问你的本地域名,运行 WordPress 的安装向导。
访问你的本地 WordPress 网站
打开你的 Web 浏览器,在地址栏输入你在上一步中配置的域名,例如
https://servbay-wordpress.demo
。启动 WordPress 安装向导
如果一切配置正确,你应该会看到 WordPress 的欢迎页面,提示你选择语言。选择后,点击「继续」。
填写数据库连接信息
在随后的页面中,WordPress 会要求你提供数据库连接详情。填写你在步骤 2 中创建的数据库和用户信息:
- 数据库名(Database Name):
servbay_wordpress_db
- 用户名(Username):
wordpress_user
- 密码(Password):
your_strong_password_here
(使用你在步骤 2.4 中设置的实际密码) - 数据库主机(Database Host):
localhost
- 表前缀(Table Prefix):
wp_
(这是默认值,出于安全考虑,你可以更改为其他前缀,例如sbwp_
)
点击「提交」。如果连接成功,WordPress 会提示你运行安装。
- 数据库名(Database Name):
运行安装
点击「运行安装」(Run the installation)。
填写站点信息
接下来,你需要填写你的网站基本信息:
- 站点标题(Site Title):你的网站名称。
- 用户名(Username):创建 WordPress 管理员账户的用户名(建议不要使用
admin
,选择一个更独特的用户名)。 - 密码(Password):创建 WordPress 管理员账户的密码。WordPress 会提示密码强度,请务必设置一个强密码。
- 你的电子邮件(Your Email):输入你的邮箱地址。
- 搜索引擎可见性(Search Engine Visibility):本地开发环境通常建议勾选「建议搜索引擎不索引本站点」,避免本地网站被误收录。
完成安装
填写完毕后,点击「安装 WordPress」按钮。WordPress 会自动完成最后的安装过程。
安装成功后,你会看到一个成功的提示页面,并提供登录 WordPress 管理后台的链接。
使用 WordPress 构建网站
恭喜!你已在 ServBay 本地环境中成功安装并配置了 WordPress。现在,你可以开始探索 WordPress 的强大功能,并利用它来构建你的网站了。
登录到 WordPress 管理后台(通常是 https://servbay-wordpress.demo/wp-admin/
),你可以进行以下常见操作:
- 安装主题和插件: 通过「外观」->「主题」和「插件」->「安装插件」来改变网站外观和增加功能。ServBay 的本地环境允许你安全地测试各种主题和插件。
- 创建和编辑内容: 使用「文章」和「页面」菜单来发布博客文章或创建静态页面。
- 配置导航菜单: 在「外观」->「菜单」中组织你的网站导航结构。
- 自定义网站外观: 通过「外观」->「自定义」或主题选项进行网站布局和样式的调整。
常见问题 (FAQ)
Q: 我无法访问
https://servbay-wordpress.demo
,怎么办?- A: 确保 ServBay 正在运行,并且相关的 Web 服务器(Caddy/Nginx)和 PHP 软件包已启动。
- 检查 ServBay 的「网站」配置,确认域名拼写、网站根目录是否正确指向
/Applications/ServBay/www/servbay-wordpress-app
,以及是否关联了正确的 PHP 版本。 - 尝试清除浏览器缓存或使用隐身模式访问。
- 检查 macOS 的防火墙设置是否可能阻止了本地连接。
Q: WordPress 安装时提示数据库连接错误?
- A: 仔细核对你在安装向导中输入的数据库名、用户名、密码和数据库主机 (
localhost
) 是否与你在 ServBay 的数据库管理工具中创建的一致。 - 确保 ServBay 中的 MySQL 或 MariaDB 数据库软件包正在运行。
- 确认你创建的数据库用户拥有访问
servbay_wordpress_db
数据库的权限。
- A: 仔细核对你在安装向导中输入的数据库名、用户名、密码和数据库主机 (
Q: 我可以在同一个 ServBay 中安装多个 WordPress 网站吗?
- A: 是的,完全可以。只需为每个 WordPress 网站重复步骤 1-4:将 WordPress 文件解压到不同的子目录,为每个网站创建独立的数据库和用户,并在 ServBay 的「网站」中为每个网站配置一个唯一的本地域名和对应的根目录。
Q: ServBay 支持哪些 PHP 版本用于 WordPress?
- A: ServBay 支持多种 PHP 版本,你可以根据 WordPress 版本的要求或你的开发需求选择合适的 PHP 版本。通常推荐使用 WordPress 官方推荐的最新兼容版本。
总结
通过遵循以上步骤,你已经在 ServBay 这个强大的本地开发环境中成功搭建了你的第一个本地 WordPress 网站。利用 ServBay 集成的各种工具和多版本支持,你可以高效、灵活地进行 WordPress 主题和插件开发、功能测试或内容管理。希望这份指南能帮助你更好地利用 ServBay 开启你的 WordPress 开发之旅!