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

Upozornění

PHP ve Windows dosáhlo konce podpory v listopadu 2022. PHP se podporuje jenom pro 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 nemáte účet Azure, vytvořte si bezplatný účet 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 dokončení tohoto rychlého startu:

• Nainstalovat Git.
• Nainstalovat PHP.

Stáhnout ukázku lokálně

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
   

   Návod

   Změna jména větve není vyžadována službou App Service. 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 stisknutím kombinace kláves Ctrl+Shift+V na Windows a Linuxu nebo stisknutím Cmd+Shift+V na macOS.

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

Nakonfigurujte uživatele pro nasazení

FTP a místní Git se můžou nasadit do webové aplikace Azure pomocí uživatelského účtu pro 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ů s názvem myResourceGroup v lokalitě 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 vytvoříte svoji skupinu prostředků a prostředky v oblasti, která je blízko vás.

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 myAppServicePlan vytvořte v plánu služby App Service az webapp create 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. Pro zobrazení všech podporovaných runtime spuštěte 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 <URL>
    {
      "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 zobrazí ve vlastnosti deploymentLocalGitUrl. 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.

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

   

Přenos z Gitu do Azure

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

   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, kterou jste uložili z Vytvořit webovou aplikaci.

   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 <URL>
      cc39b1e..25f1805  main -> main
  

Přechod do aplikace

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

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čistěte zdroje

V předchozích krocích jste ve skupině prostředků vytvořili zdroje Azure. 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 poskytuje vysoce škálovatelnou službu s vlastní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. Po instalaci předpokladů trvá dokončení kroků přibližně deset minut.

Požadavky

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

Stažení ukázkového úložiště

Azure CLI

V následujících krocích vytvoříte webovou aplikaci pomocí Azure CLI a pak do webové aplikace nasadíte ukázkový kód PHP.

Můžete použít Azure Cloud Shell.

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.

Portál

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 možnost Vytvořit fork.

   

Poznámka:

Měli byste přejít na nový fork. Adresa URL vašeho forku vypadá nějak takto: https://github.com/YOUR_GITHUB_ACCOUNT_NAME/php-docs-hello-world

Nasadit kód 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 Nelze automaticky rozpoznat běhový zásobník vaší aplikace, ujistěte se, že příkaz spouštíte v adresáři kódu. Další informace najdete v tématu Řešení potíží s automatickým zjišťováním pomocí příkazu 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. Pak poskytne adresu 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 <directory-location> ...
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": "<directory-path>"
}

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.

• Nasaďte pomocí zipu všechny soubory z aktuálního pracovního adresáře , kde je povolena automatizace sestavení.

• Uložte parametry do mezipaměti místně v souboru .azure/config , abyste je nemuseli při pozdějším az webapp upaz 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.

Ve webovém prohlížeči vyhledejte nasazenou aplikaci na adrese URL, která je k dispozici v terminálu.

Portál

1. Přihlaste se k portálu Azure.

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 a zvolte Webová aplikace.

4. Na záložce 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 tu, ve které jste forkovali ukázkový projekt.
   • V části Úložiště vyberte projekt php-docs-hello-world .
   • V poli Větev vyberte hlavní.

   

   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. Ve webovém prohlížeči vyhledejte nasazenou aplikaci na zadané adrese URL.

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.

Aktualizace a opětovné nasazení aplikace

Azure CLI

1. Vyhledejte adresář php-docs-hello-world a otevřete soubor index.php pomocí místního textového editoru. Proveďte malou změnu v 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.

   

Portál

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

2. Na stránce úložiště stiskněte ., aby se Visual Studio Code spustil ve vašem 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. To nefunguje na prázdných úložištích.

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

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

4. Z nabídky Ovládání verzí vyberte tlačítko Připravit změny ke zveřejnění změny.

   

5. Zadejte potvrzovací zprávu, 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 kroku Přejít do aplikace , a aktualizujte stránku.

   

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. Výběrem aplikace Azure ji otevřete.

   

   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.

Vyčistěte zdroje

Až skončíte s ukázkovou aplikací, můžete z Azure odebrat všechny prostředky pro aplikaci, abyste se vyhnuli dodatečným poplatkům a udrželi své 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.

Portál

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ů, abyste dokončili odstranění prostředků.

Související obsah

• Nasazení aplikace PHP, MySQL a Redis do Azure App Service
• Konfigurace aplikace PHP pro Azure App Service
• Zabezpečení aplikace pomocí vlastní domény a spravovaného certifikátu