Guía Completa Instalación Módulos PHP En Ubuntu 18.04 Para Laravel

by ADMIN 67 views
Iklan Headers

Configurar un servidor para ejecutar aplicaciones Laravel en Ubuntu 18.04 implica instalar los módulos PHP necesarios. Este artículo te guiará paso a paso en el proceso de instalación de estos módulos, asegurando que tu entorno esté listo para el desarrollo y despliegue de aplicaciones Laravel. Laravel, un framework de PHP popular, requiere ciertas extensiones para funcionar correctamente, y este tutorial te ayudará a instalarlas de manera eficiente.

Requisitos Previos

Antes de comenzar con la instalación de los módulos PHP, asegúrate de tener lo siguiente:

  • Un servidor Ubuntu 18.04 en funcionamiento.
  • PHP 7.2 o superior instalado.
  • Acceso a la línea de comandos con privilegios de sudo.
  • Apache2 instalado (si planeas usar Apache como servidor web).

Si aún no tienes PHP instalado, puedes hacerlo con el siguiente comando:

sudo apt update
sudo apt install php7.2

Verifica la versión de PHP instalada con:

php -v

Instalación de Módulos PHP Esenciales para Laravel

Los módulos PHP esenciales para Laravel incluyen php-mbstring, php-xml, php-json, php-intl, y php-mysql (o php-pgsql si usas PostgreSQL). Estos módulos proporcionan funcionalidades importantes para el manejo de cadenas, XML, JSON, internacionalización y bases de datos. La instalación de estos módulos es crucial para el correcto funcionamiento de Laravel. Aquí te mostramos cómo instalarlos:

1. Actualizar el Sistema

Es una buena práctica comenzar actualizando los paquetes del sistema. Esto asegura que tienes las versiones más recientes de los paquetes y sus dependencias. Ejecuta los siguientes comandos:

sudo apt update
sudo apt upgrade

2. Instalar los Módulos PHP

Ahora, instala los módulos PHP necesarios con el siguiente comando:

sudo apt install php7.2-mbstring php7.2-xml php7.2-json php7.2-intl php7.2-mysql php7.2-zip php7.2-gd

Este comando instala los siguientes módulos:

  • php7.2-mbstring: Proporciona soporte para funciones de cadenas multibyte.
  • php7.2-xml: Permite trabajar con documentos XML.
  • php7.2-json: Soporte para codificación y decodificación JSON.
  • php7.2-intl: Funciones de internacionalización (formato de fechas, monedas, etc.).
  • php7.2-mysql: Soporte para bases de datos MySQL.
  • php7.2-zip: Permite trabajar con archivos ZIP.
  • php7.2-gd: Soporte para la manipulación de imágenes.

Nota: Asegúrate de reemplazar 7.2 con la versión de PHP que estés utilizando en tu sistema.

3. Verificar la Instalación

Después de la instalación, verifica que los módulos estén habilitados. Puedes hacerlo creando un archivo phpinfo.php en el directorio raíz de tu servidor web y accediéndolo a través de un navegador. Primero, crea el archivo:

sudo nano /var/www/html/phpinfo.php

Añade el siguiente contenido:

<?php
phpinfo();
?>

Guarda y cierra el archivo. Luego, accede a http://tu_direccion_ip/phpinfo.php desde tu navegador. Busca las secciones correspondientes a los módulos que instalaste para confirmar que están habilitados. Si los módulos están listados, la instalación fue exitosa.

4. Reiniciar el Servidor Web

Para que los cambios surtan efecto, reinicia tu servidor web. Si estás usando Apache, ejecuta:

sudo systemctl restart apache2

Si estás usando Nginx, el comando sería:

sudo systemctl restart nginx

Módulos PHP Adicionales Recomendados para Laravel

Además de los módulos esenciales, hay otros módulos que pueden mejorar el rendimiento y la funcionalidad de tus aplicaciones Laravel. Aquí hay algunos recomendados:

  • php-curl: Permite realizar solicitudes HTTP.
  • php-dom: Necesario para ciertas operaciones de manipulación de HTML.
  • php-fileinfo: Proporciona información sobre los tipos de archivos.
  • php-pdo: Interfaz de acceso a bases de datos.

