Criar um aplicativo Web do PHP no AzureCreate a PHP web app in Azure

Observação

Este artigo implanta um aplicativo no Serviço de Aplicativo no Windows.This article deploys an app to App Service on Windows. Para implantar o Serviço de Aplicativo em Linux, consulte Criar um aplicativo Web PHP no Serviço de Aplicativo em Linux.To deploy to App Service on Linux, see Create a PHP web app in App Service on Linux.

O Serviço de Aplicativo do Azure fornece um serviço de hospedagem na Web altamente escalonável e com aplicação automática de patches.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 de Aplicativo do Azure.This quickstart tutorial shows how to deploy a PHP app to Azure App Service. Crie o aplicativo Web usando a CLI do Azure no Cloud Shell e use o Git para implantar o código PHP de exemplo para o aplicativo 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.

Aplicativo de exemplo em execução no Azure

Você pode seguir as etapas aqui usando um computador Mac, Windows ou Linux.You can follow the steps here using a Mac, Windows, or Linux machine. A conclusão das etapas demora cerca de cinco minutos assim que os pré-requisitos são instalados.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:

Baixar o exemplo localmenteDownload the sample locally

Em uma janela de terminal, execute os comandos a seguir.In a terminal window, run the following commands. Isso clonará o aplicativo de exemplo no computador local e fará com que você navegue até 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 o aplicativo localmenteRun the app locally

Execute o aplicativo no local para ver como ele deve ficar quando o implantar 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 do PHP interno.Open a terminal window and use the php command to launch the built-in PHP web server.

php -S localhost:8080

Abra um navegador da Web e navegue até o aplicativo de exemplo em http://localhost:8080.Open a web browser, and navigate to the sample app at http://localhost:8080.

Você verá o Olá, Mundo!You see the Hello World! mensagem do aplicativo de exemplo exibida na página.message from the sample app displayed in the page.

Aplicativo de exemplo em execução local

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

Usar o Azure Cloud ShellUse Azure Cloud Shell

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

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

OpçãoOption Exemplo/LinkExample/Link
Selecione Experimente no canto superior direito de um bloco de código.Select Try It in the upper-right corner of a code block. Selecionar Experimente não copia automaticamente o código para o Cloud Shell.Selecting Try It doesn't automatically copy the code to Cloud Shell. Exemplo de “Experimente” no Azure Cloud Shell
Acesse https://shell.azure.com ou selecione o botão Iniciar o Cloud Shell para abri-lo no navegador.Go to https://shell.azure.com, or select the Launch Cloud Shell button to open Cloud Shell in your browser. Inicie o Cloud Shell em uma nova janelaLaunch Cloud Shell in a new window
Clique no botão Cloud Shell na barra de menus no canto superior direito do 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 no Azure Cloud Shell:To run the code in this article in Azure Cloud Shell:

  1. Inicie o Cloud Shell.Start Cloud Shell.

  2. Clique no botão Copiar no bloco de código para copiá-lo.Select the Copy button on a code block to copy the code.

  3. Cole o código na sessão do Cloud Shell ao pressionar Ctrl+Shift+V no Windows e no Linux ou Cmd+Shift+V no macOS.Paste the code into the Cloud Shell session by selecting Ctrl+Shift+V on Windows and Linux or by selecting Cmd+Shift+V on macOS.

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

Configurar um usuário de implantaçãoConfigure a deployment user

O FTP e o Git local podem implantar em um aplicativo Web do Azure usando um usuário de implantação.FTP and local Git can deploy to an Azure web app by using a deployment user. Após configurar o usuário de implantação, use-o em todas as implantações do Azure.Once you configure your deployment user, you can use it for all your Azure deployments. O nome de usuário e a senha da implantação no nível da conta são diferentes das credenciais de assinatura do Azure.Your account-level deployment username and password are different from your Azure subscription credentials.

Para configurar o usuário de implantação, execute o comando az webapp deployment user set no Azure Cloud Shell.To configure the deployment user, run the az webapp deployment user set command in Azure Cloud Shell. Substitua <username> e <password> pelo nome de usuário e a senha do usuário de implantação.Replace <username> and <password> with a deployment user username and password.

  • O nome de usuário deve ser exclusivo no Azure. Para envios por push do Git local, não deve conter o símbolo "@".The username must be unique within Azure, and for local Git pushes, must not contain the ‘@’ symbol.
  • A senha deve ter pelo menos oito caracteres, com dois destes três elementos: letras, números, 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 senha como null.The JSON output shows the password as null. Se receber um erro 'Conflict'. Details: 409, altere o nome de usuário.If you get a 'Conflict'. Details: 409 error, change the username. Se receber um erro 'Bad Request'. Details: 400, use uma senha mais forte.If you get a 'Bad Request'. Details: 400 error, use a stronger password.

