Skapa en PHP-webbapp i Azure App Service

Artikel
02/03/2024

Varning

PHP i Windows nådde End-of-Life i november 2022 och stöds endast på App Service på Linux. Den här artikeln är endast till för referens..

Med Azure App Service får du en automatiskt uppdaterad webbvärdtjänst med hög skalbarhet. Den här snabbstartsguiden visar hur du distribuerar en PHP-app till Azure App Service i Windows.

Du skapar webbappen med Azure CLI i Cloud Shell och använder Git för att distribuera PHP-exempelkoden till webbappen.

Exempelapp som körs i Azure

Du kan följa stegen här på en Mac-, Windows- eller Linux-dator. Det tar cirka fem minuter att slutföra självstudiekursen när de nödvändiga komponenterna har installerats.

Om du inte har en Azure-prenumeration skapar du ett kostnadsfritt Azure-konto innan du börjar.

Kommentar

Efter den 28 november 2022 stöds PHP endast på App Service på Linux.

Förutsättningar

För att slutföra den här snabbstarten behöver du:

Ladda ned exemplet lokalt

Kör följande kommandon i ett terminalfönster. Den klonar exempelprogrammet till den lokala datorn och navigerar till katalogen som innehåller exempelkoden.
```
git clone https://github.com/Azure-Samples/php-docs-hello-world
cd php-docs-hello-world
```
Kontrollera att standardgrenen är main.
```
git branch -m main
```
Dricks

Ändringen av grennamnet krävs inte av App Service. Men eftersom många lagringsplatser ändrar sin standardgren till mainvisar den här snabbstarten också hur du distribuerar en lagringsplats från main.

Köra appen lokalt

Kör programmet lokalt så att du ser hur det ska se ut när du distribuerar det till Azure. Öppna ett terminalfönster och använd kommandot php för att starta den inbyggda PHP-webbservern.
```
php -S localhost:8080
```
Öppna webbläsaren och navigera till exempelappen på http://localhost:8080.

Du ser Hello World! -meddelandet från exempelappen som visas på sidan.
Tryck på Ctrl+C i terminalfönstret för att avsluta webbservern.

Azure Cloud Shell

Azure är värd för Azure Cloud Shell, en interaktiv gränssnittsmiljö som du kan använda via webbläsaren. Du kan använda antingen Bash eller PowerShell med Cloud Shell för att arbeta med Azure-tjänster. Du kan använda förinstallerade Cloud Shell-kommandon för att köra koden i den här artikeln, utan att behöva installera något i din lokala miljö.

Så här startar du Azure Cloud Shell:

Alternativ	Exempel/länk
Välj Prova i det övre högra hörnet i en kod eller ett kommandoblock. Om du väljer Prova kopieras inte koden eller kommandot automatiskt till Cloud Shell.
Gå till https://shell.azure.com eller Välj knappen Starta Cloud Shell för att öppna Cloud Shell i webbläsaren.
Välj knappen Cloud Shell på menyn längst upp till höger i Azure-portalen.

Så här använder du Azure Cloud Shell:

Starta Cloud Shell.
Välj knappen Kopiera i ett kodblock (eller kommandoblock) för att kopiera koden eller kommandot.
Klistra in koden eller kommandot i Cloud Shell-sessionen genom att välja Ctrl+Skift+V i Windows och Linux, eller genom att välja Cmd+Shift+V på macOS.
Välj Retur för att köra koden eller kommandot.

Konfigurera en distributionsanvändare

FTP och lokal Git kan distribueras till en Azure-webbapp med hjälp av en distributionsanvändare. När du har konfigurerat distributionsanvändaren kan du använda den för alla dina Azure-distributioner. Ditt användarnamn och lösenord för distribution på kontonivå skiljer sig från dina autentiseringsuppgifter för Azure-prenumerationen.

Om du vill konfigurera distributionsanvändaren kör du kommandot az webapp deployment user set i Azure Cloud Shell. Ersätt <användarnamn> och <lösenord> med ett användarnamn och lösenord för distributionsanvändaren.

Användarnamnet måste vara unikt i Azure, och för lokala Git-push-meddelanden får det inte innehålla @-symbolen.
Lösenordet måste vara minst åtta tecken långt, med två av följande tre element: bokstäver, siffror och symboler.

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

JSON-utdata visar lösenordet som null. Om du ser felet 'Conflict'. Details: 409 ska du byta användarnamn. Om du ser felet 'Bad Request'. Details: 400 ska du använda ett starkare lösenord.

Registrera ditt användarnamn och lösenord som ska användas för att distribuera dina webbappar.

Skapa en resursgrupp

