答案:部署PHP到Heroku可通过CLI手动或GitHub自动实现。先注册账号、安装CLI、准备含index.php和composer.json的项目;手动部署用heroku create和git push heroku main;自动部署需连接GitHub仓库并开启自动同步;配置Procfile、使用环境变量、避免本地写入可确保稳定运行,通过日志排查问题,几分钟即可上线。

将PHP程序部署到Heroku平台其实非常简单,尤其是配合GitHub和Heroku的自动部署功能,可以实现代码提交后自动上线,达到“一键部署”的效果。下面详细介绍从准备到上线的完整流程。
准备工作:注册与环境搭建
在开始部署前,你需要完成以下基础设置:
- 注册Heroku账号:访问 heroku.com 并注册一个免费账户。
- 安装Heroku CLI:下载并安装 Heroku 命令行工具,用于本地登录和操作。安装完成后,在终端运行 heroku --version 验证是否成功。
- 准备PHP项目:确保你的PHP项目根目录包含 index.php 和 composer.json 文件。即使不用Composer,也建议创建一个空的 composer.json 来声明项目类型。
示例 composer.json:
{"require": {
"php": "^8.0"
}
}
方式一:通过Heroku CLI手动部署
适合快速测试或小项目发布。
立即学习“PHP免费学习笔记(深入)”;
- 打开终端,进入你的PHP项目根目录。
- 执行 heroku login 登录你的Heroku账号。
- 运行 heroku create 创建一个新的Heroku应用(会自动生成随机名称)。
- 使用 git add .、git commit -m "deploy" 提交代码。
- 执行 git push heroku main 推送代码到Heroku服务器。
推送完成后,Heroku会自动检测为PHP项目,安装依赖并启动服务。最后会输出应用的URL,浏览器打开即可访问。
方式二:连接GitHub实现自动部署
适合团队协作或持续集成,真正实现“一键部署”。
- 将你的PHP项目推送到GitHub仓库。
- 在Heroku Dashboard中选择你的应用,进入 Deploy 标签页。
- 连接你的GitHub账号,并搜索选择对应的仓库。
- 开启 Automatic Deploys,选择主分支(如 main 或 master)。
此后,每次你向GitHub推送代码,Heroku都会自动拉取并重新部署,无需手动操作。
配置说明与常见问题处理
为了让PHP项目稳定运行,注意以下几点:
- 静态资源路径:Heroku的文件系统是只读的,上传文件或缓存不要写入本地磁盘,应使用外部存储如AWS S3。
- 环境变量配置:数据库连接、API密钥等敏感信息,使用 heroku config:set KEY=VALUE 命令设置,避免写死在代码中。
-
自定义web服务器配置:可在根目录添加 Procfile 文件,内容为:
web: vendor/bin/heroku-php-apache2 web/
其中 web/ 是你的网站根目录(可按实际调整)。
如果遇到部署失败,可通过 heroku logs --tail 查看实时日志,定位错误原因。
基本上就这些。只要项目结构清晰、依赖明确,PHP程序在Heroku上的部署过程非常顺畅,几分钟就能上线运行。











