在 Azure App 服務中建立 PHP Web 應用程式

發行項
02/01/2024

警告

Windows 上的 PHP 於 2022 年 11 月達到生命周期結束，且僅支援 Linux 上的 App Service。本文僅供參考。.

Azure App Service 提供可高度調整且自我修補的虛擬主機服務。本快速入門教學課程示範如何將 PHP 應用程式部署至 Windows 上的 Azure App 服務。

您可以在 Cloud Shell 中使用 Azure CLI 建立 Web 應用程式，並使用 Git 將範例 PHP 程式代碼部署至 Web 應用程式。

Sample app running in Azure

您可以使用 Mac、Windows 或 Linux 計算機遵循這裡的步驟。安裝必要條件之後，大約需要五分鐘的時間才能完成這些步驟。

如果您沒有 Azure 訂用帳戶，請在開始之前先建立 Azure 免費帳戶。

注意

在 2022 年 11 月 28 日之後，PHP 僅支援 Linux 上的 App Service。

必要條件

若要完成本快速入門：

在本機下載範例

在終端機視窗中，執行下列命令。它會將範例應用程式複製到本機計算機，並流覽至包含範例程式代碼的目錄。
```
git clone https://github.com/Azure-Samples/php-docs-hello-world
cd php-docs-hello-world
```
請確定預設分支為 main。
```
git branch -m main
```
提示

App Service 不需要變更分支名稱。不過，由於許多存放庫將預設分支變更為 main，本快速入門也會示範如何從 main部署存放庫。

在本機執行應用程式

在本機執行應用程式，以便在您將應用程式部署至 Azure 時，查看其外觀。開啟終端機視窗，並使用 php 命令啟動內建 PHP 網頁伺服器。
```
php -S localhost:8080
```
開啟網頁瀏覽器，然後瀏覽至位於 http://localhost:8080的範例應用程式。

您會看到頁面所顯示範例應用程式的 Hello World！ 訊息。
在您的終端機視窗中，按 Ctrl+C 結束網頁伺服器。

Azure Cloud Shell

Azure Cloud Shell 是裝載於 Azure 中的互動式殼層環境，可在瀏覽器中使用。您可以使用 Bash 或 PowerShell 搭配 Cloud Shell，與 Azure 服務共同使用。您可以使用 Cloud Shell 預先安裝的命令，執行本文提到的程式碼，而不必在本機環境上安裝任何工具。

要啟動 Azure Cloud Shell：

選項	範例/連結
選取程式碼或命令區塊右上角的 [試試看]。選取 [試試看] 並不會自動將程式碼或命令複製到 Cloud Shell 中。
請前往 https://shell.azure.com，或選取 [啟動 Cloud Shell] 按鈕，在瀏覽器中開啟 Cloud Shell。
選取 Azure 入口網站右上方功能表列上的 [Cloud Shell] 按鈕。

若要使用 Azure Cloud Shell：

啟動 Cloud Shell。
選取程式碼區塊 (或命令區塊) 上的 [複製] 按鈕以複製程式碼或命令。
透過在 Windows 和 Linux 上選取 Ctrl+Shift+V；或在 macOS 上選取 Cmd+Shift+V，將程式碼或命令貼到 Cloud Shell 工作階段中。
選取 Enter 鍵執行程式碼或命令。

設定部署使用者

FTP 和本機 Git 可以使用部署使用者部署至 Azure Web 應用程式。設定部署用戶之後，即可將其用於所有 Azure 部署。您的帳戶層級部署使用者名稱和密碼與您的 Azure 訂用帳戶認證不同。

若要設定部署使用者，請在 Azure Cloud Shell 中執行 az webapp deployment user set 命令。將使用者>名稱和<密碼>取代<為部署使用者名稱和密碼。

用戶名稱在 Azure 內必須是唯一的，而且對於本機 Git 推送，不得包含『@』符號。
密碼長度必須至少為八個字元，且下列三個元素有兩個：字母、數位和符號。

