本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 将 CakePHP 应用程序部署到 Elastic Beanstalk
<a name="php-cakephp-tutorial"></a>

CakePHP 是用于 PHP 的开放源 MVC 框架。本教程将指导您完成生成 CakePHP 项目、将该项目部署到 Elastic Beanstalk 环境并配置该项目以连接到 Amazon RDS 数据库实例的过程。

**Topics**
+ [先决条件](#php-cakephp-tutorial-prereqs)
+ [启动 Elastic Beanstalk 环境](#php-cakephp-tutorial-launch)
+ [安装 CakePHP 并生成网站](#php-cakephp-tutorial-generate)
+ [部署您的应用程序](#php-cakephp-tutorial-deploy)
+ [将数据库添加到环境](#php-cakephp-tutorial-database)
+ [清理](#php-cakephp-tutorial-cleanup)
+ [后续步骤](#php-cakephp-tutorial-nextsteps)

## 先决条件
<a name="php-cakephp-tutorial-prereqs"></a>

本教程假设您对基本 Elastic Beanstalk 操作和 Elastic Beanstalk 控制台有一定了解。如果尚不了解，请按照[了解如何开始使用 Elastic Beanstalk](GettingStarted.md)中的说明操作以启动您的第一个 Elastic Beanstalk 环境。

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

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

在 Linux 和 macOS 中，您可使用您首选的 Shell 和程序包管理器。在 Windows 上，您可以[安装适用于 Linux 的 Windows 子系统](https://docs.microsoft.com/en-us/windows/wsl/install-win10)，以获取与 Windows 集成的 Ubuntu 和 Bash 版本。

CakePHP 4 需要 PHP 7.4 或更高版本。它还需要 [CakePHP 官方安装](https://book.cakephp.org/4/en/installation.html)文档中列出的 PHP 扩展。PHP 和 Composer 都必须安装。

## 启动 Elastic Beanstalk 环境
<a name="php-cakephp-tutorial-launch"></a>

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

**启动环境（控制台）**

1. [使用以下预配置链接打开 Elastic Beanstalk 控制台：console.aws.amazon。 com/elasticbeanstalk/home\$1/newApplication？ 应用程序名称=教程&环境类型= LoadBalanced](https://console.aws.amazon.com/elasticbeanstalk/home#/newApplication?applicationName=tutorials&environmentType=LoadBalanced)

1. 对于 **Platform**（平台），选择与应用程序使用的语言匹配的平台和平台分支。

1. 对于**应用程序代码**，选择**示例应用程序**。

1. 选择**复查并启动**。

1. 检查可用选项。选择要使用的可用选项，然后在准备就绪后选择**创建应用程序**。

环境创建大约需要 5 分钟，将创建以下资源：
+ **EC2 实例** — 配置为在您选择的平台上运行 Web 应用程序的亚马逊弹性计算云 (Amazon EC2) 虚拟机。

  各平台运行一组特定软件、配置文件和脚本以支持特定的语言版本、框架、Web 容器或其组合。大多数平台使用 Apache 或 NGINX 作为 Web 应用程序前的反向代理，向其转发请求、提供静态资产以及生成访问和错误日志。
+ **实例安全组** — 配置为允许端口 80 上的入站流量的 Amazon EC2 安全组。此资源允许来自负载均衡器的 HTTP 流量到达运行您的 Web 应用程序的 EC2 实例。默认情况下，其他端口不允许流量进入。
+ **负载均衡器** – 配置为向运行您的应用程序的实例分配请求的 Elastic Load Balancing 负载均衡器。负载均衡器还使您无需将实例直接公开在 Internet 上。
+ **负载均衡器安全组**-配置为允许端口 80 上的入站流量的 Amazon EC2 安全组。利用此资源，HTTP 流量可从 Internet 到达负载均衡器。默认情况下，其他端口不允许流量进入。
+ **Auto Scaling 组** – 配置为在实例终止或不可用时替换实例的 Auto Scaling 组。
+ **Amazon S3 存储桶** – 使用 Elastic Beanstalk 时创建的源代码、日志和其他构件的存储位置。
+ **Amazon CloudWatch CloudWatch 警**报 — 两个警报，用于监控您环境中实例的负载，并在负载过高或过低时触发。警报触发后，您的 Auto Scaling 组会扩展或收缩以进行响应。
+ **CloudFormation 堆栈** — Elastic CloudFormation Beanstalk 用于在您的环境中启动资源并传播配置更改。这些资源在您可通过 [CloudFormation 控制台](https://console.aws.amazon.com/cloudformation)查看的模板中定义。
+ **域名**-以表单形式路由到您的 Web 应用程序的域名**subdomain*。 *region*.elasticbeanstalk.com。*
**域安全**  
为增强 Elastic Beanstalk 应用程序的安全性，已将 *elasticbeanstalk.com* 域注册到 [公共后缀列表（PSL）](https://publicsuffix.org/)。  
如果您需要在 Elastic Beanstalk 应用程序的默认域名中设置敏感 Cookie，我们建议您使用带有前缀 `__Host-` 的 Cookie 来提高安全性。这种做法可以保护您的域免遭跨站点请求伪造（CSRF）攻击。要了解更多信息，请参阅 Mozilla 开发者网络中的 [Set-Cookie](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Set-Cookie#cookie_prefixes) 页面。

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

**注意**  
Elastic Beanstalk 创建的 Amazon S3 存储桶将在多个环境之间共享并且在环境终止期间不会被删除。有关更多信息，请参阅 [将 Elastic Beanstalk 和 Amazon S3 结合使用](AWSHowTo.S3.md)。

## 安装 CakePHP 并生成网站
<a name="php-cakephp-tutorial-generate"></a>

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

```
~$ composer create-project --prefer-dist cakephp/app eb-cake
```

Composer 安装 CakePHP 及其约 20 个依赖项，并生成默认项目。

如果您在安装 CakePHP 时遇到问题，请访问官方文档中的安装主题：[http://book.cakephp.org/4.0/en/installation.html](http://book.cakephp.org/4.0/en/installation.html)

## 部署您的应用程序
<a name="php-cakephp-tutorial-deploy"></a>

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

```
eb-cake zip ../cake-default.zip -r * .[^.]* -x "vendor/*"
```

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

**部署源包**

1. 打开 [Elastic Beanstalk](https://console.aws.amazon.com/elasticbeanstalk) 控制台，然后**在 “区域” 列表中，选择您**的。 AWS 区域

1. 在导航窗格中，选择 **Environments**（环境），然后从列表中选择环境的名称。

1. 在环境概述页面上，选择 **Upload and deploy**（上传和部署）。

1. 使用屏幕上的对话框上传源包。

1. 选择 **Deploy**（部署）。

1. 部署完成后，选择站点 URL 以在新选项卡中打开您的网站。

**注意**  
为了进一步优化源包，请初始化一个 Git 存储库并使用 [`git archive` 命令](applications-sourcebundle.md#using-features.deployment.source.git)创建源包。默认 Symfony 项目包含一个 `.gitignore` 文件，该文件指示 Git 排除 `vendor` 文件夹以及部署时不需要的其他文件。

该过程完成时，单击 URL，在浏览器中打开 CakePHP 应用程序。

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

## 将数据库添加到环境
<a name="php-cakephp-tutorial-database"></a>

在 Elastic Beanstalk 环境中启动 Amazon RDS 数据库实例。你可以在 Elastic Beanstalk 上 SQLServer将 MySQL 或 PostgreSQL 数据库与 CakePHP 一起使用。在本示例中，我们将使用 PostgreSQL。

**将 Amazon RDS 数据库实例添加到 Elastic Beanstalk 环境**

1. 打开 [Elastic Beanstalk](https://console.aws.amazon.com/elasticbeanstalk) 控制台，然后**在 “区域” 列表中，选择您**的。 AWS 区域

1. 在导航窗格中，选择 **Environments**（环境），然后从列表中选择环境的名称。

1. 在导航窗格中，选择 **Configuration**（配置）。

1. 在 **Database**（数据库）下，选择 **Edit**（编辑）。

1. 对于**数据库引擎**，请选择 **postgres**。

1. 键入主 **username**（用户名）和 **password**（密码）。Elastic Beanstalk 将使用环境属性为应用程序提供这些值。

1. 要保存更改，请选择页面底部的 **Apply**（应用）。

创建数据库实例需要大约 10 分钟。同时，您可更新源代码，以便从环境中读取连接信息。Elastic Beanstalk 使用 `RDS_HOSTNAME` 等环境变量提供连接详细信息，以便您可以从应用程序中访问。

CakePHP 的数据库配置位于项目代码中 `app.php` 文件夹下名为 `config` 的文件内。打开此文件，添加从 `$_SERVER` 读取环境变量的代码，并将其分配到本地变量。在第一行 (`<?php`) 后插入以下示例中突出显示的行：

**Example \$1/Eb-.php cake/config/app**  

```
<?php
if (!defined('RDS_HOSTNAME')) {
  define('RDS_HOSTNAME', $_SERVER['RDS_HOSTNAME']);
  define('RDS_USERNAME', $_SERVER['RDS_USERNAME']);
  define('RDS_PASSWORD', $_SERVER['RDS_PASSWORD']);
  define('RDS_DB_NAME', $_SERVER['RDS_DB_NAME']);
}
return [
...
```

数据库连接可在 `app.php` 中进行配置。使用与数据库引擎（`Mysql`、`Sqlserver` 或 `Postgres`）相匹配的驱动程序名称，查找以下部分并修改默认数据源配置，并设置 `host`、`username`、`password` 和 `database` 变量，以便从 Elastic Beanstalk 读取相应的值：

**Example \$1/Eb-.php cake/config/app**  

```
...
     /**
     * Connection information used by the ORM to connect
     * to your application's datastores.
     * Drivers include Mysql Postgres Sqlite Sqlserver
     * See vendor\cakephp\cakephp\src\Database\Driver for complete list
     */
    'Datasources' => [
        'default' => [
            'className' => 'Cake\Database\Connection',
            'driver' => 'Cake\Database\Driver\Postgres',
            'persistent' => false,
            'host' => RDS_HOSTNAME,
            /*
             * CakePHP will use the default DB port based on the driver selected
             * MySQL on MAMP uses port 8889, MAMP users will want to uncomment
             * the following line and set the port accordingly
             */
            //'port' => 'non_standard_port_number',
            'username' => RDS_USERNAME,
            'password' => RDS_PASSWORD,
            'database' => RDS_DB_NAME,
            /*
             * You do not need to set this flag to use full utf-8 encoding (internal default since CakePHP 3.6).
             */
            //'encoding' => 'utf8mb4',
            'timezone' => 'UTC',
            'flags' => [],
            'cacheMetadata' => true,
            'log' => false,
...
```

在数据库实例完成启动时，请绑定已更新的应用程序并将其部署于环境：

**更新 Elastic Beanstalk 环境**

1. 创建源包：

   ```
   ~/eb-cake$ zip ../cake-v2-rds.zip -r * .[^.]* -x "vendor/*"
   ```

1. 打开 [Elastic Beanstalk](https://console.aws.amazon.com/elasticbeanstalk) 控制台，然后**在 “区域” 列表中，选择您**的。 AWS 区域

1. 在导航窗格中，选择 **Environments**（环境），然后从列表中选择环境的名称。

1. 选择 **Upload and Deploy**。

1. 选择 **Browse**（浏览），然后上传 `cake-v2-rds.zip`。

1. 选择**部署**。

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

![\[Green checkmark icon indicating successful database connection for CakePHP.\]](http://docs.aws.amazon.com/zh_cn/elasticbeanstalk/latest/dg/images/php-cakephp-defaultwdb.png)


## 清理
<a name="php-cakephp-tutorial-cleanup"></a>

演示代码使用完毕后，您可以终止环境。[Elastic Beanstalk 会删除 AWS 所有相关资源，[例如 EC2 亚马逊](using-features.managing.ec2.md)[实例、数据库实例、](using-features.managing.db.md)负载均衡器[、安全组](using-features.managing.elb.md)和警报。](using-features.alarms.md#using-features.alarms.title)

移除资源不会删除 Elastic Beanstalk 应用程序，因此您可以随时为您的应用程序创建新环境。

**从控制台终止 Elastic Beanstalk 环境**

1. 打开 [Elastic Beanstalk](https://console.aws.amazon.com/elasticbeanstalk) 控制台，然后**在 “区域” 列表中，选择您**的。 AWS 区域

1. 在导航窗格中，选择 **Environments**（环境），然后从列表中选择环境的名称。

1. 选择 **Actions**（操作），然后选择 **Terminate environment**（终止环境）。

1. 使用屏幕上的对话框确认环境终止。

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

**终止您的 RDS 数据库实例**

1. 打开 [Amazon RDS 控制台](https://console.aws.amazon.com/rds)。

1. 选择 **Databases**（数据库）。

1. 选择您的数据库实例。

1. 选择**操作**，然后选择**删除**。

1. 选择是否创建快照，然后选择**删除**。

## 后续步骤
<a name="php-cakephp-tutorial-nextsteps"></a>

如需了解有关 CakePHP 的更多信息，请访问 [book.cakephp.org](http://book.cakephp.org/4.0/en/index.html)，阅读书籍。

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

在 Elastic Beanstalk 环境中运行 Amazon RDS 数据库实例不仅适合开发和测试，还将数据库的生命周期与环境相关联。请参阅[将 Amazon RDS DB 实例添加到 PHP Elastic Beanstalk 环境](create_deploy_PHP.rds.md)，浏览有关连接到在环境外运行的数据库的说明。

最后，如果计划在生产环境中使用应用程序，您会希望为环境[配置自定义域名](customdomains.md)，并为安全连接[启用 HTTPS](configuring-https.md)。