Creación de una aplicación web PHP en Azure App Service

Advertencia

PHP en Windows alcanzó el final del soporte técnico en noviembre de 2022. PHP solo se admite para App Service en Linux. Este artículo sirve solo como referencia.

Azure App Service proporciona un servicio de hospedaje web muy escalable y con aplicación de revisiones de un modo automático. En este tutorial de inicio rápido se explica cómo se implementa una aplicación PHP en Azure App Service en Windows.

Se crea la aplicación web con la CLI de Azure en Cloud Shell y se usa Git para implementar el código PHP de ejemplo en la aplicación web.

Estos pasos se pueden realizar en este caso con una máquina Mac, Windows o Linux. Una vez instalados los requisitos previos, tardará aproximadamente cinco minutos en completar los pasos.

Si no tiene una cuenta de Azure, cree una cuenta gratuita antes de comenzar.

Nota:

Después del 28 de noviembre de 2022, PHP solo se admitirá en App Service en Linux.

Requisitos previos

Para completar esta guía de inicio rápido:

• Instalación de Git
• Instalación de PHP

Descarga local del código

1. Ejecute los siguientes comandos en una ventana de terminal. Se clonará la aplicación de ejemplo en el equipo local y se desplazará al directorio que contiene el código de ejemplo.

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

2. Asegúrese de que la rama predeterminada sea main.

   git branch -m main
   

   Sugerencia

   App Service no exige el cambio de nombre de rama. Sin embargo, dado que muchos repositorios cambian su rama predeterminada a main, en este inicio rápido también se muestra cómo implementar un repositorio desde main.

Ejecución de la aplicación de forma local

1. Ejecute la aplicación localmente para ver cómo debería ser si se implementara en Azure. Abra una ventana de terminal y use el comando php para iniciar el servidor web de PHP integrado.

   php -S localhost:8080
   

2. Abra un explorador web y vaya a la aplicación de ejemplo en http://localhost:8080.

   Verá el mensaje Hola mundo de la aplicación de ejemplo que aparece en la página.

   

3. En la ventana de terminal, presione Ctrl + C para salir del servidor web.

Azure Cloud Shell

Azure hospeda Azure Cloud Shell, un entorno de shell interactivo que puede usar a través del explorador. Puede usar Bash o PowerShell con Cloud Shell para trabajar con servicios de Azure. Puede usar los comandos preinstalados de Cloud Shell para ejecutar el código de este artículo sin tener que instalar nada en su entorno local.

Para iniciar Azure Cloud Shell:

Opción	Ejemplo o vínculo
Seleccione Pruébelo en la esquina superior derecha de un bloque de código o de comandos. Al seleccionar Probar no se copia automáticamente el código ni el comando en Cloud Shell.
Vaya a https://shell.azure.com o seleccione el botón Iniciar Cloud Shell para abrir Cloud Shell en el explorador.
Seleccione el botón Cloud Shell en la barra de menús de la esquina superior derecha de Azure Portal.

Para usar Azure Cloud Shell:

1. Inicie Cloud Shell.

2. Seleccione el botón Copiar en un bloque de código (o bloque de comandos) para copiar el código o comando.

3. Pegue el código o comando en la sesión de Cloud Shell. Para ello, seleccione Ctrl+Mayús+V en Windows y Linux, o bien seleccione Cmd+Mayús+V en macOS.

4. Seleccione Enter para ejecutar el código o comando.

Configuración de un usuario de implementación

Se puede implementar FTP y Git local en una aplicación web de Azure mediante un usuario de implementación. Una vez configurado este usuario de implementación, podrá usarlo en todas las implementaciones de Azure. El nombre de usuario y la contraseña en el nivel de cuenta son diferentes de las credenciales de suscripción de Azure.

Para configurar el usuario de implementación, ejecute el comando az webapp deployment user set en Azure Cloud Shell. Reemplace <username> y <password> por un nombre de usuario y contraseña de implementación.

• El nombre de usuario debe ser único dentro de Azure y no debe contener el símbolo "\@" para las inserciones de Git local.
• La contraseña debe tener al menos ocho caracteres y dos de los tres elementos siguientes: letras, números y símbolos.

