Creación de roles web y de trabajo para PHP

Información general

En esta guía se explica cómo crear roles de trabajo o web de PHP en un entorno de desarrollo de Windows, elegir una versión específica de PHP de versiones "integradas" disponibles, cambiar la configuración de PHP, habilitar extensiones y, por último, implementar en Azure. También se describe cómo configurar un rol web o de trabajo para usar un tiempo de ejecución de PHP (con las extensiones y la configuración personalizada) proporcionado por el usuario.

Azure ofrece tres modelos de proceso para la ejecución de aplicaciones: Azure App Service, Azure Virtual Machines y Azure Cloud Services. Los tres modelos admiten PHP. Cloud Services, que incluye roles web y de trabajo, ofrece el modelo Plataforma como servicio (PaaS). Dentro de un servicio en la nube, un rol web proporciona un servidor web de Internet Information Services (IIS) dedicado para hospedar aplicaciones web front-end. Un rol de trabajo puede ejecutar tareas asincrónicas, de ejecución prolongada o perpetuas, independientes de la entrada o la interacción del usuario.

Para más información sobre estas opciones, consulte Cálculo de las opciones de hospedaje proporcionadas por Azure.

Descarga del SDK de Azure para PHP

El SDK de Azure para PHP tiene varios componentes. Este artículo usará dos de ellos: los emuladores de Azure PowerShell y de Azure. Estos dos componentes se pueden instalar a través del instalador de la plataforma web de Microsoft. Para obtener más información, consulte Instalación y configuración de Azure PowerShell.

Creación de un proyecto de Cloud Services

El primer paso para crear un rol web o de trabajo de PHP es crear un proyecto del servicio de Azure. El primer paso para crear un rol web o de trabajo de PHP es crear un proyecto del servicio de Azure. Un proyecto del servicio de Azure sirve como un contenedor lógico para roles web y de trabajo y contiene los archivos de definición del servicio (.csdef) y configuración del servicio (.cscfg) del proyecto.

Para crear un proyecto nuevo del servicio de Azure, ejecute Azure PowerShell como administrador y, a continuación, ejecute el comando siguiente:

PS C:\>New-AzureServiceProject myProject

Este comando creará un directorio nuevo (myProject) al que puede agregar roles web y de trabajo.

de roles web y de trabajo de PHP

Para agregar un rol web de PHP a un proyecto, ejecute el siguiente comando desde el directorio raíz del proyecto:

PS C:\myProject> Add-AzurePHPWebRole roleName

Para un rol de trabajo, use este comando:

PS C:\myProject> Add-AzurePHPWorkerRole roleName

del tiempo de ejecución de PHP propio

En algunos casos, en lugar de seleccionar un tiempo de ejecución de PHP integrado y configurarlo como se ha descrito anteriormente, puede proporcionar el tiempo de ejecución de PHP propio. Por ejemplo, puede usar el mismo tiempo de ejecución de PHP en un rol web o de trabajo que use en el entorno de desarrollo. De esta forma, garantiza de forma más fácil que la aplicación no cambiará su comportamiento en el entorno de producción.

Configuración de un rol web para usar un tiempo de ejecución de PHP propio

Para configurar un rol web para usar un tiempo de ejecución de PHP proporcionado por el usuario, siga estos pasos:

1. Cree un proyecto del servicio de Azure y agregue un rol web de PHP según se describe anteriormente en este tema.

2. Cree una carpeta php en la carpeta bin que se encuentra en el directorio raíz del rol web y, a continuación, agregue el tiempo de ejecución de PHP (todos los binarios, archivos de configuración, subcarpetas, etc.) a la carpeta php.

3. (OPCIONAL) Si el runtime de PHP usa los controladores de Microsoft para PHP en SQL Server, tendrá que configurar el rol web para instalar SQL Server Native Client 2012 cuando se aprovisione. Para ello, agregue el instalador sqlncli.msi x64 a la carpeta bin en el directorio raíz del rol web. El script de inicio descrito en el siguiente paso ejecutará el instalador silenciosamente cuando se aprovisione el rol. Si el tiempo de ejecución de PHP no usa los controladores de Microsoft para PHP en SQL Server, puede eliminar la línea siguiente del script que se muestra en el paso siguiente:

   msiexec /i sqlncli.msi /qn IACCEPTSQLNCLILICENSETERMS=YES
   

