站点文件
添加或导入已有站点
CMS 解决方案
使用 FlyEnv 构建 WordPress 本地开发环境
为每个 WordPress 站点配置并管理所需的 PHP 版本、扩展、数据库、Web 服务器、本地域名和 HTTPS。
FlyEnv 为每个 WordPress 站点管理什么
WordPress 以站点为中心：文件、文档根目录、PHP 运行时、数据库和本地 URL 需要保持一致。FlyEnv 将 PHP 版本和扩展绑定到各个项目。
PHP 运行时
按项目选择版本
PHP 扩展
直观查看并安装扩展
站点数据库
在本地管理内容和设置
Web 服务器
处理固定链接和本地重写
站点 URL
测试 Cookie、重定向和 Webhook
可选服务
按需启用对象缓存或主题工具链
多个 WordPress 站点，一个工作区
将客户站点、插件开发和主题开发彼此隔离，无需每次都重新搭建本地技术栈。
每个站点独立 PHP 版本
让插件和主题兼容性始终对应项目自己的运行时。
独立站点数据库
管理 MySQL 或 MariaDB，避免不同客户项目的数据混在一起。
明确的文档根目录
明确指定 WordPress 目录，减少意外暴露项目文件的风险。
本地域名和 HTTPS
在本地测试重定向、Cookie、OAuth 回调和安全浏览器功能。
FlyEnv 中的 WordPress 站点工作流
从项目文件开始构建可运行的本地站点：选择运行时、连接数据库、设置服务根目录，并在真实本地 URL 上开发主题或插件。
- 1
新建或导入
从新项目或已有站点目录开始。
- 2
PHP + 扩展
让运行时匹配站点的插件和主题。
- 3
MySQL / MariaDB
连接保存站点内容的数据库。
- 4
设置站点根目录
确保 wp-config.php 和 wp-content/ 位于服务目录中。
- 5
本地域名 + HTTPS
使用带可信证书的 client-site.test。
- 6
主题 / 插件开发
在 wp-content/themes 和 wp-content/plugins 中开发主题和插件。
可选支持服务
Redis 对象缓存
当站点的缓存方案使用 Redis 时再启用对象缓存。
Node.js 工具链
主题、区块或前端工具需要构建步骤时再添加。
为什么使用 FlyEnv 开发 WordPress
为依赖 PHP、内容文件、数据库和浏览器访问 URL 的站点提供更可预测的本地工作流。
让 PHP 匹配站点
为旧插件、现代区块主题或客户站点选择兼容的 PHP 版本。
旧站点 → PHP 7.4 · 现代站点 → PHP 8.2+
查看扩展需求
在插件或站点导入失败前，先确认站点需要哪些 PHP 扩展。
PHP → 扩展 → 调试前先确认
选择 MySQL 或 MariaDB
让数据库引擎贴合项目，而不是让项目迁就一个不透明的环境。
使用站点所需的数据库引擎
分离各站点根目录
为每个 WordPress 站点指定清晰的目录和本地 URL。
使用真实的本地 HTTPS
在可信域名上测试登录 Cookie、重定向、支付回调和嵌入内容。
https://client-site.test
一起启动支持服务
当站点同时需要 PHP、数据库、Redis 或前端工具链时，使用 Startup Group。
新建 WordPress 站点，或将已有站点带到本地
无论是新站点、已有客户项目，还是现成的主题和插件工作区，都可以使用 FlyEnv。
新建 WordPress 站点
- 1打开 PHP → 新建项目，并选择 WordPress。
- 2选择项目使用的 PHP 版本和 Composer 版本。
- 3创建项目文件，并添加对应的本地站点。
- 4选择文档根目录并配置本地域名。
- 5启动站点和数据库，并通过 HTTPS 打开站点。
导入已有站点
- 1打开已有的 WordPress 目录。
- 2设置 PHP 版本并检查所需扩展。
- 3创建或连接 MySQL 或 MariaDB 数据库。
- 4添加站点根目录、本地域名、重写规则和 HTTPS。
- 5将站点服务加入启动组，方便重复启动。
WordPress 本地开发方式对比
不同的环境解决不同的问题。下面对比 WordPress 使用手动技术栈、容器或 FlyEnv 时的差异。
| 特性 | 手动本地技术栈 | 容器工作流 | FlyEnv |
|---|---|---|---|
| PHP 版本隔离 | 手动切换 | 在容器配置中定义 | 按项目选择运行时 |
| PHP 扩展 | 手动编辑 php.ini | 重新构建镜像或配置 | 可视化管理扩展 |
| 多个站点 | 手动配置虚拟主机 | 每个项目一套技术栈 | 一个工作区管理多个本地站点 |
| 数据库生命周期 | 单独配置服务器 | 容器服务 | MySQL 或 MariaDB 模块 |
| 本地 HTTPS | 手动配置证书 | 依赖代理的配置 | 可信本地域名和 HTTPS |
WordPress 常见问题
关于使用 FlyEnv 开发本地 WordPress 站点的常见问题。
不同的 WordPress 站点可以使用不同的 PHP 版本吗？
可以。FlyEnv 允许每个项目或本地站点使用所需的 PHP 版本，适合仍未兼容新版运行时的旧插件或主题。
可以使用 MariaDB 代替 MySQL 吗？
可以。FlyEnv 提供两种数据库模块，选择与你的站点或需要复现的环境匹配的数据库引擎即可。
本地站点应该指向哪个目录？
将站点指向包含 WordPress 文件和 wp-config.php 的目录。明确服务根目录，避免意外暴露项目中的私有文件。
每个 WordPress 站点都需要 Redis 吗？
不需要。只有当站点或缓存方案使用对象缓存时才需要 Redis，只为真正需要它的项目启动即可。
可以开发使用 Node.js 的主题或区块吗？
可以。当主题、区块或前端工具需要构建步骤时添加 Node.js。WordPress 本身不需要 Node.js 来处理请求。
可以在 FlyEnv 中管理多个客户 WordPress 站点吗？
可以。每个站点都能保留独立的目录、PHP 版本、数据库、本地域名和可选服务，同时在一个工作区中统一管理。