En resursgrupp är en logisk container där Azure-resurser, till exempel webbappar, databaser och lagringskonton, distribueras och hanteras. Du kan exempelvis välja att ta bort hela resursgruppen i ett enkelt steg längre fram.

Skapa i Cloud Shell en resursgrupp med kommandot az group create. I följande exempel skapas en resursgrupp med namnet myResourceGroup på platsen Europa, västra. Om du vill se alla platser som stöds för App Service på Kostnadsfri nivå, kör du kommandot az appservice list-locations --sku FREE.

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

Du skapar vanligtvis din resursgrupp och resurserna i en region nära dig.

När kommandot har slutförts visar JSON-utdata resursgruppens egenskaper.

Skapa en Azure App Service-plan

Skapa i Cloud Shell en App Service-plan med kommandot az appservice plan create.

I följande exempel skapas en App Service-plan med namnet myAppServicePlan på prisnivån Kostnadsfri:

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

När App Service-planen har skapats visas information av Azure CLI. Informationen ser ut ungefär som i följande exempel:

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

Skapa en webbapp

Skapa i Cloud Shell en webbapp i myAppServicePlan App Service-planen med kommandot az webapp create.

Ersätt <app-name> med ett globalt unikt appnamn (giltiga tecken är a-z, 0-9 och -) i följande exempel. Körningen har angetts till PHP|7.4. Om du vill se alla körningar som stöds ska du köra az webapp list-runtimes.
```
az webapp create --resource-group myResourceGroup --plan myAppServicePlan --name <app-name> --runtime 'PHP|8.1' --deployment-local-git
```
När webbappen har skapats visar Azure CLI utdata liknande den i följande exempel:
```
 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. >
 }
 
```
Du har skapat en tom ny webbapp med git-distribution aktiverad.

Kommentar

URL för fjärransluten Git visas i egenskapen deploymentLocalGitUrl med formatet https://<username>@<app-name>.scm.azurewebsites.net/<app-name>.git. Spara den här URL:en, eftersom du behöver den senare.
Bläddra till webbappen som precis skapades. Ersätt <appnamn> med ditt unika appnamn som skapades i föregående steg.
```
http://<app-name>.azurewebsites.net
```
Så här bör din nya webbapp se ut:

Skicka till Azure från Git

Eftersom du distribuerar grenen main måste du ange standarddistributionsgrenen för App Service-appen till main (se Ändra distributionsgren). I Cloud Shell anger du appinställningen DEPLOYMENT_BRANCH az webapp config appsettings set med kommandot .
```
az webapp config appsettings set --name <app-name> --resource-group myResourceGroup --settings DEPLOYMENT_BRANCH='main'
```
I det lokala terminalfönstret kan du lägga till en Azure-fjärrdatabas till din lokala Git-databas. Ersätt <deploymentLocalGitUrl-from-create-step> med URL:en för git-fjärren som du sparade från Skapa en webbapp.
```
git remote add azure <deploymentLocalGitUrl-from-create-step>
```
Skicka till Azure-fjärrdatabasen för att distribuera appen med följande kommando. När Git Credential Manager frågar efter autentiseringsuppgifter kontrollerar du att du anger de autentiseringsuppgifter som du skapade i Konfigurera lokal git-distribution, inte de autentiseringsuppgifter som du använder för att logga in på Azure Portal.
```
git push azure main
```
Det kan ta några minuter att köra det här kommandot. Medan det körs visas information liknande den i följande exempel:

  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

Bläddra till appen

Bläddra till den distribuerade appen via webbläsaren.

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

PHP-exempelkoden körs i en Azure App Service-webbapp.

Exempelapp som körs i Azure

Grattis! Du har distribuerat din första PHP-app till App Service.

Uppdatera lokalt och distribuera om koden

Öppna filen index.php i PHP-appen med ett lokalt textredigeringsprogram och gör små ändringar i texten i strängen bredvid echo:
```
echo "Hello Azure!";
```
I det lokala terminalfönstret sparar du ändringarna i Git och skickar sedan kodändringarna till Azure.
```
git commit -am "updated output"
git push azure main
```
När distributionen är klar går du tillbaka till webbläsarfönstret som öppnades när du skulle söka efter appen och klickar på knappen för att uppdatera sidan.

Hantera din nya Azure-app

Gå till Azure Portal för att hantera den webbapp som du skapade. Sök efter och välj App Services.
Välj namnet på din Azure-app.

Webbappens översiktssida visas. Här kan du utföra grundläggande hanteringsuppgifter som Bläddra, Stoppa, Starta om och Ta bort.

Webbappmenyn innehåller olika alternativ för att konfigurera din app.

Rensa resurser