az webapp deployment user set --user-name <username> --password <password>

JSON 輸出會將密碼顯示為 null。如果您收到 'Conflict'. Details: 409 錯誤，請變更用戶名稱。如果您收到 'Bad Request'. Details: 400 錯誤，請使用更強的密碼。

記錄您的使用者名稱和密碼，以用來部署 Web 應用程式。

建立資源群組

資源群組是一個邏輯容器，其中會部署和管理 Azure 資源，例如 Web 應用程式、資料庫和記憶體帳戶。例如，您可以選擇稍後在一個簡單的步驟中刪除整個資源群組。

在 Cloud Shell 中，使用 az group create 命令建立資源群組。下列範例會在西歐位置建立名為 myResourceGroup 的資源群組。若要查看免費層中 App Service 的所有支援位置，請執行 az appservice list-locations --sku FREE 命令。

az group create --name myResourceGroup --location "West Europe"

您通常會在附近的區域中建立您的資源群組和資源。

當命令完成時，JSON 輸出會顯示資源群組屬性。

建立 Azure App Service 方案

在 Cloud Shell 中，使用 az appservice plan create 命令建立 App Service 方案。

下列範例會在免費定價層中建立名為 myAppServicePlan 的 App Service 方案：

az appservice plan create --name myAppServicePlan --resource-group myResourceGroup --sku FREE --is-linux

建立 App Service 方案之後，Azure CLI 會顯示類似下列範例的資訊：

{ 
  "freeOfferExpirationTime": null,
  "geoRegion": "West Europe",
  "hostingEnvironmentProfile": null,
  "id": "/subscriptions/0000-0000/resourceGroups/myResourceGroup/providers/Microsoft.Web/serverfarms/myAppServicePlan",
  "kind": "linux",
  "location": "West Europe",
  "maximumNumberOfWorkers": 1,
  "name": "myAppServicePlan",
  < JSON data removed for brevity. >
  "targetWorkerSizeId": 0,
  "type": "Microsoft.Web/serverfarms",
  "workerTierName": null
}

建立 Web 應用程式

在 Cloud Shell 中，使用 az webapp create 命令在 myAppServicePlan App Service 方案中建立 Web 應用程式。

在下列範例中，將取代 <app-name> 為全域唯一的應用程式名稱（有效字元為 a-z、 0-9和 -。執行時間設定為 PHP|7.4。若要檢視所有支援的執行時間，請執行 az webapp list-runtimes。
```
az webapp create --resource-group myResourceGroup --plan myAppServicePlan --name <app-name> --runtime 'PHP|8.1' --deployment-local-git
```
建立 Web 應用程式後，Azure CLI 會顯示類似下列範例的輸出：
```
 Local git is configured with url of 'https://<username>@<app-name>.scm.azurewebsites.net/<app-name>.git'
 {
   "availabilityState": "Normal",
   "clientAffinityEnabled": true,
   "clientCertEnabled": false,
   "cloningInfo": null,
   "containerSize": 0,
   "dailyMemoryTimeQuota": 0,
   "defaultHostName": "<app-name>.azurewebsites.net",
   "enabled": true,
   < JSON data removed for brevity. >
 }
 
```
您已建立空白的新 Web 應用程式，並已啟用 Git 部署。

注意

Git 遠端的網址會顯示在屬性中 deploymentLocalGitUrl ，格式為 https://<username>@<app-name>.scm.azurewebsites.net/<app-name>.git。請稍後視需要儲存此 URL。
流覽至新建立的 Web 應用程式。將 app-name> 取代<為您在上一個步驟中建立的唯一應用程式名稱。
```
http://<app-name>.azurewebsites.net
```
以下是新 Web 應用程式的外觀：

從 Git 推送至 Azure

