Criar funções de trabalho e funções Web de PHP

Visão geral

Este guia mostrará como criar funções Web ou de trabalho do PHP em um ambiente de desenvolvimento Windows, como escolher uma versão específica do PHP nas versões "internas" disponíveis, como alterar a configuração do PHP, habilitar extensões e, finalmente, como implantar no Azure. Também descreve como configurar uma função Web ou de trabalho para usar um runtime do PHP (com configuração e extensões personalizadas) que você fornece.

O Azure fornece três modelos de computação para a execução de aplicativos: Serviço de Aplicativo do Azure, Máquinas Virtuais do Azure e Serviços de Nuvem do Azure. Todos os três modelos oferecem suporte ao PHP. Os Serviços de Nuvem, que incluem as funções Web e de trabalho, fornecem a PaaS (plataforma como serviço). Dentro de um serviço de nuvem, uma função web fornece um servidor Web de IIS (Serviços de Informações da Internet) dedicado, usado para hospedar aplicativos Web de front-end. Uma função de trabalho pode executar tarefas assíncronas, de execução longa ou perpétuas, independentemente da interação do usuário ou da entrada.

Para obter mais informações sobre essas opções, consulte Opções de hospedagem de computação fornecidas pelo Azure.

Baixar o SDK do Azure para PHP

O SDK do Azure para PHP consiste em vários componentes. Este artigo usará dois deles: o Azure PowerShell e os emuladores do Azure. Esses dois componentes podem ser instalados pelo Microsoft Web Platform Installer. Para obter mais informações, confira Como instalar e configurar o Azure PowerShell.

Criar um projeto de Serviço de Nuvem

A primeira etapa na criação de uma função Web ou de trabalho do PHP é criar um projeto de Serviço do Azure. um projeto de Serviço do Azure serve como um contêiner lógico para as funções da Web e de trabalho, e contém os arquivos de definição do serviço (.csdef) e configuração do serviço (.cscfg) do projeto.

Para criar um novo projeto de Serviço do Azure, execute o Azure PowerShell como administrador e execute o seguinte comando:

PS C:\>New-AzureServiceProject myProject

Esse comando criará um novo diretório (myProject) ao qual você pode adicionar funções Web e de trabalho.

Adicionar funções de trabalho ou Web PHP

Para adicionar uma função Web do PHP a um projeto, execute o seguinte comando no diretório raiz do projeto:

PS C:\myProject> Add-AzurePHPWebRole roleName

Para uma função de trabalho, use este comando:

PS C:\myProject> Add-AzurePHPWorkerRole roleName

Usar seu próprio runtime PHP

Em alguns casos, em vez de selecionar um runtime do PHP interno e configurá-lo conforme descrito acima, você pode desejar fornecer seu próprio runtime do PHP. Por exemplo, você pode usar o mesmo runtime do PHP em uma função Web ou de trabalho que você usa no seu ambiente de desenvolvimento. Isso torna mais fácil garantir que o aplicativo não mudará o comportamento no ambiente de produção.

Configurar uma função web para usar o seu próprio runtime do PHP

Para configurar uma função web para usar um runtime do PHP fornecido por você, siga as etapas a seguir:

1. Crie um projeto de Serviço do Azure e adicione uma função Web do PHP conforme descrito anteriormente neste tópico.

2. Crie uma pasta php na pasta bin que está no diretório raiz de sua função web e adicione o runtime do PHP (todos os binários, arquivos de configuração, subpastas etc.) à pasta php.

3. (OPCIONAL) Se o runtime do PHP usar os Drivers da Microsoft para PHP para SQL Server, você precisará configurar a função Web para instalar o SQL Server Native Client 2012 quando ela for provisionada. Para fazer isso, adicione o instalador sqlncli.msi x64 à pasta bin no diretório-raiz de sua função Web. O script de inicialização descrito na próxima etapa executará o instalador silenciosamente quando a função for provisionada. Se o runtime do PHP não usar os Drivers Microsoft para PHP para SQL Server, você poderá remover a seguinte linha do script mostrado na próxima etapa:

   msiexec /i sqlncli.msi /qn IACCEPTSQLNCLILICENSETERMS=YES
   