I de föregående stegen skapade du Azure-resurser i en resursgrupp. Om du inte tror att du behöver dessa resurser i framtiden tar du bort resursgruppen genom att köra följande kommando i Cloud Shell:

az group delete --name myResourceGroup

Det kan några minuter att köra kommandot.

Med Azure App Service får du en automatiskt uppdaterad webbvärdtjänst med hög skalbarhet. Den här snabbstarten visar hur du distribuerar en PHP-app till Azure App Service på Linux.

Skärmbild av exempelappen som körs i Azure.

Du kan följa stegen här på en Mac-, Windows- eller Linux-dator. Det tar cirka fem minuter att slutföra självstudiekursen när de nödvändiga komponenterna har installerats.

Följande krävs för att slutföra den här snabbstarten:

Ett Azure-konto med en aktiv prenumeration. Skapa ett konto utan kostnad.
Git
PHP
Azure CLI för att köra kommandon i valfritt gränssnitt för att skapa och konfigurera Azure-resurser.

Du kan skapa webbappen med hjälp av Azure CLI i Cloud Shell och använda Git för att distribuera PHP-exempelkod till webbappen.

I ett terminalfönster kör du följande kommandon för att klona exempelprogrammet till den lokala datorn och navigera till projektroten.
```
git clone https://github.com/Azure-Samples/php-docs-hello-world
cd php-docs-hello-world
```
Om du vill köra programmet lokalt använder du php kommandot för att starta den inbyggda PHP-webbservern.
```
php -S localhost:8080
```
Bläddra till exempelprogrammet i http://localhost:8080 en webbläsare.
Tryck på Ctrl+C i terminalfönstret för att avsluta webbservern.

I webbläsaren navigerar du till lagringsplatsen som innehåller exempelkoden.
I det övre högra hörnet väljer du Förgrening.
På skärmen Skapa en ny förgrening bekräftar du fälten Ägare och Lagringsplatsnamn. Välj Skapa förgrening.

Kommentar

Detta bör ta dig till den nya förgreningen. Din förgrenings-URL ser ut ungefär så här: https://github.com/YOUR_GITHUB_ACCOUNT_NAME/php-docs-hello-world

2 – Distribuera programkoden till Azure

Azure CLI
Portal

Azure CLI har ett kommando az webapp up som skapar nödvändiga resurser och distribuerar ditt program i ett enda steg.

Distribuera koden i den lokala mappen i terminalen med kommandot az webapp up :

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

az Om kommandot inte känns igen måste du ha Azure CLI installerat.
Argumentet --runtime "PHP:8.2" skapar webbappen med PHP version 8.2.
Argumentet --os-type=linux skapar webbappen på App Service på Linux.
Du kan också ange ett namn med argumentet --name <app-name>. Om du inte anger något genereras ett namn automatiskt.
Du kan också inkludera argumentet --location <location-name> där <location_name> är en tillgänglig Azure-region. Du kan hämta en lista över tillåtna regioner för ditt Azure-konto genom att az account list-locations köra kommandot .
Om du ser felet "Det gick inte att identifiera körningsstacken för din app automatiskt" kontrollerar du att du kör kommandot i kodkatalogen (se Felsöka problem med automatisk identifiering med az webapp up).

Det kan ta några minuter att köra kommandot. När den körs visas meddelanden om hur du skapar resursgruppen, App Service-planen och appresursen, konfigurerar loggning och utför ZIP-distribution. Meddelandet "Du kan starta appen på http://< app-name.azurewebsites.net>", som är appens URL i 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"
}

Kommentar

Kommandot az webapp up utför följande åtgärder:

Skapa en standardresursgrupp.
Skapa en standardplan för App Service.
Skapa en app med det angivna namnet.
Zip-distribuera alla filer från den aktuella arbetskatalogen, med build automation aktiverat.
Cachelagra parametrarna lokalt i .azure/config-filen så att du inte behöver ange dem igen när du distribuerar dem senare med az webapp up eller andra az webapp kommandon från projektmappen. De cachelagrade värdena används automatiskt som standard.

Bläddra till det distribuerade programmet i webbläsaren på URL:en http://<app-name>.azurewebsites.net.

