將 Laravel 應用程式部署至 Elastic Beanstalk

Laravel 是 的開放原始碼 model-view-controller（MVC） 架構PHP。本教學課程將逐步引導您產生 Laravel 應用程式、將其部署到 AWS Elastic Beanstalk 環境，以及將其設定為連線至 Amazon Relational Database Service （Amazon RDS） 資料庫執行個體。

必要條件

本教學假設您具備基本的 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平台並接受預設設定和範例程式碼。

使用大約需要五分鐘時間建立環境，並且建立下列資源：

這些資源全都由 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 SQLSQLServer、 或 PostgreSQL 資料庫搭配 Laravel。在此範例中，我們將使用我的 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();
...

資料庫執行個體啟動完成時，請封裝更新後的應用程式，並將其部署至您的環境。

部署應用程式的新版本不會超過一分鐘。部署完成時，請重新整理網頁，確認資料庫連線成功：

清除

當您完成使用 Elastic Beanstalk 時，即可終止您的環境。Elastic Beanstalk 會終止與環境相關聯的所有 AWS 資源，例如 Amazon EC2執行個體 、資料庫執行個體 、負載平衡器 、安全群組和警示 。

您可以使用 Elastic Beanstalk，隨時輕鬆地為您的應用程式建立新環境。

此外，您可終止於 Elastic Beanstalk 環境外建立的資料庫資源。當您終止 Amazon RDS 資料庫執行個體時，您可以拍攝快照，稍後再將資料還原至另一個執行個體。

後續步驟

有關 Laravel 的詳細資訊，請訪問 Laravel 官方網站，laravel.com。

隨著您繼續開發應用程式，您可能會希望無須手動建立 .zip 檔案並將其上傳至 Elastic Beanstalk 主控台，即可管理環境和部署應用程式。Elastic Beanstalk 命令列介面 （EB CLI） 提供 easy-to-use從命令列建立、設定和部署應用程式至 Elastic Beanstalk 環境的命令。

在本教學中，您使用 Elastic Beanstalk 主控台來設定 Composer 選項。為了讓此組態成為應用程式原始碼的一部分，您的，您可以使用組態檔，如下所示。

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

如需詳細資訊，請參閱使用組態檔案 (.ebextensions) 來進行進階的環境自訂。

在 Elastic Beanstalk RDS 環境中執行 Amazon 資料庫執行個體非常適合進行開發和測試，但它將資料庫的生命週期與您的環境相關聯。如需連接至在環境外執行的資料庫的說明，請參閱 將 Amazon RDS 數據庫實例添加到您的 E PHP lastic Beanstalk 環境。

最後，如果您計劃在生產環境中使用應用程式，則需要為環境設定自訂網域名稱，並啟用 HTTPS 以進行安全連線。