如何在Codeship中安装Blackfire PHP扩展以适配Heroku部署？

我来帮你搞定这个问题——之前我也碰到过类似的场景：Heroku要求项目依赖ext-blackfire，但Codeship的默认PHP环境里没装这个扩展，导致composer install直接失败。下面是具体的解决步骤，分环境和安装方式给你梳理清楚：

1. 先确认你的Codeship环境类型 #

Codeship分Basic和Pro两种环境，配置入口不一样，但核心的安装命令是通用的：

• Codeship Basic：直接修改项目根目录的setup.sh脚本，或者在项目设置的「Setup Commands」里添加命令
• Codeship Pro：在codeship-services.yml中给你的PHP服务添加安装步骤

2. 安装Blackfire扩展的两种方式 #

方式一：用Blackfire官方一键脚本（最省心） #

Blackfire提供了适配Debian/Ubuntu和RPM系系统的安装脚本，能自动处理依赖和版本适配：

# Debian/Ubuntu环境（Codeship大部分基础镜像都是这个）
curl -s https://packagecloud.io/install/repositories/blackfire/blackfire/script.deb.sh | sudo bash
sudo apt-get install -y blackfire-php

如果你的环境是CentOS这类RPM系统，换这个脚本：

curl -s https://packagecloud.io/install/repositories/blackfire/blackfire/script.rpm.sh | sudo bash
sudo yum install -y blackfire-php

方式二：手动通过PECL安装（适合定制版本） #

如果官方脚本适配有问题，或者你需要指定精确的1.18版本（对应composer要求的~1.18），可以用PECL手动装：

# 先装编译依赖
sudo apt-get install -y php-pear php-dev gcc make
# 安装指定版本的Blackfire
sudo pecl install blackfire-1.18.0
# 把扩展加到PHP配置里（替换[YOUR_PHP_VERSION]为实际版本，比如7.4、8.0）
echo "extension=blackfire.so" | sudo tee /etc/php/[YOUR_PHP_VERSION]/cli/conf.d/blackfire.ini

3. 验证安装是否成功 #

加个验证步骤确保扩展真的装上了，避免白忙活：

php -m | grep blackfire

如果输出blackfire，说明安装没问题。

4. 绕开Composer检查的快捷方式（仅部署用） #

如果你只是为了通过Composer的依赖检查、不需要在Codeship里实际用Blackfire功能，可以直接给composer install加参数跳过平台依赖检查：

composer install --ignore-platform-reqs

注意：这个方法只是绕过检查，要是你在Codeship里需要跑依赖Blackfire的测试，还是得实际安装扩展才行。

5. 可选：配置Blackfire功能（如果需要在构建中使用） #

要是你想在Codeship里用Blackfire做性能分析，得加两个环境变量（从Blackfire控制台获取你的服务器ID和令牌）：

export BLACKFIRE_SERVER_ID=你的服务器ID
export BLACKFIRE_SERVER_TOKEN=你的服务器令牌

按照上面的步骤调整后，Codeship的composer install就能顺利通过，然后正常部署到Heroku了。

内容的提问来源于stack exchange，提问作者SoniCoder