Logga in på Azure-portalen.
Överst i portalen skriver du apptjänster i sökrutan. Under Tjänster väljer du App Services.
På sidan App Services väljer du + Skapa.
På fliken Grundläggande :
- Välj Skapa ny under Resursgrupp. Skriv myResourceGroup som namn.
- Under Namn skriver du ett globalt unikt namn för din webbapp.
- Under Publicera väljer du Kod.
- Under Körningsstack väljer du PHP 8.2.
- Under Operativsystem väljer du Linux.
- Under Region väljer du en Azure-region nära dig.
- Under App Service-plan skapar du en App Service-plan med namnet myAppServicePlan.
- Under Prisplan väljer du Kostnadsfri F1.
Välj fliken Distribution överst på sidan.
Under Inställningar för GitHub Actions anger du Kontinuerlig distribution till Aktivera.
Under GitHub Actions-information autentiserar du med ditt GitHub-konto och väljer följande alternativ:
- För Organisation väljer du den organisation där du förgrenade demoprojektet.
- För Lagringsplats väljer du projektet php-docs-hello-world .
- För Gren väljer du original.
Kommentar

Som standard inaktiverar guiden skapa grundläggande autentisering och GitHub Actions-distributionen skapas med hjälp av en användartilldelad identitet. Om du får ett behörighetsfel när resursen skapas kanske ditt Azure-konto inte har tillräckligt med behörigheter. Du kan konfigurera GitHub Actions-distribution senare med en identitet som genererats åt dig av en Azure-administratör, eller också kan du aktivera grundläggande autentisering i stället.
Välj knappen Granska + skapa längst ned på sidan.
När valideringen har körts väljer du knappen Skapa längst ned på sidan.
När distributionen är klar väljer du Gå till resurs.
Bläddra till det distribuerade programmet i webbläsaren på URL:en http://<app-name>.azurewebsites.net.

PHP-exempelkoden körs i en Azure App Service.

Skärmbild av exempelappen som körs i Azure och som visar

Grattis! Du distribuerade din första PHP-app till App Service med hjälp av Azure Portal.

3 – Uppdatera och distribuera om appen

Azure CLI
Portal

Öppna filen index.php i PHP-appen med ett lokalt textredigeringsprogram och gör små ändringar i texten i strängen bredvid echo:
```
echo "Hello Azure!";
```
Spara ändringarna och distribuera sedan om appen med kommandot az webapp up igen med följande argument:
```
az webapp up --runtime "PHP:8.2" --os-type=linux
```
När distributionen är klar går du tillbaka till webbläsarfönstret som öppnades under steget Bläddra till appen och uppdaterar sidan.

Bläddra till din GitHub-förgrening av php-docs-hello-world.
På lagringsplatsen trycker du på . för att starta Visual Studio Code i webbläsaren.

Kommentar

URL:en ändras från GitHub.com till GitHub.dev. Den här funktionen fungerar bara med lagringsplatser som har filer. Detta fungerar inte på tomma lagringsplatser.
Redigera index.php så att den visar "Hello Azure!" i stället för "Hello World!"
```
<?php
    echo "Hello Azure!";
?>
```
På menyn Källkontroll väljer du knappen Stegändringar för att mellanlagra ändringen.
Ange ett incheckningsmeddelande, till exempel Hello Azure. Välj sedan Checka in och skicka.
När distributionen är klar går du tillbaka till webbläsarfönstret som öppnades under steget Bläddra till appen och uppdaterar sidan.

4 – Hantera din nya Azure-app

Gå till Azure Portal för att hantera den webbapp som du skapade. Sök efter och välj App Services.
Välj namnet på din Azure-app.

Webbappens översiktssida bör visas. Här kan du utföra grundläggande hanteringsuppgifter som Bläddra, Stoppa, Starta om och Ta bort.

Webbappmenyn innehåller olika alternativ för att konfigurera din app.

5 – Rensa resurser

När du är klar med exempelappen kan du ta bort alla resurser för appen från Azure. Det hjälper dig att undvika extra avgifter och håller din Azure-prenumeration ostädad. Om du tar bort resursgruppen tas även alla resurser i resursgruppen bort och är det snabbaste sättet att ta bort alla Azure-resurser för din app.

Azure CLI
Portal

Ta bort resursgruppen med kommandot az group delete .

az group delete --name myResourceGroup

Det tar en minut att köra det här kommandot.

Nästa steg

PHP med MySQL

Konfigurera PHP-app

Skydda med anpassad domän och certifikat

Dela via

Skapa en PHP-webbapp i Azure App Service

Förutsättningar

Ladda ned exemplet lokalt

Köra appen lokalt

Azure Cloud Shell

Konfigurera en distributionsanvändare

Skapa en resursgrupp

Skapa en Azure App Service-plan

Skapa en webbapp

Skicka till Azure från Git

Bläddra till appen

Uppdatera lokalt och distribuera om koden

Hantera din nya Azure-app

Rensa resurser

1 – Hämta exempellagringsplatsen

2 – Distribuera programkoden till Azure

3 – Uppdatera och distribuera om appen

4 – Hantera din nya Azure-app

5 – Rensa resurser

Nästa steg

Feedback

Ytterligare resurser