Vytvoření webové aplikace PHP ve službě Aplikace Azure Service

Upozorňující

PHP ve Windows dosáhl konce životnosti v listopadu 2022 a je podporován pouze v App Service v Linuxu. Tento článek je určen pouze pro referenci..

Azure App Service je vysoce škálovatelná služba s automatickými opravami pro hostování webů. Tento rychlý úvodní kurz ukazuje, jak nasadit aplikaci PHP do služby Aplikace Azure Service ve Windows.

Pomocí Azure CLI ve službě Cloud Shell vytvoříte webovou aplikaci a pomocí Gitu do této webové aplikace nasadíte vzorový kód PHP.

Tento postup můžete použít v případě počítačů se systémem Mac, Windows nebo Linux. Pokud máte nainstalované všechny požadované prostředky, zabere vám tento postup zhruba pět minut.

Pokud ještě nemáte předplatné Azure, vytvořte si bezplatný účet Azure před tím, než začnete.

Poznámka:

Po 28. listopadu 2022 bude PHP podporováno pouze v App Service v Linuxu.

Požadavky

K provedení kroků v tomto kurzu Rychlý start je potřeba:

• Nainstalovat Git.
• Nainstalovat PHP.

Místní stažení ukázky

1. V okně terminálu spusťte následující příkazy. Naklonuje ukázkovou aplikaci do místního počítače a přejde do adresáře obsahujícího ukázkový kód.

   git clone https://github.com/Azure-Samples/php-docs-hello-world
   cd php-docs-hello-world
   

2. Ujistěte se, že výchozí větev je main.

   git branch -m main
   

   Tip

   App Service nevyžaduje změnu názvu větve. Vzhledem k tomu, že mnoho úložišť mění výchozí větev na main, tento rychlý start také ukazuje, jak nasadit úložiště z main.

Místní spuštění aplikace

1. Spusťte aplikaci místně, abyste viděli, jak by měla vypadat po nasazení do Azure. Otevřete okno terminálu a pomocí příkazu php spusťte integrovaný webový server PHP.

   php -S localhost:8080
   

2. Otevřete webový prohlížeč a přejděte do ukázkové aplikace na adrese http://localhost:8080.

   Zobrazí se zpráva Hello World! z ukázkové aplikace zobrazené na stránce.

   

3. V okně terminálu ukončete webový server stisknutím Ctrl + C.

Azure Cloud Shell

Azure hostí interaktivní prostředí Azure Cloud Shell, které můžete používat v prohlížeči. Pro práci se službami Azure můžete v prostředí Cloud Shell použít buď Bash, nebo PowerShell. Předinstalované příkazy Cloud Shellu můžete použít ke spuštění kódu v tomto článku, aniž byste museli instalovat cokoli do místního prostředí.

Spuštění služby Azure Cloud Shell:

Možnost	Příklad nebo odkaz
Vyberte Vyzkoušet v pravém horním rohu bloku kódu nebo příkazu. Výběrem možnosti Vyzkoušet se kód ani příkaz automaticky nekopíruje do Cloud Shellu.
Přejděte na adresu https://shell.azure.com nebo výběrem tlačítka Spustit Cloud Shell otevřete Cloud Shell v prohlížeči.
Zvolte tlačítko Cloud Shell v pruhu nabídky v pravém horním rohu webu Azure Portal.

Použití Azure Cloud Shellu:

1. Spusťte Cloud Shell.

2. Výběrem tlačítka Kopírovat v bloku kódu (nebo bloku příkazů) zkopírujte kód nebo příkaz.

3. Vložte kód nebo příkaz do relace Cloud Shellu tak, že ve Windows a Linuxu vyberete ctrl+Shift+V nebo vyberete Cmd+Shift+V v macOS.

4. Stisknutím klávesy Enter spusťte kód nebo příkaz.

Konfigurace uživatele nasazení

FTP a místní Git se můžou nasadit do webové aplikace Azure pomocí uživatele nasazení. Jakmile nakonfigurujete uživatele nasazení, můžete ho použít pro všechna nasazení Azure. Uživatelské jméno a heslo nasazení na úrovni účtu se liší od přihlašovacích údajů předplatného Azure.

