指定依附元件

在您部署新版本的應用程式時，Composer 會自動執行。只要在 PHP 指令碼頂端新增下列程式碼，即可要求 autoload.php 檔案：

require_once __DIR__ . '/vendor/autoload.php';

Composer 會將套件新增至應用程式的 vendor/ 目錄，並在該目錄中產生 autoload.php 檔案。Composer 自動載入器會自動載入 Composer 安裝的類別，而不需要為每個檔案提供 require 陳述式。

根據預設，系統會在產生的 .gcloudignore 檔案中忽略 vendor/ 目錄，藉此減少部署作業中傳送的檔案數量。

您可以在標準 composer.json 檔案中宣告 PHP 適用的依附元件。例如：

{
    "require": {
        "google/cloud": "^0.72"
    }
}

您可以在 App Engine 中使用任何 Linux 相容的 PHP 套件，執行階段會在應用程式的來源目錄中尋找 composer.json 檔案，並在啟動應用程序前使用 composer 安裝任何依附元件。

如果 Composer 可以使用快取結果，composer.json 檔案中定義的指令碼就不會執行。

根據預設，App Engine 會快取已擷取的依附元件以減少建構時間。如果依附元件需要安裝未經快取的版本，請使用下列指令：

gcloud app deploy --no-cache

在本機安裝和執行

使用 composer 在本機安裝依附元件：

composer install
如要將依附元件固定為其目前版本，請將 composer.lock 檔案提交至您的應用程式。

您可以使用自己選擇的網路伺服器來測試自己的應用程式，如要快速執行應用程式，您可以使用 PHP 內建的網路伺服器。

安裝網路架構

根據預設，App Engine 會透過 public/index.php 或 index.php 檔案提供所有要求。雖然架構並非必要，但仍鼓勵使用。您可以將任何網路架構與 App Engine 搭配使用，其中包括：

安裝 Cloud 用戶端程式庫

PHP 適用的 Google Cloud 用戶端程式庫是用來存取 Google Cloud 服務的用戶端程式庫，可減少您必須重新撰寫的樣板程式碼。這個程式庫提供了易於理解的高階 API 抽象層級，運用 PHP 的用語，可與標準程式庫良好地搭配運作，並且能與您的程式碼基底緊密整合，綜合以上可讓您投注更多時間在重要程式碼的開發工作上。

  1. 在本機安裝程式庫：

    composer require google/cloud

  2. 您可以使用 Google Cloud CLI 在本機處理驗證程序。如果您想讓本機應用程式暫時使用自己的使用者憑證存取 API，請執行以下指令：

    gcloud auth application-default login

    如要進一步瞭解如何設定 PHP 適用的 Cloud 用戶端程式庫，以便自動處理驗證作業，請參閱「使用用戶端程式庫對 Cloud 服務進行驗證」。

使用私人存放區

如要在私人存放區中使用程式庫，您必須完成下列工作：

  • 設定存放區。
  • 提供密鑰給 composer 以便存取私人存放區。

以下範例說明如何在 GitHub 中存取私人存放區。

  1. 使用 vcs 做為類型，在 composer.json 中設定存放區：

    "repositories": [
    {
        "type": "vcs",
        "url": "https://github.com/username/private_package"
    }
]

  2. 在專案的根目錄中建立名為「auth.json」的檔案：

    {
    "github-oauth": {
        "github.com": "<your-github-auth-token>"
    }
}

您可以從 GitHub 管理 UI 取得 GitHub 驗證憑證。

以下另一個範例說明如何讓 Bitbucket 存取私人存放區。

  1. 使用 vcs 做為類型，在 composer.json 中設定存放區：

    "repositories": [
    {
        "type": "vcs",
        "url":  "https://bitbucket.org/username/private_git"
    }
]

  2. 在專案的根目錄中建立名為「auth.json」的檔案：

    {
    "bitbucket-oauth": {
        "bitbucket.org": {
            "consumer-key": "<your-oauth-consumer-key>",
            "consumer-secret": "<your-oauth-consumer-secret>"
        }
    }
}