Azure App Service に PHP Web アプリを作成する

[アーティクル]
01/26/2024

警告

Windows 上の PHP は 2022 年 11 月にサポート終了となり、App Service on Linux でのみサポートされています。この記事は参照専用です。。

Azure App Service は、非常にスケーラブルな、自己適用型の Web ホスティングサービスを提供します。このクイックスタートチュートリアルでは、Azure App Service on Windows に PHP アプリをデプロイする方法を説明します。

Azure CLI を使って Cloud Shell で Web アプリを作成し、Git を使用して Web アプリに PHP のサンプルコードをデプロイします。

Azure で実行されるサンプルアプリ

以下の手順は、Mac、Windows、または Linux コンピューターを使って実行できます。前提条件のインストールを終えてから、以降の手順を完了するまでに約 5 分かかります。

Azure サブスクリプションをお持ちでない場合は、開始する前に Azure 無料アカウントを作成してください。

注意

2022 年 11 月 29 日以降、PHP は App Service on Linux でのみサポートされます。

前提条件

このクイックスタートを完了するには、以下が必要です。

サンプルをローカルでダウンロードする

ターミナルウィンドウで次のコマンドを実行します。これにより、サンプルアプリケーションがローカルマシンに複製され、サンプルコードを含むディレクトリに移動します。
```
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
```
Web ブラウザーを開き、http://localhost:8080 のサンプルアプリに移動します。

ページに表示されているサンプルアプリの Hello World! メッセージが表示されます。
ターミナルウィンドウで Ctrl + C キーを押して、Web サーバーを終了します。

Azure Cloud Shell

Azure では、ブラウザーを介して使用できる対話型のシェル環境、Azure Cloud Shell がホストされています。 Cloud Shell で Bash または PowerShell を使用して、Azure サービスを操作できます。ローカル環境に何もインストールしなくても、Cloud Shell にプレインストールされているコマンドを使用して、この記事のコードを実行できます。

Azure Cloud Shell を開始するには、以下のようにします。

オプション	例とリンク
コードまたはコマンドブロックの右上隅にある [使ってみる] を選択します。 [使ってみる] を選択しても、コードまたはコマンドは Cloud Shell に自動的にはコピーされません。
https://shell.azure.com に移動するか、[Cloud Shell を起動する] ボタンを選択して、ブラウザーで Cloud Shell を開きます。
Azure portal の右上にあるメニューバーの [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 文字以上で、文字、数字、記号のうち 2 つを含む必要があります。

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

JSON 出力には、パスワードが null として表示されます。 'Conflict'. Details: 409 エラーが発生した場合は、ユーザー名を変更します。 'Bad Request'. Details: 400 エラーが発生した場合は、より強力なパスワードを使用します。

Web アプリのデプロイに使用するユーザー名とパスワードを記録します。

リソースグループを作成する

リソースグループとは、Web アプリ、データベース、ストレージアカウントなどの Azure リソースのデプロイと管理に使用する論理コンテナーです。たとえば、後から簡単な手順で一度にリソースグループ全体を削除することもできます。

Cloud Shell で az group create コマンドを使用して、リソースグループを作成します。次の例では、myResourceGroup という名前のリソースグループを "西ヨーロッパ" の場所に作成します。 Free レベルの 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 価格レベルの 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. >
 }
 
```
Git デプロイが有効な、空の新しい Web アプリが作成されました。

Note

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 に設定する必要があります (「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'
```
ローカルターミナルウィンドウで、ローカル Git リポジトリに Azure リモートを追加します。 <deploymentLocalGitUrl-from-create-step>を、「Web アプリを作成する」で保存した Git リモートの URL に置き換えます。
```
git remote add azure <deploymentLocalGitUrl-from-create-step>
```
アプリをデプロイするために、次のコマンドで Azure リモートにプッシュします。 Git Credential Manager で資格情報の入力を求められたら、Azure portal へのサインインに使用する資格情報ではなく、「ローカル Git デプロイを構成する」で作成した資格情報を入力してください。
```
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 で実行されるサンプルアプリ

おめでとうございます。 App Service に初めての PHP アプリをデプロイしました。

コードをローカルで更新して再デプロイする

ローカルのテキストエディターを使用して、PHP アプリ内の index.php ファイルを開き、echo に続く文字列の中のテキストを少し変更します。
```
echo "Hello Azure!";
```
ローカルターミナルウィンドウで、変更を Git にコミットし、コード変更を Azure にプッシュします。
```
git commit -am "updated output"
git push azure main
```
デプロイが完了したら、「アプリの参照」の手順で開いたブラウザーウィンドウに戻り、ページを更新します。

新しい Azure アプリの管理

Azure Portal に移動し、作成した Web アプリを管理します。 [App Services] を検索して選択します。
使用する Azure アプリの名前を選択します。

Web アプリの [概要] ページが表示されます。ここでは、参照、停止、再開、削除のような基本的な管理タスクを行うことができます。

Web アプリメニューに、アプリを構成するためのさまざまなオプションが示されます。

リソースをクリーンアップする

前の手順では、リソースグループ内に Azure リソースを作成しました。これらのリソースが将来必要になると想定していない場合、Cloud Shell で次のコマンドを実行して、リソースグループを削除します。

az group delete --name myResourceGroup

このコマンドの実行には、少し時間がかかる場合があります。

Azure App Service は、非常にスケーラブルな、自己適用型の Web ホスティングサービスを提供します。このクイックスタートでは、Azure App Service on Linux に PHP アプリをデプロイする方法について説明します。

Azure で実行されているサンプルアプリのスクリーンショット。

このクイックスタートを完了するには、次のものが必要です。

アクティブなサブスクリプションが含まれる Azure アカウント。無料でアカウントを作成できます。
Git
PHP
Azure CLI: これを使用し、任意のシェルでコマンドを実行し、Azure リソースを作成して構成します。

Azure CLI を使って Cloud Shell で Web アプリを作成できます。また、Git を使用して Web アプリに PHP のサンプルコードをデプロイします。

ターミナルウィンドウで、次のコマンドを実行して、ローカルコンピューターにサンプルアプリケーションを複製し、プロジェクトルートに移動します。
```
git clone https://github.com/Azure-Samples/php-docs-hello-world
cd php-docs-hello-world
```
アプリケーションをローカルで実行するには、php コマンドを使用して組み込みの PHP Web サーバーを起動します。
```
php -S localhost:8080
```
Web ブラウザーで http://localhost:8080 のサンプルアプリケーションを参照します。
ターミナルウィンドウで Ctrl + C キーを押して、Web サーバーを終了します。

ブラウザーで、サンプルコードを含むリポジトリに移動します。
右上隅にある [フォーク] を選択します。
[Create a new fork] (新しいフォークの作成) 画面で、[Owner] (所有者) と [Repository name] (リポジトリ名) フィールドを確認します。 [Create fork] (フォークの作成) を選択します。

注意

これにより、新しいフォークに移動します。フォーク URL は https://github.com/YOUR_GITHUB_ACCOUNT_NAME/php-docs-hello-world のようになります。

2 - アプリケーションコードを Azure にデプロイする

Azure CLI
ポータル

Azure CLI の az webapp up コマンドにより、必要なリソースを作成し、1 つの手順でアプリケーションをデプロイできます。

ターミナルで、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 引数により、App Service on Linux で Web アプリが作成されます。
必要に応じて、引数 --name <app-name> を使用して名前を指定することもできます。指定しない場合、名前は自動的に生成されます。
必要に応じて、引数 --location <location-name> を含めることができます。ここで、<location_name> は利用可能な Azure リージョンです。 az account list-locations コマンドを実行すると、お使いの Azure アカウントで使用可能なリージョンの一覧を取得できます。
"Could not auto-detect the runtime stack of your app" (アプリのランタイムスタックを自動検出できませんでした) というエラーが表示された場合は、コードディレクトリでコマンドを実行していることを確認してください (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 デプロイします。
後で az webapp up またはプロジェクトフォルダー内の他の az webapp コマンドを使用してデプロイするときに再指定する必要がないように、パラメーターを .azure/config ファイルにローカルにキャッシュします。キャッシュされた値は、既定で自動的に使用されます。

URL http://<app-name>.azurewebsites.net を使って、お使いの Web ブラウザーでデプロイされたアプリケーションを参照します。

Azure portal にサインインします。
ポータルの上部にある検索ボックスに「app services」と入力します。 [サービス] で、[App Services] を選択します。
[App Services] ページで、[+ Create](+ 作成) を選択します。
[基本] タブを次のように設定します。
- [リソースグループ] で、 [新規作成] を選択します。名前として「myResourceGroup」と入力します。
- [名前] で、グローバルに一意の Web アプリ名を入力します。
- [発行] で [コード] を選択します。
- [ランタイムスタック] で [PHP 8.2] を選択します。
- [オペレーティングシステム] で [Linux] を選択します。
- [リージョン] で、近くの Azure リージョンを選択します。
- [App Service プラン] で myAppServicePlan という名前の App Service プランを作成します。
- [価格プラン] で、[Free F1] を選択します。
ページの上部にある [デプロイ] タブを選択します。
[GitHub Actions の設定] で、[継続的デプロイ] を [有効] に設定します。
[GitHub Actions の詳細] で、GitHub アカウントで認証し、次のオプションを選択します。
- [組織] で、デモプロジェクトをフォークした組織を選択します。
- [リポジトリ] で、[php-docs-hello-world] プロジェクトを選択します。
- [ブランチ] では、[マスター] を選択します。
Note

既定では、作成ウィザードによって基本認証は無効にされ、GitHub Actions のデプロイはユーザー割り当て ID を使用して作成されます。リソースの作成時にアクセス許可エラーが発生する場合は、お使いの Azure アカウントに十分なアクセス許可がない可能性があります。ユーザーの代わりに Azure 管理者が生成した ID を使って後で GitHub Actions のデプロイを構成することができ、代わりに基本認証を有効にすることもできます。
ページの下部にある [確認と作成] ボタンを選択します。
検証の実行後、ページの下部にある [作成] ボタンを選択します。
デプロイが完了したら、[リソースに移動] を選択します。
URL http://<app-name>.azurewebsites.net を使って、お使いの Web ブラウザーでデプロイされたアプリケーションを参照します。

PHP のサンプルコードが、Azure App Service で実行されています。

Azure でサンプルアプリを実行して

お疲れさまでした。 Azure portal を使用して App Service に初めての PHP アプリをデプロイしました。

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 コードを開始します。

注意

URL は GitHub.com から GitHub.dev に変更されます。この機能は、ファイルがあるリポジトリでのみ機能します。これは空のリポジトリでは機能しません。
index.php を編集して、"Hello World!" ではなく "Hello Azure!" と表示されるようにします。
```
<?php
    echo "Hello Azure!";
?>
```
[ソース管理] メニューの [ステージの変更] ボタンを選択して、変更をステージングします。
Hello Azure のようなコミットメッセージを入力します。次に、[コミットしてプッシュ] を選択します。
デプロイが完了したら、「アプリの参照」の手順で開いたブラウザーウィンドウに戻り、ページを更新します。

4 - 新しい Azure アプリを管理する

Azure Portal に移動し、作成した Web アプリを管理します。 「App Services」 を検索して選択します。
使用する Azure アプリの名前を選択します。

Web アプリの [概要] ページが表示されるはずです。ここでは、参照、停止、再開、削除のような基本的な管理タスクを行うことができます。

Web アプリメニューに、アプリを構成するためのさまざまなオプションが示されます。

5 - リソースをクリーンアップする

サンプルアプリを使い終わったら、Azure からアプリのすべてのリソースを削除できます。追加料金の発生が避けられ、Azure サブスクリプションの整合性を維持できます。リソースグループを削除して、リソースグループ内のすべてのリソースも削除することが、アプリのすべての Azure リソースを削除する最も簡単な方法です。

Azure CLI
ポータル

az group delete コマンドでリソースグループを削除します。

az group delete --name myResourceGroup

このコマンドの実行には、少し時間がかかります。

次のステップ

PHP と MySQL

PHP アプリの構成

カスタムドメインと証明書を使用してセキュリティで保護する

次の方法で共有

Azure App Service に PHP Web アプリを作成する

前提条件

サンプルをローカルでダウンロードする

アプリをローカルで実行する

Azure Cloud Shell

デプロイユーザーを構成する

リソースグループを作成する

Azure App Service プランを作成する

Web アプリを作成する

Git から Azure へのプッシュ

アプリの参照

コードをローカルで更新して再デプロイする

新しい Azure アプリの管理

リソースをクリーンアップする

1 - サンプルリポジトリを取得する

2 - アプリケーションコードを Azure にデプロイする

3 - アプリを更新して再デプロイする

4 - 新しい Azure アプリを管理する

5 - リソースをクリーンアップする

次のステップ

フィードバック

その他のリソース

次の方法で共有

Azure App Service に PHP Web アプリを作成する

前提条件

サンプルをローカルでダウンロードする

アプリをローカルで実行する

Azure Cloud Shell

デプロイ ユーザーを構成する

リソース グループを作成する

Azure App Service プランを作成する

Web アプリを作成する

Git から Azure へのプッシュ

アプリの参照

コードをローカルで更新して再デプロイする

新しい Azure アプリの管理

リソースをクリーンアップする

1 - サンプル リポジトリを取得する

2 - アプリケーション コードを Azure にデプロイする

3 - アプリを更新して再デプロイする

4 - 新しい Azure アプリを管理する

5 - リソースをクリーンアップする

次のステップ

フィードバック

その他のリソース

デプロイユーザーを構成する

リソースグループを作成する

1 - サンプルリポジトリを取得する

2 - アプリケーションコードを Azure にデプロイする