WordPress on Heroku部署指南

WordPress on Heroku部署指南

本指南将详细介绍如何利用开源项目 PhilippHeuer/wordpress-heroku 在Heroku平台上部署WordPress。我们将依次解析项目的目录结构、启动文件以及配置文件，帮助您顺利搭建您的WordPress站点。

1. 目录结构及介绍

WordPress on Heroku项目基于Bedrock，它提供了一个现代的WordPress堆栈，优化了开发流程和项目结构。下面是基本的目录结构概述：

.
├── README.md         # 项目说明文件
├── LICENSE            # 许可证文件，遵循MIT协议
├── composer.json      # 依赖管理文件，列出所有PHP依赖项
├── .env.example       # 环境变量模板，用于设置WordPress配置
├── web                # 公开访问的web根目录，其中包含wp-content等
│   ├── index.php      # 主入口文件，处理所有的HTTP请求
│   └── ...
├── bin                # 包含自定义脚本或命令的地方
├── config             # 配置文件夹，可能包含mu-plugins的自动加载配置
│   └── ...
└── vendor              # Composer安装的所有依赖库

• README.md 提供项目部署和使用的快速指南。
• LICENSE 文件确认项目许可是MIT，允许自由使用、修改和分发。
• composer.json 定义了所需的PHP包，包括WordPress的核心。
• .env.example 是环境变量示例，需据此创建.env文件来配置WordPress。
• web 目录作为应用的服务入口，包含了必要的WordPress组件。
• bin, config, 和 vendor 分别存放脚本、特定配置以及Composer下载的依赖。

2. 启动文件介绍

在本项目中，启动过程主要由Heroku平台自动化处理，但关键的入口点是位于web/index.php文件。此文件是WordPress的主执行文件，负责初始化WordPress框架并路由HTTP请求到适当的处理函数。对于Heroku部署而言，重要的是正确配置环境以确保该文件能够找到其依赖和服务（如数据库连接）。

实际启动流程涉及Heroku的Dynos启动时加载的Web进程，它通过读取应用程序的Procfile（若存在）或者默认寻找web目录下的index.php来启动服务。

3. 项目的配置文件介绍

配置主要通过.env文件进行管理（原始模板为.env.example）。在这个文件中，您需要设置以下关键环境变量：

• DB_NAME: 数据库名称
• DB_USER: 数据库用户名
• DB_PASSWORD: 数据库密码
• DB_HOST: 数据库主机名，通常是Heroku提供的 PostgreSQL 数据库URL。
• WP_ENV: 环境标识符，通常是“development”，“staging”，或“production”。
• WP_HOME: WordPress网站的公共URL。
• WP_SITEURL: 类似于WP_HOME，但包含后台路径。

注意: 在Heroku上部署时，还需要确保通过Heroku CLI或其他方式设置了这些环境变量，因为它们对于让WordPress正确连接到数据库和确定其运行环境至关重要。

以上是对WordPress on Heroku项目核心组成部分的简要介绍，确保在部署之前仔细配置这些部分，可以极大地提高部署的成功率和后期维护的便捷性。