az webapp deployment user set --user-name <username> --password <password>

La salida JSON muestra la contraseña como null. Si se produce un error 'Conflict'. Details: 409, cambie el nombre de usuario. Si se produce un error 'Bad Request'. Details: 400, use una contraseña más segura.

Anote el nombre de usuario y la contraseña que se usarán para implementar las aplicaciones web.

Crear un grupo de recursos

Un grupo de recursos es un contenedor lógico en el que los recursos de Azure, como aplicaciones web, bases de datos y cuentas de almacenamiento, se implementen y administren. Por ejemplo, más adelante puede elegir eliminar todo el grupo de recursos en un solo paso.

En Cloud Shell, cree un grupo de recursos con el comando az group create. En el ejemplo siguiente, se crea un grupo de recursos denominado myResourceGroup en la ubicación Oeste de Europa. Para ver todas las ubicaciones que se admiten en App Service en el nivel Gratis, ejecute el comando az appservice list-locations --sku FREE.

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

Generalmente se crean el grupo de recursos y los recursos en una región cercana.

Cuando finaliza el comando, una salida de JSON muestra las propiedades del grupo de recursos.

Crear un plan de Azure App Service

En Cloud Shell, cree un plan de App Service con el comando az appservice plan create.

En el siguiente ejemplo se crea un plan de App Service denominado myAppServicePlan con el plan de tarifa Gratis:

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

Cuando se crea el plan de App Service, la CLI de Azure muestra información similar al ejemplo siguiente:

{ 
  "freeOfferExpirationTime": null,
  "geoRegion": "West Europe",
  "hostingEnvironmentProfile": null,
  "id": "/subscriptions/0000-0000/resourceGroups/myResourceGroup/providers/Microsoft.Web/serverfarms/myAppServicePlan",
  "kind": "linux",
  "location": "West Europe",
  "maximumNumberOfWorkers": 1,
  "name": "myAppServicePlan",
  < JSON data removed for brevity. >
  "targetWorkerSizeId": 0,
  "type": "Microsoft.Web/serverfarms",
  "workerTierName": null
} 

Creación de una aplicación web

1. En Cloud Shell, cree una aplicación web en el plan de App Service myAppServicePlan con el comando az webapp create.

   En el siguiente ejemplo, reemplace <app-name> por un nombre único global de aplicación (los caracteres válidos son a-z, 0-9 y -). El tiempo de ejecución se establece en PHP|7.4. Para ver todos los entornos en tiempo de ejecución admitidos, ejecute az webapp list-runtimes.

   az webapp create --resource-group myResourceGroup --plan myAppServicePlan --name <app-name> --runtime 'PHP|8.1' --deployment-local-git
   

   Cuando se haya creado la aplicación web, la CLI de Azure mostrará información similar a la del ejemplo siguiente:

    Local git is configured with url of <URL>
    {
      "availabilityState": "Normal",
      "clientAffinityEnabled": true,
      "clientCertEnabled": false,
      "cloningInfo": null,
      "containerSize": 0,
      "dailyMemoryTimeQuota": 0,
      "defaultHostName": "<app-name>.azurewebsites.net",
      "enabled": true,
      < JSON data removed for brevity. >
    }
    

   Ha creado una nueva aplicación web vacía, con la implementación de Git habilitada.

   Nota:

   La dirección URL del control remoto de Git se muestra en la deploymentLocalGitUrl propiedad . Guarde esta dirección URL, ya que la necesitará más adelante.

2. Vaya a la aplicación web recién creada.

   Este es el aspecto que debería tener su nueva aplicación web:

   

Inserción en Azure desde Git

1. Dado que va a implementar la rama main, debe establecer la rama de implementación predeterminada para su aplicación de App Service en main. (Consulte Cambio de rama de implementación). En Cloud Shell, establezca la configuración de la DEPLOYMENT_BRANCH aplicación mediante el az webapp config appsettings set comando .

   az webapp config appsettings set --name <app-name> --resource-group myResourceGroup --settings DEPLOYMENT_BRANCH='main'
   