Registre seu nome de usuário e senha para usá-los na implantação de aplicativos 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 contêiner lógico no qual os recursos do Azure, como aplicativos Web, bancos de dados e contas de armazenamento, são implantados e gerenciados.A resource group is a logical container into which Azure resources like web apps, databases, and storage accounts are deployed and managed. Por exemplo, é possível excluir posteriormente todo o grupo de recursos com uma única etapa simples.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 a seguir cria um grupo de recursos chamado myResourceGroup no local Europa Ocidental.The following example creates a resource group named myResourceGroup in the West Europe location. Para ver todos os locais com suporte para o Serviço de Aplicativo no nível 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"

Em geral, você cria seu grupo de recursos e os recursos em uma região próxima a você.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 Aplicativo do AzureCreate an Azure App Service plan

No Cloud Shell, crie um plano do Serviço de Aplicativo 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 a seguir cria um plano do Serviço de Aplicativo denominado myAppServicePlan usando o tipo de preço Gratuita: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 Aplicativo for criado, a CLI do Azure mostrará informações semelhantes ao exemplo a seguir: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 um aplicativo WebCreate a web app

No Cloud Shell, crie um aplicativo Web no plano do Serviço de Aplicativo do 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> por um nome do aplicativo exclusivo globalmente (os caracteres 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 -). A execução é predefinida para PHP|7.0.The runtime is set to PHP|7.0. Para ver todos os runtimes com suporte, 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 o aplicativo Web for criado, a CLI do Azure mostrará um resultado semelhante 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. >
}

Você criou um novo aplicativo Web vazio com a implantação do Git habilitada.You’ve created an empty new web app, with git deployment enabled.

Observação

A URL do Git remoto é mostrada 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. Salve essa URL, pois você precisará dela mais tarde.Save this URL as you need it later.

Navegue até o aplicativo Web recém-criado.Browse to your newly created web app. Substitua <app name> pelo seu nome de aplicativo exclusivo criado na etapa anterior.Replace <app name> with your unique app name created in the prior step.

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

Seu novo aplicativo Web deve ficar assim:Here is what your new web app should look like:

Página de aplicativo Web vazia

Enviar do Git para o AzurePush to Azure from Git

De volta na janela do terminal local, adicione um remoto do Azure ao repositório Git local.Back in the local terminal window, add an Azure remote to your local Git repository. Substitua <deploymentLocalGitUrl-from-create-step> pela URL do Git remoto que você salvou de Criar um aplicativo 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 por push para o Azure remoto para implantar seu aplicativo com o comando a seguir.Push to the Azure remote to deploy your app with the following command. Quando solicitado a fornecer credenciais pelo Gerenciador de Credenciais do Git, insira as credenciais criadas em Configurar um usuário de implantação, não as credenciais usadas para entrar 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

Esse comando pode demorar um pouco para ser executado.This command may take a few minutes to run. Na execução, ele exibe informações semelhantes ao seguinte exemplo: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 até o aplicativoBrowse to the app

Navegue até o aplicativo implantado usando o navegador da Web.Browse to the deployed application using your web browser.

http://<app_name>.azurewebsites.net

O código de exemplo do PHP está em execução em um aplicativo Web do Serviço de Aplicativo do Azure.The PHP sample code is running in an Azure App Service web app.

Aplicativo de exemplo em execução no Azure

Parabéns!Congratulations! Você implantou seu primeiro aplicativo PHP no Serviço de Aplicativo.You've deployed your first PHP app to App Service.

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

Usando um editor de texto local, abra o arquivo index.php no aplicativo do PHP e faça uma pequena alteração no texto dentro da cadeia de caracteres para 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 do terminal local, confirme suas alterações no Git e então envie por push as alterações do 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 que a implantação for concluída, retorne para a janela do navegador que foi aberta durante a etapa Navegar até o aplicativo 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.

Aplicativo de exemplo atualizado em execução no Azure

Gerenciar seu novo aplicativo do AzureManage your new Azure app

  1. Vá para o portal do Azure para gerenciar o aplicativo Web que você criou.Go to the Azure portal to manage the web app you created. Pesquise e selecione Serviços de Aplicativos.Search for and select App Services.

    Pesquisar Serviços de Aplicativos, portal do Azure, criar aplicativo Web PHP

  2. Selecione o nome do seu aplicativo do Azure.Select the name of your Azure app.

    Navegação no Portal para o aplicativo do Azure

    A página Visão Geral do seu aplicativo Web será exibida.Your web app's Overview page will be displayed. Aqui você pode executar tarefas básicas de gerenciamento como Procurar, Parar, Reiniciar e Excluir.Here, you can perform basic management tasks like Browse, Stop, Restart, and Delete.

    Página Serviço de Aplicativo no portal do Azure

    O menu do aplicativo Web fornece opções diferentes para configurar seu aplicativo.The web app menu provides different options for configuring your app.

Limpar recursosClean up resources

Nas etapas anteriores, você criou os recursos do Azure em um grupo de recursos.In the preceding steps, you created Azure resources in a resource group. Se você acha que não precisará desses recursos no futuro, exclua o grupo de recursos executando o seguinte comando no Cloud Shell: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

Esse comando pode demorar um pouco para ser executado.This command may take a minute to run.

Próximas etapasNext steps