Pokud chcete nakonfigurovat uživatele nasazení, spusťte příkaz az webapp deployment user set v Azure Cloud Shellu. Nahraďte <uživatelské jméno> a <heslo> uživatelským jménem a heslem pro nasazení.

• Uživatelské jméno musí být v Rámci Azure jedinečné a pro místní zápisy z Gitu nesmí obsahovat symbol @.
• Heslo musí mít alespoň osm znaků, přičemž dva z následujících tří prvků: písmena, číslice a symboly.

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

Výstup JSON zobrazuje heslo jako null. Pokud se zobrazí chyba 'Conflict'. Details: 409, změňte uživatelské jméno. Pokud se zobrazí chyba 'Bad Request'. Details: 400, použijte silnější heslo.

Poznamenejte si uživatelské jméno a heslo, které chcete použít k nasazení webových aplikací.

Vytvoření skupiny zdrojů

Skupina prostředků je logický kontejner, do kterého se nasazují a spravují prostředky Azure, jako jsou webové aplikace, databáze a účty úložiště. Později se například můžete rozhodnout odstranit celou skupinu prostředků v jednom jednoduchém kroku.

Ve službě Cloud Shell vytvořte skupinu prostředků pomocí příkazu az group create. Následující příklad vytvoří skupinu prostředků myResourceGroup v umístění Západní Evropa. Pokud chcete zobrazit všechna podporovaná umístění pro službu App Service na úrovni Free, spusťte příkaz az appservice list-locations --sku FREE.

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

Obvykle budete svoji skupinu prostředků a prostředky vytvářet v oblasti, kterou máte blízko.

Po dokončení příkazu se ve výstupu JSON zobrazí vlastnosti skupiny prostředků.

Vytvoření plánu služby Azure App Service

Ve službě Cloud Shell vytvořte pomocí příkazu az appservice plan create plán služby App Service.

Následující příklad vytvoří plán služby App Service s názvem myAppServicePlan v cenové úrovni Free:

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

Po vytvoření plánu služby App Service se v rozhraní příkazového řádku Azure zobrazí podobné informace jako v následujícím příkladu:

{ 
  "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
} 

Vytvoření webové aplikace

1. Ve službě Cloud Shell pomocí příkazu az webapp create vytvořte v plánu služby App Service myAppServicePlan webovou aplikaci.

   V následujícím příkladu nahraďte <app-name> globálně jedinečným názvem aplikace (platné znaky jsou a-z, 0-9 a -). Modul runtime je nastavený na PHP|7.4. Pokud chcete zobrazit všechny podporované moduly runtime, spusťte příkaz az webapp list-runtimes.

   az webapp create --resource-group myResourceGroup --plan myAppServicePlan --name <app-name> --runtime 'PHP|8.1' --deployment-local-git
   

   Po vytvoření webové aplikace Azure CLI zobrazí výstup podobný následujícímu příkladu:

    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. >
    }
    

   Vytvořili jste prázdnou novou webovou aplikaci s povoleným nasazením Gitu.

   Poznámka:

   Adresa URL vzdáleného úložiště Git se zobrazuje ve vlastnosti deploymentLocalGitUrl ve formátu https://<username>@<app-name>.scm.azurewebsites.net/<app-name>.git. Tuto adresu URL si uložte, protože ji budete potřebovat později.

2. Přejděte do vaší nově vytvořené webové aplikace. Nahraďte <název> aplikace jedinečným názvem aplikace vytvořeným v předchozím kroku.

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

   Nová webová aplikace by měla vypadat takto:

   

Přenos z Gitu do Azure

1. Vzhledem k tomu, že větev nasazujete main , musíte pro aplikaci main App Service nastavit výchozí větev nasazení (viz Změna větve nasazení). V Cloud Shellu DEPLOYMENT_BRANCH nastavte nastavení aplikace pomocí az webapp config appsettings set příkazu.

   az webapp config appsettings set --name <app-name> --resource-group myResourceGroup --settings DEPLOYMENT_BRANCH='main'
   