2. En la ventana del terminal local, agregue una instancia remota de Azure al repositorio de Git local. Reemplace <deploymentLocalGitUrl-from-create-step>> por la dirección URL del repositorio de Git remoto que guardó en Creación de una aplicación web.

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

3. Realice la insercion en la instancia remota de Azure para implementar la aplicación con el comando siguiente. Cuando el Administrador de credenciales de Git le solicite las credenciales, asegúrese de que especifica las que creó en Configuración de la implementación de Git local, no las que se usan para iniciar sesión en Azure Portal.

   git push azure main
   

   Este comando puede tardar unos minutos en ejecutarse. Durante la ejecución, muestra información similar a la del ejemplo siguiente:

  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 'main'.
  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 <URL>
      cc39b1e..25f1805  main -> main
  

Navegación hasta la aplicación

Vaya a la aplicación implementada mediante el explorador web.

El código de ejemplo de PHP se está ejecutando en una aplicación web de Azure App Service.

Felicidades. Ha implementado la primera aplicación PHP en App Service.

Actualización local y nueva implementación del código

1. Con un editor de texto local, abra el archivo index.php dentro de la aplicación PHP y realice un pequeño cambio en el texto dentro de la cadena situada junto a echo:

   echo "Hello Azure!";
   

2. En la ventana del terminal local, confirme los cambios en Git e inserte los cambios de código en Azure.

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

3. Una vez que la implementación haya finalizado, vuelva a la ventana del explorador que abrió en el paso Navegación hasta la aplicación y actualice la página.

   

Administración de la nueva aplicación de Azure

1. Vaya a Azure Portal para administrar la aplicación web que ha creado. Busque y seleccione App Services.

   

2. Seleccione el nombre de la aplicación de Azure.

   

   Se mostrará la página de información general de la aplicación web. En ella, puede realizar tareas de administración básicas como examinar, detener, reiniciar y eliminar.

   

   En el menú de la aplicación web se proporcionan distintas opciones para configurar la aplicación.

Limpieza de recursos

En los pasos anteriores, creó recursos de Azure en un grupo de recursos. Si prevé que no necesitará estos recursos en el futuro, elimine el grupo de recursos ejecutando el siguiente comando en Cloud Shell:

az group delete --name myResourceGroup

Este comando puede tardar un par de minutos en ejecutarse.

Azure App Service proporciona un servicio de autocorrección altamente escalable para el alojamiento web. En esta guía de inicio rápido se explica cómo se implementa una aplicación de PHP en Azure App Service en Linux.

Estos pasos se pueden realizar en este caso con una máquina Mac, Windows o Linux. Una vez instalados los requisitos previos, se tarda unos diez minutos en completar los pasos.

Requisitos previos

• Una cuenta de Azure con una suscripción activa. Cree una cuenta gratuita.
• Git
• PHP
• CLI de Azure para ejecutar comandos en un shell para crear y configurar recursos de Azure.

Descargar el repositorio de ejemplo

CLI de Azure

En los pasos siguientes, se crea la aplicación web mediante la CLI de Azure y, a continuación, se implementa código PHP de ejemplo en la aplicación web.

Puede usar Azure Cloud Shell.

1. En la ventana de terminal, ejecute los comandos siguientes para clonar la aplicación de ejemplo en el equipo local y desplazarse a la raíz del proyecto.

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

2. Para ejecutar la aplicación localmente, use el comando php para iniciar el servidor web PHP integrado.

   php -S localhost:8080
   

3. Vaya a la aplicación de ejemplo en http://localhost:8080, en un explorador web.

   

4. En la ventana de terminal, presione Ctrl + C para salir del servidor web.

Portal

1. En el explorador, vaya al repositorio que contiene el código de ejemplo.

2. En la esquina superior derecha, seleccione Bifurcar.

   

3. En la pantalla Crear una nueva bifurcación, confirme los campos Propietario y Nombre del repositorio. Seleccione Crear bifurcación.

   

Nota:

Esto le llevará a la nueva bifurcación. La dirección URL de bifurcación tiene un aspecto similar al siguiente: https://github.com/YOUR_GITHUB_ACCOUNT_NAME/php-docs-hello-world

