Självstudie: Skapa en PHP- och MySQL-app i Azure App Service

I den här guiden får du lära dig att:

Om du inte har en Azure-prenumerationkan du skapa ett kostnads fritt konto innan du börjar.

Förutsättningar

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

• Installera Git
• Installera PHP 5.6.4 eller senare
• Installera Composer
• Aktivera följande PHP-tillägg som behövs för Laravel: OpenSSL, PDO-MySQL, Mbstring, Tokenizer och XML
• Installera och starta MySQL

• Använd bash-miljön i Azure Cloud Shell.

  

• Om du vill kan du i stället installera Azure CLI för att köra CLI-referenskommandon.

  • Om du använder en lokal installation loggar du in på Azure CLI med hjälp av kommandot az login. Slutför autentiseringsprocessen genom att följa stegen som visas i terminalen. Fler inloggningsalternativ finns i Logga in med Azure CLI.

  • När du uppmanas till det installerar du Azure CLI-tillägg vid första användning. Mer information om tillägg finns i Använda tillägg med Azure CLI.

  • Kör az version om du vill hitta versionen och de beroende bibliotek som är installerade. Om du vill uppgradera till den senaste versionen kör du az upgrade.

Förbereda lokal MySQL

I det här steget skapar du en databas för självstudien på din lokala MySQL-server.

Ansluta till en lokal MySQL-server

Anslut till din lokala MySQL-server via ett terminalfönster. Du kan använda det här terminalfönstret för att köra alla kommandon i den här självstudien.

mysql -u root -p

Om du uppmanas att ange ett lösenord anger du lösenordet för root-kontot. Se MySQL: Återställa rotlösenordet om du inte kommer ihåg rotlösenordet för ditt konto.

MySQL-servern är igång om kommandot körs utan problem. Om inte, kontrollerar du att den lokala MySQL-servern är igång genom att följa anvisningarna efter installation av MySQL.

Skapa en lokal databas

1. Skapa en databas i mysql-prompten.

   CREATE DATABASE sampledb;
   

2. Skriv quit för att avsluta serveranslutningen.

   quit
   

Skapa en PHP-app lokalt

I det här steget hämtar du en Laravel-exempelapp, konfigurerar dess databasanslutning och kör den lokalt.

Klona exemplet

Använd kommandot cd för att komma till en arbetskatalog i terminalfönstret.

1. Klona exempeldatabasen och ändra till lagringsplatsens rot.

   git clone https://github.com/Azure-Samples/laravel-tasks
   cd laravel-tasks
   

2. Kontrollera att standardgrenen är main .

   git branch -m main
   

   Tips

   Ändringen av grennamnet krävs inte av App Service. Men eftersom många lagringslager ändrar sin standardgren till visar den här självstudien även hur du main distribuerar en lagringsplats från main . Mer information finns i Ändra distributionsgren.

3. Installera de paket som behövs.

   composer install
   

Konfigurera MySQL-anslutningen

Skapa en fil med namnet .env i lagringsplatsens rot. Kopiera in följande variabler i .env-filen. Ersätt < root_password> platshållaren med MySQL-rotanvändarens lösenord.

APP_ENV=local
APP_DEBUG=true
APP_KEY=

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_DATABASE=sampledb
DB_USERNAME=root
DB_PASSWORD=<root_password>

Mer information om hur Laravel använder .env-filen finns i Laravel Environment Configuration (Konfiguration av Laravel-miljö).

Köra exemplet lokalt

1. Kör Laravel-databasmigreringar för att skapa de tabeller som behövs för appen. Du kan se vilka tabeller som skapas i migreringarna i katalogen database/migrations (databas/migreringar) på Git-lagringsplatsen.

   php artisan migrate
   

2. Generera en ny Laravel-programnyckel.

   php artisan key:generate
   

3. Kör appen.

   php artisan serve
   

4. Gå till http://localhost:8000 i en webbläsare. Lägg till några uppgifter på sidan.

   

5. Om du vill stoppa PHP skriver du Ctrl + C i terminalen.

Skapa MySQL i Azure

I det här steget skapar du en MySQL-databas i Azure Database for MySQL. Senare kommer du att konfigurera PHP-appen för att ansluta till den här databasen.

Skapa en resursgrupp