由於您要部署 main 分支，因此您必須將App Service 應用程式的預設部署分支設定為 main （請參閱變更部署分支）。在 Cloud Shell 中，使用 az webapp config appsettings set 命令設定DEPLOYMENT_BRANCH應用程式設定。
```
az webapp config appsettings set --name <app-name> --resource-group myResourceGroup --settings DEPLOYMENT_BRANCH='main'
```
回到本機終端視窗，將 Azure 遠端新增至本機 Git 存放庫。將 deploymentLocalGitUrl-from-create-step> 取代<為您從建立 Web 應用程式儲存的 Git 遠端 URL。
```
git remote add azure <deploymentLocalGitUrl-from-create-step>
```
使用下列命令推送至 Azure 遠端以部署您的應用程式。當 Git 認證管理員提示您輸入認證時，請務必輸入您在設定部署使用者中建立的認證，而不是您用來登入 Azure 入口網站的認證。
```
git push azure main
```
執行此命令可能會需要花費幾分鐘。執行時會顯示類似下列範例的資訊：

  Counting objects: 2, done.
  Delta compression using up to 4 threads.
  Compressing objects: 100% (2/2), done.
  Writing objects: 100% (2/2), 352 bytes | 0 bytes/s, done.
  Total 2 (delta 1), reused 0 (delta 0)
  remote: Updating branch 'main'.
  remote: Updating submodules.
  remote: Preparing deployment for commit id '25f18051e9'.
  remote: Generating deployment script.
  remote: Running deployment command...
  remote: Handling Basic Web Site deployment.
  remote: Kudu sync from: '/home/site/repository' to: '/home/site/wwwroot'
  remote: Copying file: '.gitignore'
  remote: Copying file: 'LICENSE'
  remote: Copying file: 'README.md'
  remote: Copying file: 'index.php'
  remote: Ignoring: .git
  remote: Finished successfully.
  remote: Running post deployment command(s)...
  remote: Deployment successful.
  To https://<app-name>.scm.azurewebsites.net/<app-name>.git
      cc39b1e..25f1805  main -> main

瀏覽至應用程式

使用網頁瀏覽器流覽至已部署的應用程式。

http://<app-name>.azurewebsites.net

PHP 範例程式代碼正在 Azure App 服務 Web 應用程式中執行。

Sample app running in Azure

恭喜！ 您已將第一個 PHP 應用程式部署至 App Service。

在本機更新並重新部署程序代碼

使用本機文字編輯器，在 PHP 應用程式中開啟 index.php 檔案，然後對旁 echo字串內的文字進行小變更：
```
echo "Hello Azure!";
```
在本機終端機視窗中，認可 Git 中的變更，然後將程式代碼變更推送至 Azure。
```
git commit -am "updated output"
git push azure main
```
部署完成後，返回在瀏覽至應用程式步驟期間開啟的瀏覽器視窗，然後重新整理頁面。

管理新的 Azure 應用程式

移至 Azure 入口網站來管理您所建立的 Web 應用程式。搜尋並選取 [應用程式服務]。
選取 Azure 應用程式的名稱。

將會顯示 Web 應用程式的 [概觀 ] 頁面。在這裡，您可以執行基本管理工作，例如流覽、停止、 重新啟動和刪除。

Web 應用程式功能表提供不同的選項來設定您的應用程式。

清除資源

在上述步驟中，您已建立資源群組中的 Azure 資源。如果您未來不需要這些資源，請在 Cloud Shell 中執行下列命令來刪除資源群組：

az group delete --name myResourceGroup

此命令可能需要一分鐘的時間才能執行。

Azure App Service 提供可高度調整且自我修補的虛擬主機服務。本快速入門說明如何將 PHP 應用程式部署至 Linux 上的 Azure App 服務。

Screenshot of the sample app running in Azure.

您可以使用 Mac、Windows 或 Linux 計算機遵循這裡的步驟。安裝必要條件之後，大約需要五分鐘的時間才能完成這些步驟。

若要完成本快速入門，您需要：

具有有效訂用帳戶的 Azure 帳戶。免費建立帳戶。
Git
PHP
Azure CLI 以在任何殼層中執行命令，以建立和設定 Azure 資源。