Implementación del código de la aplicación en Azure

CLI de Azure

La CLI de Azure dispone de un comando az webapp up que crea los recursos necesarios e implementa la aplicación en un solo paso.

En el terminal, implemente el código en la carpeta local mediante el comando az webapp up:

az webapp up --runtime "PHP:8.2" --os-type=linux

• Si no se reconoce el comando az, asegúrese de tener instalada la CLI de Azure.
• El argumento --runtime "PHP:8.2" crea la aplicación web con PHP versión 8.2.
• El argumento --os-type=linux crea la aplicación web en App Service en Linux.
• Opcionalmente, puede especificar un nombre con el argumento --name <app-name>. Si no proporciona un nombre, se genera automáticamente.
• Opcionalmente, incluya el argumento --location <location-name>, donde <location_name> es una región de Azure disponible. Puede recuperar una lista de regiones permitidas para su cuenta de Azure ejecutando el comando az account list-locations.
• Si ves el error No se pudo detectar automáticamente la pila de tiempo de ejecución de tu app, asegúrate de ejecutar el comando en el directorio de código. Para obtener más información, consulte Solución de problemas de detección automática con az webapp up.

El comando puede tardar unos minutos en completarse. Mientras se ejecuta, proporciona mensajes sobre la creación del grupo de recursos, el plan de App Service y el recurso de la aplicación, la configuración del registro y la implementación del archivo ZIP. A continuación, proporciona la dirección URL de la aplicación en Azure.

The webapp '<app-name>' doesn't exist
Creating Resource group '<group-name>' ...
Resource group creation complete
Creating AppServicePlan '<app-service-plan-name>' ...
Creating webapp '<app-name>' ...
Configuring default logging for the app, if not already enabled
Creating zip with contents of <directory-location> ...
Getting scm site credentials for zip deployment
Starting zip deployment. This operation can take a while to complete ...
Deployment endpoint responded with status code 202
You can launch the app at http://<app-name>.azurewebsites.net
{
  "URL": "http://<app-name>.azurewebsites.net",
  "appserviceplan": "<app-service-plan-name>",
  "location": "centralus",
  "name": "<app-name>",
  "os": "linux",
  "resourcegroup": "<group-name>",
  "runtime_version": "php|8.2",
  "runtime_version_detected": "0.0",
  "sku": "FREE",
  "src_path": "<directory-path>"
}

Nota:

El comando az webapp up realiza las acciones siguientes:

• Cree un grupo de recursos predeterminado.

• Cree un plan de App Service predeterminado.

• Cree una aplicación con el nombre especificado.

• Implemente desde un archivo ZIP todos los archivos del directorio de trabajo actual, con la automatización de compilación habilitada.

• Almacene los parámetros localmente en el archivo .azure/config para que no tenga que especificarlos de nuevo al implementar posteriormente con az webapp up u otros comandos az webapp desde la carpeta del proyecto. Los valores almacenados en caché se usan automáticamente de forma predeterminada.

Diríjase a la aplicación implementada en su navegador web en la dirección URL que se proporciona en la consola.

Portal

1. Inicie sesión en Azure Portal.

2. En la parte superior del portal, escriba app services en el cuadro de búsqueda. En Servicios, seleccione App Services.

   

3. En la página Servicios de aplicaciones , seleccione + Crear y elija Aplicación web.

4. En la pestaña Básica:

   • En Grupo de recursos, seleccione Crear nuevo. Escriba myResourceGroup para el nombre.
   • En Nombre, escriba un nombre único global para la aplicación web.
   • En Publicar, seleccione Código.
   • En Pila del runtime seleccione PHP 8.2.
   • En Sistema operativo, seleccione Linux.
   • En Región, seleccione una región de Azure cercana.
   • En Plan de App Service, cree un plan de App Service denominado myAppServicePlan.
   • En Plan de precios, seleccione Gratis F1.

   

5. Seleccione la pestaña Implementación en la parte superior de la página.

6. En Configuración de Acciones de GitHub, establezca Implementación continua en Habilitar.

