将 Laravel 应用程序部署到 Elastic Beanstalk

Laravel 是一个开源的， model-view-controller(MVC) 框架，用于。PHP本教程将引导您完成生成 Laravel 应用程序、将其部署到 AWS Elastic Beanstalk 环境以及将其配置为连接到亚马逊关系数据库服务 (AmazonRDS) 数据库实例的过程。

先决条件

本教程假设您对基本 Elastic Beanstalk 操作和 Elastic Beanstalk 控制台有一定了解。如果尚不了解，请按照Elastic Beanstalk 入门中的说明操作以启动您的第一个 Elastic Beanstalk 环境。

为了遵循本指南中的步骤，您需要命令行终端或 Shell，以便运行命令。命令显示在列表中，以提示符（$）和当前目录名称（如果有）开头。

~/eb-project$ this is a command
this is output

在 Linux 和 macOS 中，您可使用您首选的 Shell 和程序包管理器。在 Windows 上，你可以安装适用于 Linux 的 Windows 子系统来获得与 Windows 集成的版本的 Ubuntu 和 Bash。

Laravel 6 需要 PHP 7.2 或更高版本。它还需要Laravel官方文档中服务器要求主题中列出的PHP扩展。按照主题为 Elastic Beanstalk 设置PHP开发环境中的说明安装PHP和 Composer。

如需 Laravel 支持和维护信息，请参阅 Laravel 官方文档中的支持策略主题。

启动 Elastic Beanstalk 环境

使用 Elastic Beanstalk 控制台创建 Elastic Beanstalk 环境。选择PHP平台并接受默认设置和示例代码。

环境创建大约需要 5 分钟，将创建以下资源：

所有这些资源都由 Elastic Beanstalk 管理。当您终止环境时，Elastic Beanstalk 会终止其包含的所有资源。

安装 Laravel 并生成网站

Composer 可使用一个命令安装 Laravel 并创建工作项目：

~$ composer create-project --prefer-dist laravel/laravel eb-laravel

Composer 安装 Laravel 及其依赖项，并生成默认项目。

如果您在安装 Laravel 时遇到任何问题，请转到官方文档中的安装主题：https://laravel.com/docs/6.x。

部署您的应用程序

创建包含由 Composer 创建的文件的源包。以下命令将创建名为 laravel-default.zip 的源包。它将排除 vendor 文件夹中的文件，因为这些文件会占用大量空间并且对于将您的应用程序部署到 Elastic Beanstalk 不是必需的。

~/eb-laravel$ zip ../laravel-default.zip -r * .[^.]* -x "vendor/*"

将源包上传到 Elastic Beanstalk 以将 Laravel 部署到您的环境。

配置 Composer 设置

部署完成后，点击在浏览器中URL打开你的 Laravel 应用程序：

这是什么? 默认情况下，Elastic Beanstalk 提供项目在网站根路径下的根目录。但在这种情况下，默认页面 (index.php) 位于 public 文件夹的下一级。您可以通过添加/public来验证这一点URL。例如，http://laravel.us-east-2.elasticbeanstalk.com/public。

要在根路径中提供 Laravel 应用程序，请使用 Elastic Beanstalk 控制台为网站配置文档根目录。

到目前为止，一切正常。接下来，您将在环境中添加一个数据库，并将 Laravel 配置为连接到该数据库。

将数据库添加到环境

在您的 Elastic Beanstalk 环境中启动RDS数据库实例。你可以在 Elastic Beanstalk 上将 My SQL SQLServer、或 Postgre SQL 数据库与 Laravel 一起使用。在本示例中，我们将使用 My SQL。

创建数据库实例需要大约 10 分钟。有关数据库与 Elastic Beanstalk 环境耦合的更多信息，请参阅将数据库添加到 Elastic Beanstalk 环境。

同时，您可更新源代码，以便从环境中读取连接信息。Elastic Beanstalk 使用 RDS_HOSTNAME 等环境变量提供连接详细信息，以便您可以从应用程序中访问。

Laravel 的数据库配置存储在项目代码中 database.php 文件夹下名为 config 的文件内。查找 mysql 条目并修改 host、database、username 和 and password 变量，以便从 Elastic Beanstalk 中读取对应的值：

...
    'connections' => [

        'sqlite' => [
            'driver' => 'sqlite',
            'database' => env('DB_DATABASE', database_path('database.sqlite')),
            'prefix' => '',
        ],

        'mysql' => [
            'driver' => 'mysql',
            'host' => env('RDS_HOSTNAME', '127.0.0.1'),
            'port' => env('RDS_PORT', '3306'),
            'database' => env('RDS_DB_NAME', 'forge'),
            'username' => env('RDS_USERNAME', 'forge'),
            'password' => env('RDS_PASSWORD', ''),
            'unix_socket' => env('DB_SOCKET', ''),
            'charset' => 'utf8mb4',
            'collation' => 'utf8mb4_unicode_ci',
            'prefix' => '',
            'strict' => true,
            'engine' => null,
        ],
...

要验证数据库连接是否已正确配置，请向 index.php 添加代码以连接到数据库，并向默认响应添加一些代码：

...
if(DB::connection()->getDatabaseName())
{
   echo "Connected to database ".DB::connection()->getDatabaseName();
}
$response->send();
...

在数据库实例完成启动后，将已更新的应用程序打包并将其部署到环境。

部署应用程序的新版本花费不到 1 分钟的时间。完成部署后，再次刷新网页，以验证数据库连接成功：

清除

Elastic Beanstalk 使用完毕时，您可以终止您的环境。Elastic Beanstalk AWS 会终止与您的环境关联的所有资源，例如EC2亚马逊实例、数据库实例、负载均衡器、安全组和警报。

利用 Elastic Beanstalk，可以随时为您的应用程序轻松创建新环境。

此外，您还可以终止在您的 Elastic Beanstalk 环境外部创建的数据库资源。当您终止 Amazon RDS 数据库实例时，您可以拍摄快照并稍后将数据还原到另一个实例。

后续步骤

有关 Laravel 的更多信息，请访问 Laravel 官方网站 laravel.com。

当您继续开发应用程序时，您可能希望通过某种方式来管理环境和部署应用程序，而无需手动创建 .zip 文件并将该文件上传到 Elastic Beanstalk 控制台。Elastic Beanstalk 命令行界面 CLI (EB easy-to-use) 提供了从命令行创建、配置应用程序并将其部署到 Elastic Beanstalk 环境的命令。

在本教程中，您使用了 Elastic Beanstalk 控制台来配置 Composer 选项。要使此配置成为应用程序源的一部分，您可以使用类似于下面的配置文件。

option_settings:
  aws:elasticbeanstalk:container:php:phpini:
    document_root: /public

有关更多信息，请参阅 使用配置文件 (.ebextensions) 进行高级环境自定义。

在您的 Elastic Beanstalk 环境中运行亚马逊RDS数据库实例非常适合开发和测试，但它会将数据库的生命周期与您的环境联系起来。请参阅将亚马逊RDS数据库实例添加到您的 Elastic Bean PHP stalk 环境中，浏览有关连接到在环境外运行的数据库的说明。

最后，如果您计划在生产环境中使用应用程序，则需要为环境配置自定义域名并启用HTTPS安全连接。