Para instalarlos, usa el siguiente comando:

sudo apt install php7.2-curl php7.2-dom php7.2-fileinfo php7.2-pdo

Recuerda reiniciar tu servidor web después de instalar estos módulos.

Configuración de PHP.ini para Laravel

El archivo php.ini contiene la configuración de PHP. Es importante ajustar ciertas directivas para optimizar el rendimiento y la seguridad de tus aplicaciones Laravel. Algunas configuraciones importantes incluyen:

  • memory_limit: Define la cantidad máxima de memoria que un script PHP puede usar. Aumenta este valor si experimentas errores de falta de memoria.
  • upload_max_filesize y post_max_size: Controlan el tamaño máximo de los archivos que se pueden subir.
  • display_errors: Controla si los errores se muestran en el navegador. En producción, es recomendable desactivar esta opción por seguridad.

1. Ubicar el Archivo php.ini

Para encontrar la ubicación de tu archivo php.ini, puedes usar el siguiente comando:

php -i | grep "Loaded Configuration File"

Este comando mostrará la ruta al archivo php.ini que está en uso.

2. Editar el Archivo php.ini

Abre el archivo php.ini con un editor de texto, por ejemplo, nano:

sudo nano /ruta/al/php.ini

Reemplaza /ruta/al/php.ini con la ruta que encontraste en el paso anterior.

3. Ajustar las Directivas

Busca las siguientes directivas y ajusta sus valores según tus necesidades. Aquí hay algunos valores recomendados:

memory_limit = 256M
upload_max_filesize = 20M
post_max_size = 20M
display_errors = Off
  • memory_limit: Establece el límite de memoria a 256MB.
  • upload_max_filesize y post_max_size: Permiten subir archivos de hasta 20MB.
  • display_errors: Desactiva la visualización de errores.

Guarda y cierra el archivo después de realizar los cambios.

4. Reiniciar el Servidor Web

Reinicia tu servidor web para que los cambios en php.ini surtan efecto:

sudo systemctl restart apache2

Resolución de Problemas Comunes

1. Módulos No Habilitados

Si después de la instalación, los módulos no aparecen en phpinfo(), asegúrate de haber reiniciado el servidor web. También, verifica que estás editando el archivo php.ini correcto y que la sintaxis de las directivas es correcta.

2. Errores de Dependencia

Si encuentras errores de dependencia durante la instalación, ejecuta sudo apt update y sudo apt upgrade para actualizar los paquetes del sistema. Luego, intenta instalar los módulos nuevamente.

3. Problemas de Permisos

Si tienes problemas de permisos al acceder a los archivos de tu aplicación Laravel, asegúrate de que el usuario del servidor web (por ejemplo, www-data en Apache) tenga los permisos adecuados. Puedes usar los siguientes comandos para establecer los permisos correctos:

sudo chown -R www-data:www-data /ruta/a/tu/proyecto
sudo chmod -R 755 /ruta/a/tu/proyecto/storage
sudo chmod -R 755 /ruta/a/tu/proyecto/bootstrap/cache

Reemplaza /ruta/a/tu/proyecto con la ruta a tu proyecto Laravel.

Conclusión

Instalar los módulos PHP necesarios en Ubuntu 18.04 es un paso crucial para configurar un entorno de desarrollo robusto para Laravel. Siguiendo los pasos descritos en este artículo, puedes asegurarte de que tu servidor esté listo para ejecutar aplicaciones Laravel sin problemas. Desde la instalación de los módulos esenciales hasta la configuración del archivo php.ini, cada paso contribuye a un entorno de desarrollo óptimo. Recuerda siempre verificar la instalación y reiniciar el servidor web después de realizar cambios para que estos surtan efecto. Además, la resolución de problemas comunes te ayudará a superar cualquier obstáculo que puedas encontrar durante el proceso. Con una configuración adecuada, estarás bien equipado para desarrollar y desplegar tus aplicaciones Laravel en Ubuntu 18.04.