En resurs grupp är en logisk behållare där Azure-resurser, till exempel webbappar, databaser och lagrings konton, distribueras och hanteras. Du kan exempelvis välja att ta bort hela resursgruppen i ett enkelt steg längre fram.

I Cloud Shell skapar du en resurs grupp med az group create kommandot. 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 MySQL-server

I Cloud Shell skapar du en server Azure Database for MySQL med az mysql server create kommandot .

I följande kommando ersätter du platshållaren med ett unikt servernamn, ett användarnamn för <mysql-server-name> och ett lösenord för <admin-user> <admin-password> platshållaren. Det här servernamnet används som en del av MySQL-slutpunkten (https://<mysql-server-name>.mysql.database.azure.com), så namnet måste vara unikt för alla servrar i Azure. Mer information om hur du väljer MySQL DB SKU finns i Skapa en Azure Database for MySQL server.

az mysql server create --resource-group myResourceGroup --name <mysql-server-name> --location "West Europe" --admin-user <admin-user> --admin-password <admin-password> --sku-name B_Gen5_1

När MySQL-servern skapas visar Azure CLI information som ser ut ungefär så här:

{
  "administratorLogin": "<admin-user>",
  "administratorLoginPassword": null,
  "fullyQualifiedDomainName": "<mysql-server-name>.mysql.database.azure.com",
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.DBforMySQL/servers/<mysql-server-name>",
  "location": "westeurope",
  "name": "<mysql-server-name>",
  "resourceGroup": "myResourceGroup",
  ...
  -  < Output has been truncated for readability >
}

Konfigurera serverbrandväggen

1. I Cloud Shell du en brandväggsregel för MySQL-servern som tillåter klientanslutningar med hjälp av az mysql server firewall-rule create kommandot . När både start-IP och slut-IP har angetts till 0.0.0.0 öppnas brandväggen endast för andra Azure-resurser.

   az mysql server firewall-rule create --name allAzureIPs --server <mysql-server-name> --resource-group myResourceGroup --start-ip-address 0.0.0.0 --end-ip-address 0.0.0.0
   

   Tips

   Du kan begränsa brandväggsregeln ännu mer genom att endast använda de utgående IP-adresser som används av din app.

2. I den Cloud Shell du kommandot igen för att tillåta åtkomst från din lokala dator genom att ersätta med din lokala <your-ip-address> IPv4 IP-adress.

   az mysql server firewall-rule create --name AllowLocalClient --server <mysql-server-name> --resource-group myResourceGroup --start-ip-address=<your-ip-address> --end-ip-address=<your-ip-address>
   

Skapa en produktionsdatabas

1. Anslut till MySQL-server i Azure via det lokala terminalfönstret. Använd det värde som du angav tidigare < för admin-user> och < mysql-server-name>. När du uppmanas att ange ett lösenord använder du lösenordet som du angav när du skapade databasen i Azure.

   mysql -u <admin-user>@<mysql-server-name> -h <mysql-server-name>.mysql.database.azure.com -P 3306 -p
   

2. Skapa en databas i mysql-prompten.

   CREATE DATABASE sampledb;
   

3. Skapa en databasanvändare med namnet phpappuser och ge användaren alla privilegier i sampledb-databasen. För enkelhetens skull använder du MySQLAzure2017 som lösenord.

   CREATE USER 'phpappuser' IDENTIFIED BY 'MySQLAzure2017'; 
   GRANT ALL PRIVILEGES ON sampledb.* TO 'phpappuser';
   

4. Skriv quit för att avsluta serveranslutningen.

   quit
   

Ansluta appen till Azure MySQL

I det här steget ansluter du PHP-programmet till MySQL-databasen som du skapade i Azure Database for MySQL.

Konfigurera databasanslutningen

Skapa en .env.production-fil i lagringsplatsens rot och kopiera in följande variabler i filen. Ersätt placeholder_ < mysql-server-name>_ i både DB_HOST och DB_USERNAME.

APP_ENV=production
APP_DEBUG=true
APP_KEY=

DB_CONNECTION=mysql
DB_HOST=<mysql-server-name>.mysql.database.azure.com
DB_DATABASE=sampledb
DB_USERNAME=phpappuser@<mysql-server-name>
DB_PASSWORD=MySQLAzure2017
MYSQL_SSL=true

Spara ändringarna.

Konfigurera TLS/SSL-certifikat

Som standard Azure Database for MySQL TLS-anslutningar från klienter. För att ansluta till din MySQL-databas i Azure måste du använda .pem-certifikatet som tillhandahålls av Azure Database for MySQL.

Öppna config/database.php och lägg till parametrarna sslmode och options i connections.mysql, som i följande kod.

'mysql' => [
    ...
    'sslmode' => env('DB_SSLMODE', 'prefer'),
    'options' => (env('MYSQL_SSL')) ? [
        PDO::MYSQL_ATTR_SSL_KEY    => '/ssl/BaltimoreCyberTrustRoot.crt.pem', 
    ] : []
],

'mysql' => [
    ...
    'sslmode' => env('DB_SSLMODE', 'prefer'),
    'options' => (env('MYSQL_SSL') && extension_loaded('pdo_mysql')) ? [
        PDO::MYSQL_ATTR_SSL_KEY    => '/ssl/BaltimoreCyberTrustRoot.crt.pem',
    ] : []
],

I den här kursen finns certifikatet BaltimoreCyberTrustRoot.crt.pem på lagringsplatsen så att du enkelt kommer åt det.

Testa appen lokalt

1. Kör Laravel-databasmigreringar med .env.production som miljöfil för att skapa tabellerna i din MySQL-databas i Azure Database for MySQL. Tänk på att anslutningsinformationen till din MySQL-databas i Azure finns i .env.production.

   php artisan migrate --env=production --force
   

2. .env.production innehåller inte någon giltig programnyckel ännu. Generera en ny nyckel för den i terminalen.

   php artisan key:generate --env=production --force
   

3. Kör exempelprogrammet med .env.production som miljöfil.

   php artisan serve --env=production
   

4. Navigera till http://localhost:8000. Om sidan läses in utan fel ansluter PHP-appen till MySQL-databasen i Azure.

5. Lägg till några uppgifter på sidan.

   

6. Om du vill stoppa PHP skriver du Ctrl + C i terminalen.

Genomföra ändringarna

Kör följande Git-kommandon för att genomföra ändringarna:

git add .
git commit -m "database.php updates"

Din app är klar att distribuera.

Distribuera till Azure

I det här steget distribuerar du din MySQL-anslutna PHP-app till Azure App Service.

Konfigurera en distributionsanvändare

FTP och lokal Git kan distribuera 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 autentiseringsuppgifterna för din Azure-prenumeration.

Konfigurera distributionsanvändaren genom att köra kommandot az webapp deployment user set i Azure Cloud Shell. Ersätt <username> och med ett användarnamn och lösenord för <password> distributionsanvändaren.

• Användarnamnet måste vara unikt i Azure och för lokala Git-pushar 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 App Service-plan

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

{ 
  "adminSiteName": null,
  "appServicePlanName": "myAppServicePlan",
  "geoRegion": "West Europe",
  "hostingEnvironmentProfile": null,
  "id": "/subscriptions/0000-0000/resourceGroups/myResourceGroup/providers/Microsoft.Web/serverfarms/myAppServicePlan",
  "kind": "app",
  "location": "West Europe",
  "maximumNumberOfWorkers": 1,
  "name": "myAppServicePlan",
  < JSON data removed for brevity. >
  "targetWorkerSizeId": 0,
  "type": "Microsoft.Web/serverfarms",
  "workerTierName": null
} 

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

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

# Bash
az webapp create --resource-group myResourceGroup --plan myAppServicePlan --name <app-name> --runtime "PHP|7.2" --deployment-local-git
# PowerShell
az --% webapp create --resource-group myResourceGroup --plan myAppServicePlan --name <app-name> --runtime "PHP|7.2" --deployment-local-git

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",
  "deploymentLocalGitUrl": "https://<username>@<app-name>.scm.azurewebsites.net/<app-name>.git",
  "enabled": true,
  < JSON data removed for brevity. >
}

