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

發行項
06/13/2024

警告

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

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

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

在 Azure 中執行的範例應用程式

您可以使用 Mac、Windows 或 Linux 機器，依照此處的步驟操作。安裝先決條件後，大約需要 5 分鐘才能完成這些步驟。

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

注意

2022 年 11 月 28 日之後，只有 Linux 上的 App Service 才支援 PHP。

必要條件

若要完成本快速入門：

將範例下載到本機

在終端機視窗中，執行下列命令。它會將應用程式範例複製到本機電腦，並瀏覽至包含範例程式碼的目錄。
```
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 Web 伺服器。
```
php -S localhost:8080
```
開啟網頁瀏覽器，然後巡覽至位於 http://localhost:8080 的範例應用程式。

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

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 命令。將 <username> 和 <password> 取代為部署使用者的使用者名稱和密碼。

使用者名稱在 Azure 服務及本機 Git 推送中都必須是唯一的，且不能包含 ‘@’ 符號。
密碼長度必須至少為 8 個字元，包含下列三個元素其中兩個：字母、數字及符號。

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 應用程式。

在下列範,了中，使用全域唯一的應用程式名稱 (有效的字元為 a-z、0-9 和 -) 取代 <app-name>。執行階段設定為 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 遠端的 URL 會顯示在 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

瀏覽至應用程式

使用 web 瀏覽器瀏覽至已部署的應用程式。

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

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

在 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 Service。

此螢幕擷取畫面顯示正在 Azure 執行的範例應用程式。

您可以使用 Mac、Windows 或 Linux 機器，依照此處的步驟操作。安裝先決條件後，大約需要 5 分鐘才能完成這些步驟。

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

具有有效訂用帳戶的 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 Web 服務器。
```
php -S localhost:8080
```
在網路瀏覽器中前往位於 http://localhost:8080 的應用程式範例。
在終端機視窗中，按 Ctrl+C 結束 web 伺服器。

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 部署。接著會提供「您可以在 http://<app-name>.azurewebsites.net 啟動應用程式」的訊息，這是 Azure 上應用程式的 URL。

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 命令進行部署時再次加以指定。預設會自動使用快取的值。

使用網頁瀏覽器瀏覽至已部署的應用程式 (URL 為 http://<app-name>.azurewebsites.net)。

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

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

PHP 範例程式碼正在 Azure App Service 中執行。

此螢幕擷取畫面顯示正在 Azure 中執行的範例應用程式，其中顯示 '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 Studio Code。

注意

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

4 - 管理新的 Azure 應用程式

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

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

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