Criar funções de Web PHP e de trabalho

Artigo
07/24/2024

Descrição geral

Importante

Os Serviços na Nuvem (clássicos) foram preteridos para todos os clientes a partir de 1º de setembro de 2024. Todas as implantações em execução existentes serão interrompidas e encerradas pela Microsoft e os dados serão perdidos permanentemente a partir de outubro de 2024. Novas implantações devem usar o novo modelo de implantação baseado no Azure Resource Manager Serviços de Nuvem do Azure (suporte estendido).

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

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

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

Transfira o Azure SDK para PHP

O SDK do Azure para PHP consiste em vários componentes. Este artigo usa dois deles: Azure PowerShell e os emuladores do Azure. Estes dois componentes podem ser instalados através do Microsoft Web Platform Installer. Para obter mais informações, veja How to install and configure Azure PowerShell (Como instalar e configurar o Azure PowerShell).

Criar um projeto de Serviços de Nuvem

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

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

PS C:\>New-AzureServiceProject myProject

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

Adicionar funções Web ou de trabalho do PHP

Para adicionar uma função Web PHP a um projeto, execute o seguinte comando de dentro do 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

Nota

O roleName parâmetro é opcional. Se for omitido, o nome da função será gerado automaticamente. A primeira função web criada será WebRole1, a segunda será WebRole2, e assim por diante. A primeira função de trabalhador criada será WorkerRole1, a segunda será WorkerRole2, e assim por diante.

Use seu próprio tempo de execução PHP

Em alguns casos, em vez de selecionar um tempo de execução PHP embutido e configurá-lo como descrito anteriormente, você pode querer fornecer seu próprio tempo de execução do PHP. Por exemplo, você pode usar o mesmo tempo de execução do PHP em uma função Web ou de trabalho que você usa em seu ambiente de desenvolvimento. Esse processo facilita a garantia de que o comportamento do aplicativo permaneça o mesmo em seu ambiente de produção.

Configurar uma função Web para usar seu próprio tempo de execução PHP

Para configurar uma função Web para usar um tempo de execução PHP que você fornece, execute estas etapas:

Crie um projeto de Serviço do Azure e adicione uma função Web PHP conforme descrito anteriormente neste artigo.
Crie uma php pasta na pasta que está no diretório raiz da sua função Web e, em bin seguida, adicione o tempo de execução do PHP (todos os binários, arquivos de configuração, subpastas, etc.) à php pasta.
(OPCIONAL) Se o tempo de execução do PHP usa os Drivers da Microsoft para PHP para SQL Server, você precisa configurar sua função Web para instalar o SQL Server Native Client 2012 quando ele for provisionado. Para fazer isso, adicione o instalador sqlncli.msi x64 à bin pasta no diretório raiz da sua função Web. O script de inicialização descrito na próxima etapa executará silenciosamente o instalador quando a função for provisionada. Se o tempo de execução do PHP não usar os Drivers da 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
```

Defina uma tarefa de inicialização que configure o IIS (Serviços de Informações da Internet) para usar o tempo de execução do PHP para lidar com solicitações de .php páginas. Para fazer isso, abra o setup_web.cmd bin arquivo (no arquivo do diretório raiz da sua função Web) em um editor de texto e substitua seu conteúdo pelo seguinte script:

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

Adicione os arquivos do aplicativo ao diretório raiz da função Web, que se torna o diretório raiz do servidor Web.
Publique seu aplicativo conforme descrito na seção Publique seu aplicativo.

Nota

O download.ps1 script (na bin pasta do diretório raiz da função Web) pode ser excluído depois que você seguir as etapas anteriores para usar seu próprio tempo de execução do PHP.

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

Para configurar uma função de trabalho para usar um tempo de execução PHP que você fornece, execute estas etapas:

Crie um projeto do Serviço do Azure e adicione uma função de trabalho PHP conforme descrito anteriormente neste artigo.
Crie uma php pasta no diretório raiz da função de trabalho e, em seguida, adicione seu tempo de execução PHP (todos os binários, arquivos de configuração, subpastas, etc.) à php pasta.
(OPCIONAL) Se o tempo de execução do PHP usa Drivers da Microsoft para PHP para SQL Server, você precisa configurar sua função de trabalho para instalar o SQL Server Native Client 2012 quando ele for provisionado. 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á silenciosamente o instalador quando a função for provisionada. Se o tempo de execução do PHP não usar os Drivers da 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
```

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

@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

Adicione os arquivos do aplicativo ao diretório raiz da função de trabalho.
Publique seu aplicativo conforme descrito na seção Publique seu aplicativo.

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

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

Você deve ter o PHP instalado localmente para usar o emulador de computação. O emulador de computação usa sua instalação PHP local para executar seu aplicativo.

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

PS C:\MyProject> Start-AzureEmulator

A saída de exemplo a seguir é semelhante ao que você deve ver:

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

Você pode ver seu 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 mostrada anteriormente).

Para parar os emuladores, execute este comando:

PS C:\MyProject> Stop-AzureEmulator

Publicar a aplicação

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

Próximos passos

Para obter mais informações, consulte o PHP Developer Center.

Partilhar via