您可以在 Cloud Shell 中使用 Azure CLI 建立 Web 應用程式，並使用 Git 將範例 PHP 程式代碼部署至 Web 應用程式。

在終端機視窗中，執行下列命令，將範例應用程式複製到本機計算機，並流覽至專案根目錄。
```
git clone https://github.com/Azure-Samples/php-docs-hello-world
cd php-docs-hello-world
```
若要在本機執行應用程式，請使用 php 命令啟動內建 PHP 網頁伺服器。
```
php -S localhost:8080
```
流覽至網頁瀏覽器中的範例應用程式 http://localhost:8080 。
在您的終端機視窗中，按 Ctrl+C 結束網頁伺服器。

2 - 將應用程式程式代碼部署至 Azure

Azure CLI
入口網站

Azure CLI 有一個命令 az webapp up ，可建立必要的資源，並在單一步驟中部署您的應用程式。

在終端機中，使用 az webapp up 命令在您的本機資料夾中部署程式代碼：

az webapp up --runtime "PHP:8.2" --os-type=linux

az如果無法辨識命令，請確定您已安裝 Azure CLI。
自 --runtime "PHP:8.2" 變數會使用 PHP 8.2 版建立 Web 應用程式。
自--os-type=linux變數會在 Linux 上的 App Service 上建立 Web 應用程式。
您可以選擇性地使用自變數 --name <app-name>來指定名稱。如果您沒有提供名稱，則會自動產生名稱。
您可以選擇性地包含自變數 --location <location-name> ，其中 <location_name> 是可用的 Azure 區域。您可以執行 az account list-locations 命令來擷取 Azure 帳戶允許的區域清單。
如果您看到錯誤「無法自動偵測應用程式的運行時間堆疊」，請確定您是在程式代碼目錄中執行命令（請參閱針對 az webapp up 的自動偵測問題進行疑難解答）。

此命令需要幾分鐘的時間才能完成。執行時，它會提供建立資源群組、App Service 方案和應用程式資源、設定記錄，以及執行 ZIP 部署的相關訊息。接著會提供訊息：「您可以在 azure 上的應用程式 URL http://< app-name.azurewebsites.net> 啟動應用程式。

The webapp '<app-name>' doesn't exist
Creating Resource group '<group-name>' ...
Resource group creation complete
Creating AppServicePlan '<app-service-plan-name>' ...
Creating webapp '<app-name>' ...
Configuring default logging for the app, if not already enabled
Creating zip with contents of dir /home/msangapu/myPhpApp ...
Getting scm site credentials for zip deployment
Starting zip deployment. This operation can take a while to complete ...
Deployment endpoint responded with status code 202
You can launch the app at http://<app-name>.azurewebsites.net
{
  "URL": "http://<app-name>.azurewebsites.net",
  "appserviceplan": "<app-service-plan-name>",
  "location": "centralus",
  "name": "<app-name>",
  "os": "linux",
  "resourcegroup": "<group-name>",
  "runtime_version": "php|8.2",
  "runtime_version_detected": "0.0",
  "sku": "FREE",
  "src_path": "//home//msangapu//myPhpApp"
}

注意

az webapp up 命令會執行下列動作：

建立預設資源群組。
建立預設的 App Service 方案。
建立具有指定名稱的應用程式。
Zip 會從目前的工作目錄部署所有檔案，並啟用組建自動化。
在 .azure/config 檔案中本機快取參數，以便在稍後使用 az webapp up 或其他 az webapp 命令從項目資料夾部署時，不需要再次指定參數。預設會自動使用快取的值。

在網頁瀏覽器中瀏覽至已部署的應用程式，網址 http://<app-name>.azurewebsites.net為。

