Laravel 8.x 部署至 Heroku，基于 PostgreSQL 实现

1、在本地开发环境中，基于 Laravel Sail 已经部署完毕。打开网址：http://weibo.test/ ，响应 200。如图1

2、注册一个 Heroku 账号，使用 @163.com ，发现不被允许，最后使用 @gmail.com，才注册成功。如图2

3、在邮箱 @gmail.com 中点击链接以激活帐户。如图3

4、参考网址：https://devcenter.heroku.com/articles/heroku-cli 。Heroku 命令行界面 (CLI) 使直接从终端创建和管理 Heroku 应用程序变得容易。 这是使用 Heroku 的重要组成部分。

5、在 WSL2 中的 Ubuntu 系统中，从终端运行以下命令。报错：error: cannot communicate with server: Post http://localhost/v2/snaps/heroku: dial unix /run/snapd.socket: connect: no such file or directory。如图4

6、最终决定使用 Windows 下的软件。为您的 Windows 安装下载合适的安装程序。如图5

7、安装过程中报错：Error opening file for writing。如图6

8、重新安装，以管理员身份运行，不再报错。

9、验证您的安装，要验证您的 CLI 安装，请使用 heroku –version 命令。已经成功安装。如图7

10、安装 CLI 后，运行 heroku login 命令。 系统会提示您输入任意键以转到 Web 浏览器以完成登录。 然后 CLI 会自动让您登录。如图8

11、参考网址：https://devcenter.heroku.com/articles/getting-started-with-php 。因为文档假设 PHP 与 Composer 安装在本地。由于本地环境的 PHP 版本与 Laravel Sail 环境中的版本不一致，决定先将本地环境的 PHP 版本升级至 PHP 8.1。如图9、图10

 

本地环境的版本号：

Laravel Sail 环境的版本号：

12、升级后的本地环境的 PHP 版本，PHP 8.1.1。

13、进入程序根目录，使用 heroku create 命令在 Heroku 上创建一个新应用。secret-stream-72395 是 Heroku 随机为应用生成的默认名称，每个人生成的名称都不相同。而 https://secret-stream-72395.herokuapp.com/ 则是应用的线上地址。如图11

14、Heroku 平台支持多种语言，在进行应用部署时，Heroku 会自动检查应用的代码是用什么语言写的，然后再接着执行一系列针对该语言的操作来准备好程序运行环境。Laravel 应用默认会包含 package.json 文件，但当 Heroku 检查到该文件时，它会认为此应用是用 Node.js 写的，因此我们需要对应用的 buildpack 进行声明，告诉 Heroku 说我们的应用是用 PHP 写的。如图12

15、将代码推送和部署到 Heroku 上。如图13

16、应用程序现已部署。 确保至少有一个应用实例正在运行，现在通过应用程序名称生成的 URL 访问该应用程序。 作为一个方便的快捷方式，您可以按如下方式打开网站。如图14

17、但是，在浏览器中自动打开网站：https://secret-stream-72395.herokuapp.com/ ，响应 403。如图15

18、在步骤 15 中提示：No Procfile, using ‘web: heroku-php-apache2’。Laravel 项目下新建一个 Procfile 文件，通过配置该文件来告诉 Heroku 应当使用什么命令来启动 Web 服务器。接着还需要将该文件纳入到 Git 版本控制中。报错：Push failed: cannot parse Procfile.。如图16

19、查看文件 Procfile 的内容，如图17

20、参考 Getting Started with Laravel on Heroku：https://devcenter.heroku.com/articles/getting-started-with-laravel 。查看文件 Procfile 的内容，如图18

21、设置 Laravel 加密密钥，使用 Laravel 自带的 artisan 命令来生成 App Key。如图19

22、基于生成的 App Key ，运行该命令行来完成配置。如图20

23、推送时，仍然报错：Push failed: cannot parse Procfile.

24、将文件编码另存为 UTF-8 。如图21

25、推送成功，且打开网址：https://secret-stream-72395.herokuapp.com/ ，响应 200。如图22

26、但是，在提交表单，写入数据至 MySQL 时，响应 500 服务器错误，原因在于数据库还不存在。如图23

27、在 Heroku 上使用 PostgreSQL 来作为我们应用的数据库。安装 PostgreSQL 扩展。Heroku 将为我们生成一个唯一的数据库 URL – DATABASE_URL，我们可以通过命令：heroku config 查看 Heroku 的所有配置信息。如图24

28、在本地开发中，我们使用了 MySQL 来作为数据库储存，但在 Heroku 环境上我们要改为使用 PostgreSQL 来作为数据库储存。因此在进行数据库设置时，我们需要对当前环境进行判断。如果环境为本地环境，则使用 MySQL 数据库，若为 Heroku 环境，则使用 PostgreSQL 数据库。我们可以通过为 Heroku 新增一个 IS_IN_HEROKU 配置项来判断应用是否运行在 Heroku 上。一般来说，应用的数据库都在 config/database.php 中进行配置，因此我们需要针对该配置文件，来为不同环境的数据库连接方式定义一个帮助方法，以便根据应用不同的运行环境来指定数据库配置信息，我们需要新建一个 helpers.php 文件并写入以下内容：

29、新增 helpers.php 文件之后，还需要在项目根目录下 composer.json 文件中的 autoload 选项里 files 字段加入该文件。如图25

30、修改保存后运行以下命令进行重新加载文件即可，如果有可能影响到本地环境的程序运行，建议在 Sail 环境中执行相应命令。如图26

31、现在，让我们使用刚刚定义好的 get_db_config 方法对数据库进行配置。调整数据库配置文件，总计就 2 处改动。如图28

32、改动的代码进行提交，并推送到 GitHub 和 Heroku 上。

33、我们可以使用 heroku run 在 Heroku 运行 Laravel 的指定命令。现在我们需要在 Heroku 上执行迁移，生成用户表，可通过下面命令来完成，报错：SQLSTATE[22023]: Invalid parameter value: 7 ERROR: invalid value for parameter “client_encoding”: “utf8mb4” 。如图28

34、再次调整数据库配置文件，之前 pgsql 相关的配置未修改到。

35、执行命令：heroku config:add DB_CONNECTION=pgsql 。再次执行迁移时报错已经不一样了：

36、最后找到根源在于漏掉了在 Heroku 新增一个 IS_IN_HEROKU 配置项来判断应用是否运行在 Heroku 上。迁移成功。如图29

37、再次提交表单数据，提交成功。如图30

38、使用 heroku rename 来对应用名称进行更改，但要保证更改的名称未被其它人占用。如图31

39、打开：https://app-wangqiang-weibo.herokuapp.com/ ，响应 200。符合预期。如图32

40、打开：https://secret-stream-72395.herokuapp.com/ ，响应 404。There’s nothing here, yet。符合预期。如图33