7. En Detalles de Acciones de GitHub, autentíquese con su cuenta de GitHub y seleccione las siguientes opciones:

   • En Organización, seleccione la organización en la que bifurcó el proyecto de demostración.
   • En Repositorio, seleccione el proyecto php-docs-hello-world.
   • En Rama, seleccione main.

   

   Nota:

   De forma predeterminada, el asistente para la creación deshabilita la autenticación básica y la implementación de Acciones de GitHub se crea mediante una identidad asignada por el usuario. Si recibe un error de permisos durante la creación de recursos, es posible que la cuenta de Azure no tenga permisos suficientes. Puede configurar la implementación de Acciones de GitHub más adelante con una identidad generada por un administrador de Azure o también puede habilitar la autenticación básica.

8. Seleccione el botón Revisar y crear de la parte inferior de la página.

9. Después de que se ejecute la validación, seleccione el botón Crear en la parte inferior de la página.

10. Una vez finalizada la implementación, seleccione Ir al recurso.

11. Vaya a la aplicación implementada en su navegador web en la dirección URL proporcionada.

El código de ejemplo de PHP se está ejecutando en una instancia de Azure App Service.

Felicidades. Ha implementado su primera aplicación PHP en App Service mediante Azure Portal.

Actualización de la aplicación y nueva implementación

CLI de Azure

1. Localice el directorio php-docs-hello-world y abra el archivo index.php utilizando un editor de texto local. Realice un pequeño cambio en el texto dentro de la cadena junto a echo:

   echo "Hello Azure!";
   

2. Guarde los cambios y vuelva a implementar la aplicación con el comando az webapp up de nuevo con estos argumentos:

   az webapp up --runtime "PHP:8.2" --os-type=linux
   

3. Una vez completada la implementación, vuelva a la ventana del explorador que abrió en el paso Navegación hasta la aplicación y actualice la página.

   

Portal

1. Vaya a la bifurcación de GitHub de php-docs-hello-world.

2. En la página del repositorio, presione . para iniciar Visual Studio Code dentro del explorador.

   

   Nota:

   La URL cambia de GitHub.com a GitHub.dev. Esta característica solo funciona con repositorios que tienen archivos. Esto no funciona en repositorios vacíos.

3. Edite index.php para que muestre ¡Hola Azure! en lugar de ¡Hola mundo!

   <?php
       echo "Hello Azure!";
   ?>
   

4. En el menú Control de código fuente, seleccione el botón Almacenar cambios provisionalmente para almacenar provisionalmente el cambio.

   

5. Escriba un mensaje de confirmación como Hola Azure. A continuación, seleccione Confirmar e insertar.

   

6. Una vez completada la implementación, vuelva a la ventana del explorador que se abrió durante el paso Examinar a la aplicación y actualice la página.

   

Administración de la nueva aplicación de Azure

1. Vaya a Azure Portal para administrar la aplicación web que ha creado. Busque y seleccione App Services.

   

2. Seleccione la aplicación de Azure para abrirla.

   

   Se debe mostrar la página de información general de la aplicación web. En ella, puede realizar tareas de administración básicas como examinar, detener, reiniciar y eliminar.

   

   En el menú de la aplicación web se proporcionan distintas opciones para configurar la aplicación.

Limpieza de recursos

Cuando haya terminado con la aplicación de ejemplo, puede quitar todos los recursos de la aplicación de Azure para que pueda evitar cargos adicionales y mantener la suscripción de Azure desordenada. Al quitar el grupo de recursos también se quitan todos los recursos que haya dentro; es la manera más rápida de quitar todos los recursos de Azure de la aplicación.

CLI de Azure

Elimine el grupo de recursos con el comando az group delete.

az group delete --name myResourceGroup

Este comando tarda un minuto en ejecutarse.

Portal

1. En la página Información general de App Service, seleccione el grupo de recursos que ha creado.

2. En la página del grupo de recursos, seleccione Eliminar grupo de recursos. Confirme el nombre del grupo de recursos para terminar de eliminar los recursos.

Contenido relacionado

• Implementación de una aplicación PHP, MySQL y Redis en Azure App Service
• Configuración de una aplicación PHP para Azure App Service
• Proteja su aplicación con un dominio personalizado y un certificado administrado