2. Zpět v okně místního terminálu přidejte vzdálené úložiště Azure do místního úložiště Git. Nahraďte deploymentLocalGitUrl-from-create-step> adresou URL vzdáleného úložiště Git, který jste uložili z vytvoření webové aplikace.<

   git remote add azure <deploymentLocalGitUrl-from-create-step>
   

3. Nasaďte aplikaci do vzdáleného úložiště Azure pomocí následujícího příkazu. Když vás Git Credential Manager vyzve k zadání přihlašovacích údajů, ujistěte se, že jste zadali přihlašovací údaje, které jste vytvořili v konfiguraci místního nasazení Gitu, a ne přihlašovací údaje, které používáte pro přihlášení k webu Azure Portal.

   git push azure main
   

   Spuštění tohoto příkazu může trvat několik minut. Při spuštění příkaz zobrazí podobné informace jako v následujícím příkladu:

  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
  

Přechod do aplikace

V prohlížeči zadejte adresu nasazené aplikace.

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

Vzorový kód PHP je spuštěný ve webové aplikaci služby Azure App Service.

Gratulujeme! Nasadili jste svoji první aplikaci v PHP do služby App Service.

Místní aktualizace a opětovné nasazení kódu

1. Pomocí místního textového editoru otevřete soubor index.php, který je součástí PHP aplikace, a proveďte malou změnu textu v řetězci vedle echo:

   echo "Hello Azure!";
   

2. V místním okně terminálu potvrďte změny v Gitu a potom nasdílejte změny kódu do Azure.

   git commit -am "updated output"
   git push azure main
   

3. Po dokončení nasazení se vraťte do okna prohlížeče, které se otevřelo v kroku Přechod do aplikace, a aktualizujte zobrazení stránky.

   

Správa nové aplikace Azure

1. Pokud chcete spravovat webovou aplikaci, kterou jste vytvořili, přejděte na web Azure Portal. Vyhledejte a vyberte App Services.

   

2. Vyberte název aplikace Azure.

   

   Zobrazí se stránka Přehled vaší webové aplikace. Tady můžete provádět základní úlohy správy, jako je procházení, zastavení, restartování a odstranění.

   

   Nabídka webové aplikace nabízí různé možnosti konfigurace aplikace.

Vyčištění prostředků

V předchozích krocích jste vytvořili prostředky Azure ve skupině prostředků. Pokud předpokládáte, že už tyto prostředky nebudete potřebovat, odstraňte skupinu prostředků spuštěním následujícího příkazu ve službě Cloud Shell:

az group delete --name myResourceGroup

Spuštění tohoto příkazu může trvat přibližně minut.

Azure App Service je vysoce škálovatelná služba s automatickými opravami pro hostování webů. V tomto rychlém startu se dozvíte, jak nasadit aplikaci PHP do služby Aplikace Azure Service v Linuxu.

Tento postup můžete použít v případě počítačů se systémem Mac, Windows nebo Linux. Pokud máte nainstalované všechny požadované prostředky, zabere vám tento postup zhruba pět minut.

K dokončení tohoto rychlého startu je potřeba:

• Účet Azure s aktivním předplatným. Vytvoření účtu zdarma
• Git
• PHP
• Azure CLI ke spouštění příkazů v libovolném prostředí pro vytváření a konfiguraci prostředků Azure

1. Získání ukázkového úložiště

Azure CLI

Webovou aplikaci můžete vytvořit pomocí Azure CLI v Cloud Shellu a pomocí Gitu můžete do webové aplikace nasadit ukázkový kód PHP.

1. V okně terminálu spusťte následující příkazy, které naklonují ukázkovou aplikaci do místního počítače a přejděte do kořenového adresáře projektu.

   git clone https://github.com/Azure-Samples/php-docs-hello-world
   cd php-docs-hello-world
   

2. Pokud chcete aplikaci spustit místně, spusťte php pomocí příkazu integrovaný webový server PHP.

   php -S localhost:8080
   

3. Ve webovém prohlížeči přejděte k ukázkové aplikaci http://localhost:8080 .

   

4. V okně terminálu ukončete webový server stisknutím Ctrl + C.

Azure Portal

1. V prohlížeči přejděte do úložiště obsahujícího ukázkový kód.