# Bash
az webapp create --resource-group myResourceGroup --plan myAppServicePlan --name <app-name> --runtime "PHP|7.2" --deployment-local-git
# PowerShell
az --% webapp create --resource-group myResourceGroup --plan myAppServicePlan --name <app-name> --runtime "PHP|7.2" --deployment-local-git

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",
  "deploymentLocalGitUrl": "https://<username>@<app-name>.scm.azurewebsites.net/<app-name>.git",
  "enabled": true,
  < JSON data removed for brevity. >
}

Konfigurera databasinställningarna

I App Service ställer du in miljövariabler som appinställningar med kommandot az webapp config appsettings set.

Följande kommando konfigurerar appinställningarna DB_HOST, DB_DATABASE, DB_USERNAME och DB_PASSWORD. Ersätt platshållarna < app-name> < mysql-server-name>.

az webapp config appsettings set --name <app-name> --resource-group myResourceGroup --settings DB_HOST="<mysql-server-name>.mysql.database.azure.com" DB_DATABASE="sampledb" DB_USERNAME="phpappuser@<mysql-server-name>" DB_PASSWORD="MySQLAzure2017" MYSQL_SSL="true"

Du kan komma åt inställningarna med PHP-metoden getenv. I Laravel-koden används en env-omslutning över PHP getenv. MySQL-konfigurationen i config/database.php ser till exempel ut som följande kod:

'mysql' => [
    'driver'    => 'mysql',
    'host'      => env('DB_HOST', 'localhost'),
    'database'  => env('DB_DATABASE', 'forge'),
    'username'  => env('DB_USERNAME', 'forge'),
    'password'  => env('DB_PASSWORD', ''),
    ...
],

Konfigurera Laravel-miljövariabler

Laravel måste ha en programnyckel i App Service. Du kan konfigurera den med appinställningar.

1. Gå till det lokala terminalfönstret och använd php artisan för att generera en ny programnyckel utan att spara den i .env.

   php artisan key:generate --show
   

2. I Cloud Shell anger du programnyckeln i App Service med hjälp av az webapp config appsettings set kommandot . Ersätt platshållarna < appnamn och>ofphpartisankey:generate <>.

   az webapp config appsettings set --name <app-name> --resource-group myResourceGroup --settings APP_KEY="<output_of_php_artisan_key:generate>" APP_DEBUG="true"
   

   APP_DEBUG="true" säger åt Laravel att returnera felsökningsinformation när den distribuerade appen påträffar fel. När du kör en produktionsapp anger du värdet false, vilket är säkrare.

Ange sökväg till virtuella program

az resource update --name web --resource-group myResourceGroup --namespace Microsoft.Web --resource-type config --parent sites/<app_name> --set properties.virtualApplications[0].physicalPath="site\wwwroot\public" --api-version 2015-06-01

Skicka till Azure från Git

   Counting objects: 3, done.
   Delta compression using up to 8 threads.
   Compressing objects: 100% (3/3), done.
   Writing objects: 100% (3/3), 291 bytes | 0 bytes/s, done.
   Total 3 (delta 2), reused 0 (delta 0)
   remote: Updating branch 'main'.
   remote: Updating submodules.
   remote: Preparing deployment for commit id 'a5e076db9c'.
   remote: Running custom deployment command...
   remote: Running deployment command...
   ...
   < Output has been truncated for readability >
   

   Counting objects: 3, done.
   Delta compression using up to 8 threads.
   Compressing objects: 100% (3/3), done.
   Writing objects: 100% (3/3), 291 bytes | 0 bytes/s, done.
   Total 3 (delta 2), reused 0 (delta 0)
   remote: Updating branch 'main'.
   remote: Updating submodules.
   remote: Preparing deployment for commit id 'a5e076db9c'.
   remote: Running custom deployment command...
   remote: Running deployment command...
   ...
   < Output has been truncated for readability >
   

Bläddra till Azure-appen

Bläddra till http://<app-name>.azurewebsites.net och lägg till några uppgifter i listan.

Grattis! Du kör en datadriven PHP-app i Azure App Service.

Uppdatera modell lokalt och distribuera om

I det här steget gör du en enkel ändring i task-datamodellen och webbappen och publicerar sedan uppdateringen till Azure.

För uppgiftsscenariot ändrar du programmet så att du kan markera en uppgift som slutförd.

Lägga till en kolumn

1. Visa det lokala terminalfönstret och gå till roten för Git-lagringsplatsen.

2. Generera en ny databasmigrering för tasks-tabellen:

   php artisan make:migration add_complete_column --table=tasks
   

