Criar uma aplicação Web PHP no AzureCreate a PHP web app in Azure

Nota

Este artigo implementa uma aplicação no Serviço de Aplicações no Windows.This article deploys an app to App Service on Windows. Para implementar um Serviço de Aplicações no Linux, consulte Criar uma aplicação Web PHP no Serviço de Aplicações no Linux.To deploy to App Service on Linux, see Create a PHP web app in App Service on Linux.

O Serviço de Aplicações do Azure oferece um serviço de alojamento na Web altamente dimensionável e com correção automática.Azure App Service provides a highly scalable, self-patching web hosting service. Este tutorial de início rápido mostra como implantar um aplicativo PHP no serviço Azure App.This quickstart tutorial shows how to deploy a PHP app to Azure App Service. Crie a aplicação Web com a CLI do Azure no Cloud Shell e utilize o Git para implementar o código PHP de exemplo para a aplicação Web.You create the web app using the Azure CLI in Cloud Shell, and you use Git to deploy sample PHP code to the web app.

Aplicação de exemplo em execução no Azure

Pode seguir os passos aqui indicados num computador Mac, Windows ou Linux.You can follow the steps here using a Mac, Windows, or Linux machine. Depois de instalados os pré-requisitos, demora cerca de cinco minutos a concluir todos os passos.Once the prerequisites are installed, it takes about five minutes to complete the steps.

Se você não tiver uma assinatura do Azure, crie uma conta gratuita antes de começar.If you don't have an Azure subscription, create a free account before you begin.

Pré-requisitosPrerequisites

Para concluir este guia de início rápido:To complete this quickstart:

Transferir o exemplo localmenteDownload the sample locally

Numa janela de terminal, execute os comandos seguintes.In a terminal window, run the following commands. Desta forma, o exemplo de aplicação é clonado no seu computador local e é encaminhado para o diretório que contém o código de exemplo.This will clone the sample application to your local machine, and navigate to the directory containing the sample code.

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

Executar a aplicação localmenteRun the app locally

Execute a aplicação localmente, para ver que aspeto deveria ter quando a implemente no Azure.Run the application locally so that you see how it should look when you deploy it to Azure. Abra uma janela do terminal e use o comando php para iniciar o servidor Web PHP incorporado.Open a terminal window and use the php command to launch the built-in PHP web server.

php -S localhost:8080

Abra um browser e navegue para a aplicação de exemplo em http://localhost:8080.Open a web browser, and navigate to the sample app at http://localhost:8080.

Pode ver a mensagem Olá, mundo!You see the Hello World! da aplicação de exemplo apresentada na página.message from the sample app displayed in the page.

Aplicação de exemplo em execução localmente

Na janela do terminal, prima Ctrl+C para desligar o servidor Web.In your terminal window, press Ctrl+C to exit the web server.

Utilizar o Azure Cloud ShellUse Azure Cloud Shell

O Azure hospeda Azure Cloud Shell, um ambiente de shell interativo que você pode usar por meio de seu navegador.Azure hosts Azure Cloud Shell, an interactive shell environment that you can use through your browser. Cloud Shell permite que você use bash o PowerShell ou o para trabalhar com os serviços do Azure.Cloud Shell lets you use either bash or PowerShell to work with Azure services. Você pode usar os comandos pré-instalados Cloud Shell para executar o código neste artigo sem precisar instalar nada em seu ambiente local.You can use the Cloud Shell pre-installed commands to run the code in this article without having to install anything on your local environment.

Para iniciar o Azure Cloud Shell:To launch Azure Cloud Shell:

OpçãoOption Exemplo/linkExample/Link
Selecione Experimentar no canto superior direito de um bloco de código.Select Try It in the upper-right corner of a code block. A seleção de try não copia automaticamente o código para Cloud Shell.Selecting Try It doesn't automatically copy the code to Cloud Shell. Exemplo de teste para Azure Cloud Shell
Vá para https://shell.azure.com ou selecione o botão Iniciar Cloud Shell para abrir Cloud Shell em seu navegador.Go to https://shell.azure.com or select the Launch Cloud Shell button to open Cloud Shell in your browser. Iniciar Cloud Shell em uma nova janelaLaunch Cloud Shell in a new window
Selecione o botão Cloud Shell na barra de menus superior direita na portal do Azure.Select the Cloud Shell button on the top-right menu bar in the Azure portal. Botão Cloud Shell no portal do Azure

Para executar o código neste artigo em Azure Cloud Shell:To run the code in this article in Azure Cloud Shell:

  1. Iniciar Cloud Shell.Launch Cloud Shell.

  2. Selecione o botão copiar em um bloco de código para copiar o código.Select the Copy button on a code block to copy the code.

  3. Cole o código na sessão de Cloud shell com Ctrl+Shift+v no Windows e Linux, ou cmd+Shift+v no MacOS.Paste the code into the Cloud Shell session with Ctrl+Shift+V on Windows and Linux, or Cmd+Shift+V on macOS.

  4. Pressione Enter para executar o código.Press Enter to run the code.

