Heroku原生支持PHP和Composer,部署时自动检测composer.json并安装依赖。1. 确保项目含composer.json、入口文件及Procfile(可选);2. 通过Heroku CLI登录并创建应用;3. 使用Git推送代码触发部署,Heroku自动运行composer install;4. 通过heroku config:set设置环境变量管理配置;5. 可选Procfile自定义Web服务器行为,如指定public为根目录。整个流程自动化程度高,只需结构清晰即可顺利完成部署。

在Heroku上部署带有Composer依赖的PHP应用并不复杂,只要遵循正确的流程。Heroku原生支持PHP和Composer,能够自动检测composer.json文件并执行依赖安装。以下是完整的部署流程指南,帮助你顺利将PHP项目上线。
确认项目结构符合要求
确保你的PHP项目根目录包含以下关键文件:
如果你使用MVC框架(如Laravel、Symfony),建议将Web根目录指向public/目录。Heroku会自动识别该结构。
示例composer.json内容:
立即学习“PHP免费学习笔记(深入)”;
{ "require": { "php": "^8.1", "monolog/monolog": "^2.0" }, "autoload": { "psr-4": { "App\\": "src/" } } }配置Heroku应用与Git仓库
确保已安装Heroku CLI,并在本地登录:
heroku login初始化Git仓库(如果尚未初始化):
git init git add . git commit -m "Initial commit"创建Heroku应用:
heroku create your-app-name这会自动添加一个名为heroku的远程仓库。
部署并验证Composer自动安装
推送代码到Heroku:
Heroku检测到composer.json后,会自动执行:
composer install --no-dev --prefer-dist --optimize-autoloader- 生成优化的自动加载文件
- 安装所有生产环境依赖
部署过程中你会看到类似输出:
remote: -----> Installing dependencies... remote: Composer version 2.x installed remote: Loading composer repositories with package information remote: Installing dependencies from lock file remote: ...如果项目有composer.lock文件,Heroku将优先使用它来保证依赖版本一致。
设置环境变量与扩展(如数据库)
某些PHP应用需要配置环境变量。例如,Laravel使用.env文件,但在Heroku中应通过配置变量管理:
如需数据库支持,可添加Heroku Postgres插件:
heroku addons:create heroku-postgresql:hobby-dev注意:.env 文件不应提交到Git,使用config:命令管理敏感信息更安全。
自定义Web服务器行为(可选)
若需自定义PHP内置服务器的文档根目录或启动脚本,可在项目根目录创建Procfile:
这会使用Apache并指定public/为Web根目录。也支持Nginx:
Heroku提供多种运行选项,包括自定义php.ini配置:
web: vendor/bin/heroku-php-apache2 public/ -C custom.conf -P php.ini 基本上就这些。只要结构清晰、依赖明确,Heroku能自动完成大部分工作。