3. Det här kommandot visar namnet på migreringsfilen som genereras. Leta reda på filen i database/migrations och öppna den.

4. Ersätt metoden up med följande kod:

   public function up()
   {
       Schema::table('tasks', function (Blueprint $table) {
           $table->boolean('complete')->default(False);
       });
   }
   

   Föregående kod lägger till en boolesk kolumn i tasks-tabellen med namnet complete.

5. Ersätt metoden down med följande kod för återställningsåtgärden:

   public function down()
   {
       Schema::table('tasks', function (Blueprint $table) {
           $table->dropColumn('complete');
       });
   }
   

6. Visa det lokala terminalfönstret och kör Laravel-databasemigreringar för att göra ändringen i den lokala databasen.

   php artisan migrate
   

   Modellen Task (se app/Task.php) mappar till tasks-tabellen som standard, baserat på Laravel-namngivningskonventionen.

Uppdatera programlogik

1. Öppna filen routes/web.php. Här definieras programmets vägar och affärslogik.

2. I slutet av filen lägger du till en väg med följande kod:

   /**
    * Toggle Task completeness
    */
   Route::post('/task/{id}', function ($id) {
       error_log('INFO: post /task/'.$id);
       $task = Task::findOrFail($id);
   
       $task->complete = !$task->complete;
       $task->save();
   
       return redirect('/');
   });
   

   Föregående kod gör en enkel uppdatering till datamodellen genom att ändra värdet för complete.

Uppdatera vyn

1. Öppna filen resources/views/tasks.blade.php. Leta reda på starttaggen <tr> och ersätt den med:

   <tr class="{{ $task->complete ? 'success' : 'active' }}" >
   

   Föregående kod ändrar färg på raden beroende på om uppgiften är slutförd.

2. På nästa rad finns följande kod:

   <td class="table-text"><div>{{ $task->name }}</div></td>
   

   Ersätt hela raden med följande kod:

   <td>
       <form action="{{ url('task/'.$task->id) }}" method="POST">
           {{ csrf_field() }}
   
           <button type="submit" class="btn btn-xs">
               <i class="fa {{$task->complete ? 'fa-check-square-o' : 'fa-square-o'}}"></i>
           </button>
           {{ $task->name }}
       </form>
   </td>
   

   Föregående kod lägger till knappen Skicka som refererar till den väg som du angav tidigare.

Testa ändringarna lokalt

1. Visa det lokala terminalfönstret och kör utvecklingsservern från rotkatalogen på Git-lagringsplatsen.

   php artisan serve
   

2. Om du vill se ändringen i uppgiftsstatusen går du till http://localhost:8000 och markerar kryssrutan.

   

3. Om du vill stoppa PHP skriver du Ctrl + C i terminalen.

Publicera ändringar till Azure

1. Gå till det lokala terminalfönstret och kör Laravel-databasmigreringar med produktionsanslutningssträngen för att genomföra ändringen i Azure-databasen.

   php artisan migrate --env=production --force
   

2. Genomför alla ändringar på Git och skicka sedan kodändringarna till Azure.

   git add .
   git commit -m "added complete checkbox"
   git push azure main
   

3. När git push har slutförts så kan du gå till Azure-appen och prova de nya funktionerna.

   

Om du har lagt till några uppgifter finns de kvar i databasen. Uppdateringar i dataschemat påverkar inte befintliga data.

Strömma diagnostikloggar

az webapp log tail --name <app_name> --resource-group myResourceGroup

az webapp log config --resource-group <resource-group-name> --name <app-name> --docker-container-logging filesystem --level Verbose

az webapp log tail --resource-group <resource-group-name> --name <app-name>

Hantera Azure-appen

1. Gå till Azure-portalen för att hantera den app som du skapade.

2. I den vänstra menyn, klickar du på App Services och därefter på namnet på din Azure-app.

   

   Nu visas översiktssidan för din app. Här kan du utföra grundläggande hanteringsåtgärder som att stoppa, starta, starta om, bläddra och ta bort.

   Menyn till vänster innehåller sidor för att konfigurera appen.

   

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.

Nästa steg

I den här självstudiekursen lärde du dig att:

Gå vidare till nästa självstudie där du får lära dig att mappa ett anpassat DNS-namn till appen.

Eller så kan du kolla in andra resurser: