PHP应用官方Heroku构建包使用与安装指南

本文档将详细介绍如何使用和安装Heroku官方PHP构建包，帮助您在Heroku平台顺利部署PHP应用。

安装指南

在开始使用Heroku构建包前，您需要确保已经在您的应用程序中添加了一个空的composer.json文件。这可以通过以下命令完成：

echo '{}' > composer.json
git add composer.json
git commit -m "添加 composer.json 以便PHP应用检测"

如果您的应用程序中有可能触发其他构建包检测的文件（例如，一个package.json可能会导致您的代码被检测为Node.js应用），则需要手动设置您的应用程序使用PHP构建包：

heroku buildpacks:set heroku/php

若要使用GitHub上的默认分支而非官方发布版本，可以使用以下命令：

heroku buildpacks:set https://github.com/heroku/heroku-buildpack-php

使用说明

在使用Heroku构建包时，确保您的应用程序中有composer.json文件。如果您的应用程序中还有可能被其他构建包识别的文件，您需要手动指定使用PHP构建包，如上述安装指南所述。

Heroku构建包使用Composer来管理依赖项，并支持所有最近的PHP运行时版本，并提供Apache2或Nginx服务器的选择。

API使用文档

Heroku构建包不直接提供API，但它是通过配置变量与您的应用程序交互的。例如，若要使用自定义的Composer仓库，您可以通过以下配置变量来设置：

heroku config:set HEROKU_PHP_PLATFORM_REPOSITORIES="https://<your-bucket-name>.s3.<your-bucket-region>.amazonaws.com/heroku-20/packages.json"

您还可以控制自定义平台的优先级，通过在仓库URL中添加查询字符串参数来实现，例如：

heroku config:set HEROKU_PHP_PLATFORM_REPOSITORIES="https://customrepo.com/packages.json?composer-repository-only=ext-igbinary,ext-redis"

这将只允许ext-igbinary和ext-redis包从customrepo.com中获取，其他包将从默认仓库中查找。

项目安装方式

Heroku构建包的安装通过Heroku命令行工具完成。以下是在您的应用程序中设置和部署PHP构建包的步骤：

1. 创建一个空的composer.json文件并添加到您的版本控制系统中。
2. 如果需要，手动设置您的应用程序使用PHP构建包。
3. 部署应用程序到Heroku。

确保在部署应用程序之前，您已经设置了所有必要的配置变量，如自定义平台仓库等。

请注意，Heroku不提供关于自定义平台仓库和包的相关支持。在构建自定义平台包和仓库时，请参考support/build/README.md中的说明。