Configurar um utilizador de implementaçãoConfigure a deployment user

FTP e local Git podem implementar uma aplicação web do Azure ao utilizar um utilizador de implementação.FTP and local Git can deploy to an Azure web app by using a deployment user. Depois de configurar o seu utilizador de implementação, pode usá-lo para todas as suas implementações do Azure.Once you configure your deployment user, you can use it for all your Azure deployments. O nome de utilizador de implementação ao nível da conta e palavra-passe são diferentes das credenciais da sua subscrição do Azure.Your account-level deployment username and password are different from your Azure subscription credentials.

Para configurar o utilizador de implementação, execute o conjunto de usuários do az webapp deployment comando no Azure Cloud Shell.To configure the deployment user, run the az webapp deployment user set command in Azure Cloud Shell. Substitua <nome de utilizador > e <palavra-passe > com um nome de utilizador de utilizador de implementação e a palavra-passe.Replace <username> and <password> with a deployment user username and password.

  • O nome de utilizador tem de ser exclusivo no Azure e para local Git pushes, não pode conter o ' @' símbolo.The username must be unique within Azure, and for local Git pushes, must not contain the ‘@’ symbol.
  • A palavra-passe tem de ser, pelo menos, oito carateres de comprimento, com dois dos seguintes três elementos: letras, números e símbolos.The password must be at least eight characters long, with two of the following three elements: letters, numbers, and symbols.
az webapp deployment user set --user-name <username> --password <password>

A saída JSON mostra a palavra-passe como null.The JSON output shows the password as null. Se obtiver o erro 'Conflict'. Details: 409, altere o nome de utilizador.If you get a 'Conflict'. Details: 409 error, change the username. Se obtiver o 'Bad Request'. Details: 400 erro, utilize uma palavra-passe mais forte.If you get a 'Bad Request'. Details: 400 error, use a stronger password.

Registe o seu nome de utilizador e palavra-passe para utilizar para implementar as suas aplicações web.Record your username and password to use to deploy your web apps.

Criar um grupo de recursosCreate a resource group

Um grupo de recursos é um contentor lógico em que os recursos do Azure, como aplicações Web, bases de dados e contas de armazenamento são implementados e geridos.A resource group is a logical container into which Azure resources like web apps, databases, and storage accounts are deployed and managed. Por exemplo, pode optar por eliminar todo o grupo de recursos num único passo simples mais tarde.For example, you can choose to delete the entire resource group in one simple step later.

No Cloud Shell, crie um grupo de recursos com o comando az group create.In the Cloud Shell, create a resource group with the az group create command. O exemplo seguinte cria um grupo de recursos com o nome myResourceGroup, na localização Europa Ocidental.The following example creates a resource group named myResourceGroup in the West Europe location. Para ver todas as localizações suportadas para o Serviço de Aplicações no escalão Gratuito, execute o comando az appservice list-locations --sku FREE.To see all supported locations for App Service in Free tier, run the az appservice list-locations --sku FREE command.

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

Geralmente, o grupo de recursos e os recursos são criados numa região perto de si.You generally create your resource group and the resources in a region near you.

Quando o comando for concluído, uma saída JSON mostra as propriedades do grupo de recursos.When the command finishes, a JSON output shows you the resource group properties.

Criar um plano do Serviço de Aplicações do AzureCreate an Azure App Service plan

No Cloud Shell, crie um plano do Serviço de Aplicações com o comando az appservice plan create.In the Cloud Shell, create an App Service plan with the az appservice plan create command.

O exemplo seguinte cria um plano do Serviço de Aplicações com o nome myAppServicePlan, que utiliza o escalão de preços Gratuito.The following example creates an App Service plan named myAppServicePlan in the Free pricing tier:

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

Quando o plano do Serviço de Aplicações tiver sido criado, a CLI do Azure mostra informações semelhantes ao seguinte exemplo:When the App Service plan has been created, the Azure CLI shows information similar to the following example:

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

Criar uma aplicação WebCreate a web app

No Cloud Shell, crie uma aplicação Web no plano do Serviço de Aplicações myAppServicePlan com o comando az webapp create.In the Cloud Shell, create a web app in the myAppServicePlan App Service plan with the az webapp create command.

No exemplo a seguir, substitua <app_name> com um nome de aplicação globalmente exclusivo (os carateres válidos são a-z, 0-9 e -).In the following example, replace <app_name> with a globally unique app name (valid characters are a-z, 0-9, and -). O runtime está definido como PHP|7.0.The runtime is set to PHP|7.0. Para ver todos os runtimes suportados, execute az webapp list-runtimes.To see all supported runtimes, run az webapp list-runtimes.

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

Quando a aplicação Web tiver sido criada, a CLI do Azure mostra informações semelhantes ao seguinte exemplo:When the web app has been created, the Azure CLI shows output similar to the following example:

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