4. Defina uma tarefa de inicialização que configura os Serviços de Informações da Internet (IIS) para usar o runtime do PHP para manipular solicitações de páginas .php. Para fazer isso, abra o arquivo setup_web.cmd (no arquivo bin do diretório raiz da função web) em um editor de texto e substitua seu conteúdo pelo script a seguir:

   @ECHO ON
   cd "%~dp0"
   
   if "%EMULATED%"=="true" exit /b 0
   
   msiexec /i sqlncli.msi /qn IACCEPTSQLNCLILICENSETERMS=YES
   
   SET PHP_FULL_PATH=%~dp0php\php-cgi.exe
   SET NEW_PATH=%PATH%;%RoleRoot%\base\x86
   
   %WINDIR%\system32\inetsrv\appcmd.exe set config -section:system.webServer/fastCgi /+"[fullPath='%PHP_FULL_PATH%',maxInstances='12',idleTimeout='60000',activityTimeout='3600',requestTimeout='60000',instanceMaxRequests='10000',protocol='NamedPipe',flushNamedPipe='False']" /commit:apphost
   %WINDIR%\system32\inetsrv\appcmd.exe set config -section:system.webServer/fastCgi /+"[fullPath='%PHP_FULL_PATH%'].environmentVariables.[name='PATH',value='%NEW_PATH%']" /commit:apphost
   %WINDIR%\system32\inetsrv\appcmd.exe set config -section:system.webServer/fastCgi /+"[fullPath='%PHP_FULL_PATH%'].environmentVariables.[name='PHP_FCGI_MAX_REQUESTS',value='10000']" /commit:apphost
   %WINDIR%\system32\inetsrv\appcmd.exe set config -section:system.webServer/handlers /+"[name='PHP',path='*.php',verb='GET,HEAD,POST',modules='FastCgiModule',scriptProcessor='%PHP_FULL_PATH%',resourceType='Either',requireAccess='Script']" /commit:apphost
   %WINDIR%\system32\inetsrv\appcmd.exe set config -section:system.webServer/fastCgi /"[fullPath='%PHP_FULL_PATH%'].queueLength:50000"
   

5. Adicione os arquivos do aplicativo ao diretório raiz da função Web. Esse será o diretório raiz do servidor web.

6. Publique seu aplicativo como descrito na seção abaixo, Publicar seu aplicativo.

Configurar uma função de trabalho para usar o seu próprio runtime do PHP

Para configurar uma função de trabalho para usar um runtime do PHP fornecido por você, siga as etapas a seguir:

1. Crie um projeto de Serviço do Azure e adicione uma função de trabalho do PHP conforme descrito anteriormente neste tópico.

2. Crie uma pasta php no diretório raiz de sua função de trabalho e adicione o runtime do PHP (todos os binários, arquivos de configuração, subpastas etc.) para a pasta php.

3. (OPCIONAL) Se o runtime do PHP usar Drivers da Microsoft para PHP para SQL Server, você precisará configurar a função de trabalho para instalar o SQL Server Native Client 2012 quando ela for provisionada. Para fazer isso, adicione o instalador sqlncli.msi x64 ao diretório raiz da função de trabalho. O script de inicialização descrito na próxima etapa executará o instalador silenciosamente quando a função for provisionada. Se o runtime do PHP não usar os Drivers Microsoft para PHP para SQL Server, você poderá remover a seguinte linha do script mostrado na próxima etapa:

   msiexec /i sqlncli.msi /qn IACCEPTSQLNCLILICENSETERMS=YES
   

4. Defina uma tarefa de inicialização que adiciona o executável php.exe à variável de ambiente PATH da função de trabalho quando a função é configurada. Para fazer isso, abra o arquivo setup_worker.cmd (no diretório raiz da função de trabalho) em um editor de texto e substitua seu conteúdo pelo script a seguir:

   @echo on
   
   cd "%~dp0"
   
   echo Granting permissions for Network Service to the web root directory...
   icacls ..\ /grant "Network Service":(OI)(CI)W
   if %ERRORLEVEL% neq 0 goto error
   echo OK
   
   if "%EMULATED%"=="true" exit /b 0
   
   msiexec /i sqlncli.msi /qn IACCEPTSQLNCLILICENSETERMS=YES
   
   setx Path "%PATH%;%~dp0php" /M
   
   if %ERRORLEVEL% neq 0 goto error
   
   echo SUCCESS
   exit /b 0
   
   :error
   
   echo FAILED
   exit /b -1
   

5. Adicione os arquivos do aplicativo ao diretório raiz da função de trabalho.

6. Publique seu aplicativo como descrito na seção abaixo, Publicar seu aplicativo.

Executar seu aplicativo nos emuladores de computação e de armazenamento

Os emuladores do Azure fornecem um ambiente local no qual você pode testar seu aplicativo do Azure antes de implantá-lo na nuvem. Existem algumas diferenças entre os emuladores e o ambiente do Azure. Para entender isso melhor, confira Usar o emulador do Armazenamento do Azure para desenvolvimento e teste.

Observe que você deve ter instalado o PHP localmente para usar o emulador de computação. O emulador de computação usará sua instalação local do PHP para executar o aplicativo.

Para executar seu projeto nos emuladores, execute o seguinte comando no diretório raiz do projeto:

PS C:\MyProject> Start-AzureEmulator

Você verá uma saída semelhante a essa:

Creating local package...
Starting Emulator...
Role is running at http://127.0.0.1:81
Started

Você pode ver o aplicativo em execução no emulador abrindo um navegador da Web e navegando até o endereço local mostrado na saída (http://127.0.0.1:81 na saída de exemplo acima).

Para parar os emuladores, execute este comando:

PS C:\MyProject> Stop-AzureEmulator

Publicar seu aplicativo

Para publicar seu aplicativo, você precisa primeiro importar suas configurações de publicação usando o cmdlet Import-AzurePublishSettingsFile . Em seguida, você pode publicar o aplicativo usando o cmdlet Publish-AzureServiceProject . Para obter informações sobre como entrar, confira Como instalar e configurar o Azure PowerShell.

Próximas etapas

Para obter mais informações, consulte o Centro de Desenvolvimento PHP.