13. Apéndices
13.1. Instalación de PHP
Los ejemplos y el caso de estudio requieren [PHP] 8.4 o una versión posterior, con las extensiones [intl] (formato de números, ejemplo 16), [pdo_mysql] (acceso a [MySQL], ejemplo 28 y caso de estudio), [mbstring], y [openssl]. Se han probado con la versión 8.4.
En [Windows], la opción más sencilla es [Laragon] (laragon.org), que instala [PHP], [Composer], un servidor [MySQL] y la herramienta de administración [HeidiSQL]. Si la versión de [PHP] incluida es anterior a la 8.4, descargue una versión más reciente desde windows.php.net/download (la versión *Thread Safe*, archivo [.zip]), que debe extraer en la carpeta [bin\php] de [Laragon]; el menú PHP / Versión de [Laragon] permite seleccionarla. El menú PHP / Extensiones activa una extensión con un solo clic ([intl], [pdo_mysql]). La terminal de [Laragon] (botón Terminal) admite los comandos [php], [composer] y [mysql].
Sin [Laragon], extraiga el archivo de [PHP] en una carpeta ([C:\php]), agregue esta carpeta a la variable de entorno [Path], luego cree el archivo de configuración [php.ini] copiando [php.ini-development], y elimine el punto y coma que comenta las líneas de las extensiones requeridas:
En [macOS], el administrador de paquetes [Homebrew] instala [PHP] y sus extensiones estándar: [brew install php]. En [Linux] ([Ubuntu]), la versión que ofrece la distribución suele ser más antigua; el repositorio [ppa:ondrej/php] proporciona las versiones más recientes:
Verifique la instalación en una consola nueva:
El primer comando debe mostrar un número de versión igual o superior a 8.4 (por ejemplo, [PHP 8.4.12]); el segundo enumera las extensiones cargadas, entre ellas [intl] y [pdo_mysql]. El comando [php --ini] indica qué archivo, [php.ini], se está utilizando.
13.2. Composer
[Composer] es el administrador de bibliotecas de [PHP] (getcomposer.org). Lo proporciona [Laragon]; en [Windows], sin [Laragon], se utiliza su instalador ([Composer-Setup.exe]); en [macOS], use [brew install composer]; en [Linux], siga las instrucciones de la página getcomposer.org/download. Verifique la instalación:
Comandos útiles en una carpeta de proyecto (la que contiene [composer.json]):
[Composer] descarga las bibliotecas desde el repositorio [Packagist] (packagist.org): se requiere una conexión a Internet durante la instalación. Si está detrás de un proxy corporativo, especifique el proxy mediante las variables de entorno [HTTP_PROXY] y [HTTPS_PROXY]. La carpeta [vendor] no se copia de una máquina a otra (puede contener rutas absolutas y es voluminosa); se vuelve a crear con [composer install]. Por eso no se incluye en los materiales del curso. La carpeta [examples] tiene su propia carpeta [vendor], compartida por los 28 ejemplos; el caso de estudio tiene la suya.
13.3. Instalación de Visual Studio Code
[Visual Studio Code] se descarga desde code.visualstudio.com. Agregue dos extensiones (menú Ver / Extensiones):
- PHP Intelephense: autocompletado de código, navegación por el código (incluido el código de [Laravel], en la carpeta [vendor]) y reporte de errores;
- Laravel (la extensión oficial): resaltado de sintaxis para las vistas [Blade] y autocompletado de nombres de rutas, nombres de vistas, claves de configuración y claves de traducción.
La extensión PHP Debug permite ejecutar el código paso a paso con el depurador [Xdebug] (una extensión de [PHP], que debe instalarse por separado: xdebug.org).
Abra la carpeta [examples] o la carpeta del caso de estudio (menú Archivo / Abrir carpeta). La terminal integrada (menú Terminal / Nueva terminal) permite iniciar las aplicaciones sin salir del editor.
13.4. Instalación de MySQL con Laragon
[Laragon] instala un servidor [MySQL] listo para usar en [Windows], junto con la herramienta de administración [HeidiSQL]. Después de la instalación:
- el botón “Iniciar todo” inicia el servidor [MySQL] en el puerto 3306;
- el usuario [root] no tiene contraseña: estos son los valores de los archivos [.env] del ejemplo 28 y del caso de estudio ([DB_USERNAME=root], [DB_PASSWORD=]);
- El botón Base de datos abre [HeidiSQL], donde la opción de menú Archivo / Ejecutar un archivo SQL ejecuta los scripts [dbpersons.sql] (ejemplo 28) y [dbrdvmedecins2.sql] (caso de estudio).
En [Linux] o [macOS], instale [MySQL] o [MariaDB] con el administrador de paquetes del sistema y ejecute los scripts con el cliente de línea de comandos [mysql]. El controlador [pdo_mysql] funciona con ambos sin ninguna configuración. En [Linux], la cuenta [root] de [MariaDB] suele estar configurada para iniciar sesión solo mediante la cuenta del sistema [root] ([sudo mysql]): entonces se crea un usuario para las aplicaciones y este usuario se especifica en su archivo [.env]:
13.5. Instalación de curl
[curl] viene incluido con [Windows] 10 y 11, [macOS] y la mayoría de las distribuciones de [Linux]. En [PowerShell], debe escribir [curl.exe], no [curl]: en versiones antiguas de [PowerShell], [curl] es un alias de otro comando ([Invoke-WebRequest]), que tiene opciones diferentes. En el símbolo del sistema de [Windows] ([cmd]), las comillas de una cadena JSON se escriben como [\"] (ejemplo 11), y una URL que contenga [&] debe encerrarse entre comillas dobles.