登入 Azure 入口網站。
在入口網站頂端，在搜尋方塊中輸入 應用程式服務 。在 [服務] 底下，選取 [應用程式服務]。
在 [ 應用程式服務] 頁面中，選取 [ + 建立]。
在 [基本] 索引標籤中：
- 在 [資源群組] 下，選取 [新建]。輸入 myResourceGroup 作為名稱。
- 在 [名稱] 底下，輸入 Web 應用程式的全域唯一名稱。
- 在 [發佈] 底下，選取 [程序代碼]。
- 在 [運行時間堆棧] 下，選取 [PHP 8.2]。
- 在 [操作系統] 底下，選取 [Linux]。
- 在 [區域] 下，選取靠近您的 Azure 區域。
- 在 [App Service 方案] 底下，建立名為 myAppServicePlan 的 App Service 方案。
- 在 [定價方案] 底下，選取 [免費 F1]。
選取頁面頂端的 [部署] 索引標籤。
在 [GitHub Actions] 設定下，將 [持續部署] 設定為 [啟用]。
在 [GitHub Actions 詳細數據] 底下，使用您的 GitHub 帳戶進行驗證，然後選取下列選項：
- 針對 [ 組織 ] 選取您派生示範項目的組織。
- 針對 [ 存放庫 ] 選取 php-docs-hello-world 專案。
- 針對 [分支] 選取 [主要]。
注意

根據預設，建立精靈會停用基本身份驗證，並使用使用者指派的身分識別來建立 GitHub Actions 部署。如果您在資源建立期間收到許可權錯誤，您的 Azure 帳戶可能沒有足夠的許可權。您稍後可以使用 Azure 系統管理員為您產生的身分識別來設定 GitHub Actions 部署，也可以改為啟用基本身份驗證。
選取頁面底部的 [檢閱 + 建立] 按鈕。
驗證執行之後，選取頁面底部的 [ 建立] 按鈕。
部署完成後，請選取 [移至資源]。
在網頁瀏覽器中瀏覽至已部署的應用程式，網址 http://<app-name>.azurewebsites.net為。

PHP 範例程式代碼正在 Azure App 服務中執行。

Screenshot of the sample app running in Azure, showing 'Hello World!'.

恭喜！ 您已使用 Azure 入口網站，將第一個 PHP 應用程式部署至 App Service。

3 - 更新並重新部署應用程式

Azure CLI
入口網站

使用本機文字編輯器，在 PHP 應用程式中開啟 index.php 檔案，然後對旁 echo字串內的文字進行小變更：
```
echo "Hello Azure!";
```
儲存您的變更，然後使用 az webapp up 命令重新部署應用程式，並搭配下列自變數：
```
az webapp up --runtime "PHP:8.2" --os-type=linux
```
部署完成後，返回在瀏覽至應用程式步驟期間開啟的瀏覽器視窗，然後重新整理頁面。

流覽至 php-docs-hello-world 的 GitHub 分支。
在存放庫頁面上，按 . 以在瀏覽器中啟動Visual StudioCode。

注意

URL 會從 GitHub.com 變更為 GitHub.dev。此功能僅適用於具有檔案的存放庫。這不適用於空白存放庫。
編輯 index.php ，使其顯示 “Hello Azure！” 而不是 “Hello World！”
```
<?php
    echo "Hello Azure!";
?>
```
從 [ 原始檔控制] 功能表中，選取 [階段變更 ] 按鈕來暫存變更。
輸入認可訊息，例如 Hello Azure。然後，選取 [認可] 和 [ 推送]。
部署完成後，返回在瀏覽至應用程式步驟期間開啟的瀏覽器視窗，然後重新整理頁面。

4 - 管理新的 Azure 應用程式

移至 Azure 入口網站以管理您建立的 Web 應用程式。搜尋並選取 [應用程式服務]。
選取 Azure 應用程式的名稱。

應該會顯示 Web 應用程式的 [概觀 ] 頁面。在這裡，您可以執行基本管理工作，例如流覽、停止、 重新啟動和刪除。

Web 應用程式功能表提供不同的選項來設定您的應用程式。