4. Defina una tarea de inicio que configure Internet Information Services (IIS) para que use el runtime de PHP, con el fin de que controlar las solicitudes para las páginas .php. Para ello, abra el archivo setup_web.cmd (en el archivo bin del directorio raíz del rol web) en un editor de texto y reemplace su contenido por el script siguiente:

   @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. Agregue los archivos de la aplicación al directorio raíz del rol web. Será el directorio raíz del servidor web.

6. Publique la aplicación como se describe en la sección Publicación de la aplicación más adelante.

Configuración de un rol de trabajo para usar un tiempo de ejecución de PHP propio

Para configurar un rol de trabajo para usar un tiempo de ejecución de PHP propio, siga estos pasos:

1. Cree un proyecto del servicio de Azure y agregue un rol de trabajo de PHP según se describe anteriormente en este tema.

2. Cree una carpeta php en el directorio raíz del rol de trabajo y, a continuación, agregue el tiempo de ejecución de PHP (todos los binarios, archivos de configuración, subcarpetas, etc.) a la carpeta php.

3. (OPCIONAL) Si el runtime de PHP usa los controladores de Microsoft para PHP en SQL Server, tendrá que configurar el rol de trabajo para instalar SQL Server Native Client 2012 cuando se aprovisione. Para ello, agregue el instalador sqlncli.msi x64 al directorio raíz del rol de trabajo. El script de inicio descrito en el siguiente paso ejecutará el instalador silenciosamente cuando se aprovisione el rol. Si el tiempo de ejecución de PHP no usa los controladores de Microsoft para PHP en SQL Server, puede eliminar la línea siguiente del script que se muestra en el paso siguiente:

   msiexec /i sqlncli.msi /qn IACCEPTSQLNCLILICENSETERMS=YES
   

4. Defina una tarea de inicio que agregue el archivo ejecutable php.exe a la variable de entorno PATH del rol de trabajo cuando se aprovisiona el rol. Para ello, abra el archivo setup_worker.cmd (en el directorio raíz del rol de trabajo) en un editor de texto y reemplace su contenido por el siguiente 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
   

5. Agregue los archivos de la aplicación al directorio raíz del rol de trabajo.

6. Publique la aplicación como se describe en la sección Publicación de la aplicación más adelante.

Ejecución de la aplicación en los emuladores de proceso y de almacenamiento

Los emuladores de Azure ofrecen un entorno local en el que puede probar la aplicación de Azure antes de implementarla en la nube. Existen algunas diferencias entre los emuladores y el entorno de Azure. Para comprender esto mejor, consulte Uso del emulador de almacenamiento de Azure para desarrollo y pruebas.

Tenga en cuenta que debe tener instalado PHP localmente para usar el emulador de proceso. El emulador de proceso usará la instalación de PHP local para ejecutar la aplicación.

Para ejecutar el proyecto en los emuladores, ejecute el comando siguiente desde el directorio raíz del proyecto:

PS C:\MyProject> Start-AzureEmulator

Verá una salida similar a esto:

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

Puede ver la aplicación en ejecución en el emulador; para ello, abra un explorador web y vaya a la dirección local que aparece en la salida (http://127.0.0.1:81 en la salida del ejemplo anterior).

Para detener los emuladores, ejecute este comando:

PS C:\MyProject> Stop-AzureEmulator

Publicación de la aplicación

Para publicar la aplicación, primero tiene que importar la configuración de la publicación con el cmdlet Import-AzurePublishSettingsFile . Después, puede publicar la aplicación con el cmdlet Publish-AzureServiceProject . Para obtener información sobre cómo iniciar sesión, consulte Cómo instalar y configurar Azure PowerShell.

Pasos siguientes

Para obtener más información, consulte el Centro para desarrolladores de PHP.