2. V pravém horním rohu vyberte Fork.

   

3. Na obrazovce Vytvořit nový fork potvrďte pole Vlastník a Název úložiště. Vyberte Vytvořit fork.

   

Poznámka:

Měli byste přejít na nový fork. Vaše adresa URL forku bude vypadat přibližně takto: https://github.com/YOUR_GITHUB_ACCOUNT_NAME/php-docs-hello-world

2. Nasazení kódu aplikace do Azure

Azure CLI

Azure CLI obsahuje příkaz az webapp up , který vytvoří potřebné prostředky a nasadí vaši aplikaci v jednom kroku.

V terminálu pomocí příkazu nasaďte kód do místní složky az webapp up :

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

• Pokud se az příkaz nerozpozná, ujistěte se, že máte nainstalované Rozhraní příkazového řádku Azure.
• Argument --runtime "PHP:8.2" vytvoří webovou aplikaci s PHP verze 8.2.
• Argument --os-type=linux vytvoří webovou aplikaci na App Service v Linuxu.
• Volitelně můžete zadat název s argumentem --name <app-name>. Pokud ho nezadáte, automaticky se vygeneruje název.
• Volitelně můžete zahrnout argument --location <location-name> , ve kterém <location_name> je dostupná oblast Azure. Spuštěním az account list-locations příkazu můžete načíst seznam povolených oblastí pro váš účet Azure.
• Pokud se zobrazí chyba "Nepodařilo se automaticky rozpoznat zásobník modulu runtime vaší aplikace", ujistěte se, že spouštíte příkaz v adresáři kódu (viz Řešení potíží s automatickým zjišťováním problémů s az webapp up).

Dokončení tohoto příkazu může trvat několik minut. Během spuštění poskytuje zprávy o vytvoření skupiny prostředků, plánu služby App Service a prostředku aplikace, konfiguraci protokolování a nasazení souboru ZIP. Zobrazí se zpráva "Aplikaci můžete spustit na http://< app-name.azurewebsites.net>", což je adresa URL aplikace v Azure.

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"
}

Poznámka:

Příkaz az webapp up provádí tyto akce:

• Vytvořte výchozí skupinu prostředků.

• Vytvořte výchozí plán služby App Service.

• Vytvořte aplikaci se zadaným názvem.

• Zip nasadí všechny soubory z aktuálního pracovního adresáře s povolenou automatizací sestavení.

• Uložte parametry do mezipaměti místně v souboru .azure/config , abyste je nemuseli při pozdějším az webapp up az webapp nasazení s jinými příkazy ze složky projektu zadávat znovu. Hodnoty uložené v mezipaměti se ve výchozím nastavení používají automaticky.

Přejděte do nasazené aplikace ve webovém prohlížeči na adrese URL http://<app-name>.azurewebsites.net.

Azure Portal

1. Přihlaste se k webu Azure Portal.

2. V horní části portálu zadejte do vyhledávacího pole aplikační služby . V části Služby vyberte App Services.

   

3. Na stránce App Services vyberte + Vytvořit.

4. Na kartě Základy :

   • V části Skupina prostředků vyberte Vytvořit novou. Jako název zadejte myResourceGroup .
   • V části Název zadejte globálně jedinečný název vaší webové aplikace.
   • V části Publikovat vyberte Kód.
   • V části Zásobník modulu runtime vyberte PHP 8.2.
   • V části Operační systém vyberte Linux.
   • V části Oblast vyberte oblast Azure blízko vás.
   • V části Plán služby App Service vytvořte plán služby App Service s názvem myAppServicePlan.
   • V části Cenový plán vyberte Free F1.

   

5. Vyberte kartu Nasazení v horní části stránky.

6. V části Nastavení GitHub Actions nastavte průběžné nasazování na hodnotu Povolit.