Criou uma nova aplicação Web vazia, com a implementação de git ativada.You’ve created an empty new web app, with git deployment enabled.

Nota

O URL do Git remoto é apresentado na propriedade deploymentLocalGitUrl, com o formato https://<username>@<app_name>.scm.azurewebsites.net/<app_name>.git.The URL of the Git remote is shown in the deploymentLocalGitUrl property, with the format https://<username>@<app_name>.scm.azurewebsites.net/<app_name>.git. Guarde este URL, uma vez que vai precisar dele mais tarde.Save this URL as you need it later.

Navegue para a sua aplicação Web recentemente criada.Browse to your newly created web app. Substitua o <nome da aplicação > pelo nome exclusivo da aplicação criada no passo anterior.Replace <app name> with your unique app name created in the prior step.

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

A aplicação Web deve ter o seguinte aspeto:Here is what your new web app should look like:

Página da aplicação Web vazia

Enviar para o Azure a partir do GitPush to Azure from Git

Regresse à janela de terminal local e adicione um remoto do Azure ao seu repositório Git local.Back in the local terminal window, add an Azure remote to your local Git repository. Substitua <deploymentLocalGitUrl-from-create-step> pelo URL do Git remoto que guardou em Criar uma aplicação Web.Replace <deploymentLocalGitUrl-from-create-step> with the URL of the Git remote that you saved from Create a web app.

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

Envie para o remoto do Azure para implementar a sua aplicação com o comando seguinte.Push to the Azure remote to deploy your app with the following command. Quando lhe forem pedidas credenciais pelo Gestor de credenciais do Git, certifique-se de que introduz as credenciais que criou em configurar um utilizador de implementação, não as credenciais de que utiliza para iniciar sessão no portal do Azure.When prompted for credentials by Git Credential Manager, make sure that you enter the credentials you created in Configure a deployment user, not the credentials you use to sign in to the Azure portal.

git push azure master

Este comando pode demorar alguns minutos a ser executado.This command may take a few minutes to run. Ao executar, apresenta informações semelhantes ao exemplo seguinte:While running, it displays information similar to the following example:

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 'master'.
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  master -> master

Navegar para a aplicaçãoBrowse to the app

Utilize o browser para navegar para a aplicação implementada.Browse to the deployed application using your web browser.

http://<app_name>.azurewebsites.net

O código PHP de exemplo está em execução numa aplicação Web do serviço de aplicações do Azure.The PHP sample code is running in an Azure App Service web app.

Aplicação de exemplo em execução no Azure

Parabéns!Congratulations! Implementou a sua primeira aplicação PHP no Serviço de Aplicações.You've deployed your first PHP app to App Service.

Atualizar localmente e reimplementar o códigoUpdate locally and redeploy the code

Utilizando um editor de texto local, abra o ficheiro index.php na aplicação PHP e faça uma pequena alteração ao texto na cadeia junto a echo:Using a local text editor, open the index.php file within the PHP app, and make a small change to the text within the string next to echo:

echo "Hello Azure!";

Na janela terminal local, consolide as suas alterações no Git e envie as alterações ao código para o Azure.In the local terminal window, commit your changes in Git, and then push the code changes to Azure.

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

Depois de concluída a implementação, volte para a janela do browser aberta durante o passo Navegar para a aplicação e atualize a página.Once deployment has completed, return to the browser window that opened during the Browse to the app step, and refresh the page.

Aplicação de exemplo atualizada em execução no Azure

Gerenciar seu novo aplicativo do AzureManage your new Azure app

Aceda ao portal do Azure para gerir a aplicação Web que criou.Go to the Azure portal to manage the web app you created.

No menu à esquerda, clique em serviços de aplicativose, em seguida, clique no nome do seu aplicativo do Azure.From the left menu, click App Services, and then click the name of your Azure app.

Navegação do portal para a aplicação do Azure

Será apresentada a página Descrição geral da sua aplicação Web.Your web app's Overview page will be displayed. Aqui, pode realizar tarefas de gestão básicas, como navegar, parar, iniciar, reiniciar e eliminar.Here, you can perform basic management tasks like browse, stop, start, restart, and delete.

Página Serviço de Aplicações no portal do Azure

O menu esquerdo fornece diferentes opções para configurar a aplicação.The left menu provides different options for configuring your app.

Limpar recursosClean up resources

Nos passos anteriores, criou os recursos do Azure num grupo de recursos.In the preceding steps, you created Azure resources in a resource group. Se achar que não vai precisar destes recursos no futuro, execute o seguinte comando no Cloud Shell para eliminar o grupo de recursos:If you don't expect to need these resources in the future, delete the resource group by running the following command in the Cloud Shell:

az group delete --name myResourceGroup

Este comando pode demorar alguns minutos a ser executado.This command may take a minute to run.

Passos seguintesNext steps