heroku/buildpack-php

Heroku PHP Cloud Native Buildpack

概述

Heroku PHP Cloud Native Buildpack是Heroku官方提供的云原生构建工具，专为PHP应用程序设计。它符合Cloud Native Buildpacks (CNB)规范，能够自动检测、构建和打包PHP应用，生成可直接部署到云原生环境（如Kubernetes、Heroku、Cloud Foundry等）的OCI镜像。

核心功能

• 自动应用检测：识别项目中的composer.json、index.php等PHP特征文件，无需手动配置构建规则
• 多PHP版本支持：兼容PHP 7.4+及各稳定版本，可通过composer.json或环境变量指定版本
• 依赖管理：集成Composer，自动安装项目依赖并优化依赖树
• 扩展支持：预配置常用PHP扩展（如mbstring、curl、json等），支持自定义扩展安装
• 环境适配：根据目标环境自动调整配置（如生产环境优化、日志格式标准化）
• 缓存优化：缓存依赖文件以加速重复构建过程

使用场景

• PHP应用的云原生部署流程构建
• CI/CD流水线中自动化生成PHP应用镜像
• 需要快速迁移传统PHP项目至容器化环境的场景
• 多环境（开发/测试/生产）一致的构建输出需求

使用方法

前置要求

• 安装pack CLI（CNB官方构建工具）
• Docker环境（用于构建和运行镜像）
• PHP项目（需包含composer.json或入口PHP文件）

基础构建命令

使用pack CLI配合Heroku构建器构建镜像：

bash
pack build my-php-app \
  --builder heroku/buildpacks:20 \  # 使用Heroku官方构建器
  --buildpack heroku/php \          # 指定当前PHP buildpack
  --env BP_PHP_VERSION=8.2         # 可选：指定PHP版本

版本指定方式

1. 通过composer.json指定（推荐）：

json
{
  "require": {
    "php": ">=8.1"
  }
}

2. 通过环境变量指定：

bash
pack build my-php-app --buildpack heroku/php --env BP_PHP_VERSION=8.1.20

扩展配置

如需启用额外扩展，可在项目根目录创建.heroku/php/conf.d/php.ini文件：

ini
extension=redis.so
extension=mongodb.so

构建产物使用

构建完成后，可直接通过Docker运行生成的镜像：

bash
docker run -p 8080:8080 my-php-app

配置参数

参考链接

• https://github.com/heroku/buildpacks-php
• Cloud Native Buildpacks规范
• Heroku PHP应用部署文档