7. V části Podrobnosti o GitHub Actions se ověřte pomocí účtu GitHub a vyberte následující možnosti:

   • Pro organizaci vyberte organizaci, ve které jste rozvětvovali ukázkový projekt.
   • V části Úložiště vyberte projekt php-docs-hello-world .
   • Pro větev vyberte předlohu.

   

   Poznámka:

   Ve výchozím nastavení průvodce vytvořením zakáže základní ověřování a nasazení GitHub Actions se vytvoří pomocí identity přiřazené uživatelem. Pokud při vytváření prostředků dojde k chybě oprávnění, váš účet Azure pravděpodobně nemá dostatečná oprávnění. Nasazení GitHub Actions můžete nakonfigurovat později s identitou vygenerovanou správcem Azure nebo můžete místo toho povolit základní ověřování.

8. Vyberte tlačítko Zkontrolovat a vytvořit v dolní části stránky.

9. Po spuštění ověření vyberte tlačítko Vytvořit v dolní části stránky.

10. Po dokončení nasazení vyberte Přejít k prostředku.

11. Přejděte do nasazené aplikace ve webovém prohlížeči na adrese URL http://<app-name>.azurewebsites.net.

Vzorový kód PHP běží ve službě Aplikace Azure Service.

Gratulujeme! Nasadili jste svou první aplikaci v PHP do služby App Service pomocí webu Azure Portal.

3. Aktualizace a opětovné nasazení aplikace

Azure CLI

1. Pomocí místního textového editoru otevřete soubor index.php, který je součástí PHP aplikace, a proveďte malou změnu textu v řetězci vedle echo:

   echo "Hello Azure!";
   

2. Uložte změny a znovu nasaďte aplikaci pomocí příkazu az webapp up s těmito argumenty:

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

3. Po dokončení nasazení se vraťte do okna prohlížeče, které se otevřelo během procházení kroku aplikace , a aktualizujte stránku.

   

Azure Portal

1. Přejděte na fork php-docs-hello-world na GitHubu.

2. Na stránce úložiště stiskněte a . spusťte Visual Studio Code v prohlížeči.

   

   Poznámka:

   Adresa URL se změní z GitHub.com na GitHub.dev. Tato funkce funguje jenom s úložištěmi, která mají soubory. Tato funkce nefunguje na prázdných úložišťch.

3. Upravte index.php tak, aby se místo "Hello World!" místo "Hello World!" zobrazoval text "Hello Azure!".

   <?php
       echo "Hello Azure!";
   ?>
   

4. V nabídce Správa zdrojového kódu vyberte tlačítko Změny fáze a připravte změnu.

   

5. Zadejte zprávu potvrzení, například Hello Azure. Pak vyberte Potvrdit a Odeslat.

   

6. Po dokončení nasazení se vraťte do okna prohlížeče, které se otevřelo během procházení kroku aplikace , a aktualizujte stránku.

   

4. Správa nové aplikace Azure

1. Pokud chcete spravovat webovou aplikaci, kterou jste vytvořili, přejděte na web Azure Portal. Vyhledejte a vyberte App Services.

   

2. Vyberte název aplikace Azure.

   

   Měla by se zobrazit stránka Přehled vaší webové aplikace. Tady můžete provádět základní úlohy správy, jako je procházení, zastavení, restartování a odstranění.

   

   Nabídka webové aplikace nabízí různé možnosti konfigurace aplikace.

5. Vyčištění prostředků

Až budete s ukázkovou aplikací hotovi, můžete z Azure odebrat všechny prostředky aplikace. Pomůže vám vyhnout se dodatečným poplatkům a udržovat vaše předplatné Azure přehledné. Odebráním skupiny prostředků se také odeberou všechny prostředky ve skupině prostředků a je nejrychlejší způsob, jak odebrat všechny prostředky Azure pro vaši aplikaci.

Azure CLI

Odstraňte skupinu prostředků pomocí příkazu az group delete .

az group delete --name myResourceGroup

Spuštění tohoto příkazu trvá minutu.

Azure Portal

1. Na stránce Přehled služby App Service vyberte skupinu prostředků, kterou jste vytvořili.

2. Na stránce skupiny prostředků vyberte Odstranit skupinu prostředků. Potvrďte název skupiny prostředků a dokončete odstranění prostředků.

Další kroky

PHP s databází MySQL

Konfigurace aplikace PHP

 Zabezpečení s využitím vlastní domény a certifikátu