Instalación del marco PHP Laravel en Ubuntu 18.04 LTS para Apache

Laravel es un marco PHP de código abierto muy popular destinado a facilitar el desarrollo de aplicaciones. Si estás buscando un nuevo marco PHP para probar, deberías darle una oportunidad a Laravel.

La siguiente guía te mostrará cómo instalar y ejecutar Laravel en un servidor Apache basado en Ubuntu 18.04 LTS. Este tutorial también funciona para Ubuntu 17.x. Pero para servidores, deberías preferir usar una versión LTS de Ubuntu como la actual Ubuntu 18.04 LTS.

Pre-requisitos

Antes de proceder con la instalación, siempre es una buena idea asegurarte de que tus fuentes y software existente estén actualizados.

sudo apt-get update   
sudo apt-get upgrade

Para esta guía, asumiremos que tienes un servidor básico basado en Ubuntu en funcionamiento. Antes de Laravel, necesitamos instalar otros componentes que son esenciales.

Instalación de Apache y PHP 7.2

El siguiente paso es instalar PHP junto con varios paquetes adicionales que serían útiles si vas a trabajar con Laravel.

sudo add-apt-repository ppa:ondrej/php  
sudo apt-get update  
sudo apt-get install apache2 libapache2-mod-php7.2 php7.2 php7.2-xml php7.2-gd php7.2-opcache php7.2-mbstring

Aunque el propio repositorio de Ubuntu tiene PHP, es mejor agregar un repositorio de terceros aquí porque se actualiza con más frecuencia. Puedes omitir ese paso y quedarte con la versión de Ubuntu si eso es lo que prefieres.

Instalación de Laravel

Antes de profundizar en ello, también necesitamos que se instale el control de versiones Git. Si ya lo tienes instalado, puedes omitir el siguiente paso. Si no lo tienes, entonces puedes seguir nuestra guía para configurarlo primero.

Para instalar Laravel, primero necesitamos instalar Composer. Es una herramienta para la gestión de dependencias en PHP que te permite empaquetar todas las bibliotecas requeridas asociadas con un paquete como una sola. Para instalar Laravel y todas sus dependencias, se requiere Composer. Descargará e instalará todo lo que se necesita para ejecutar el marco Laravel. Para instalar Composer, emite los siguientes comandos.

cd /tmp  
curl -sS https://getcomposer.org/installer | php  
sudo mv composer.phar /usr/local/bin/composer

El comando curl descarga el paquete composer.phar en tu directorio /tmp. Pero queremos que Composer se ejecute globalmente, por lo que necesitamos moverlo al directorio /usr/local/bin/ bajo el nombre ‘composer‘. Ahora podemos ejecutar Composer desde cualquier lugar.

Para instalar Laravel, dirígete al directorio html público en tu sistema. Dado que estamos en Ubuntu y usando Apache, lo instalaremos en el directorio /var/www/html.

cd /var/www/html  
sudo composer create-project laravel/laravel your-project --prefer-dist

El comando anterior creará un directorio “your-project“ con la instalación de Laravel en él. Composer utiliza git para descargar e instalar todos los paquetes y módulos que Laravel requiere para funcionar.

Configuración de Apache

Ahora que hemos instalado Laravel, pasamos al paso de configurar el servidor web Apache.

El siguiente paso es dar los permisos adecuados al directorio del proyecto. Para esto, necesitamos habilitar el acceso desde el grupo www-data y darle permisos de escritura al directorio de almacenamiento.

sudo chgrp -R www-data /var/www/html/your-project  
sudo chmod -R 775 /var/www/html/your-project/storage

Ahora ve al directorio /etc/apache2/sites-available y usa el siguiente comando para crear un archivo de configuración para nuestra instalación de Laravel.

cd /etc/apache2/sites-available  
sudo nano laravel.conf

Ahora agrega el siguiente contenido al archivo y ciérralo después de guardar. Reemplaza yourdomain.tld con el nombre de dominio de tu sitio web dentro del archivo.

  
    ServerName yourdomain.tld  
    ServerAdmin webmaster@localhost  
    DocumentRoot /var/www/html/your-project/public  
      
        AllowOverride All  
      
    ErrorLog ${APACHE_LOG_DIR}/error.log  
    CustomLog ${APACHE_LOG_DIR}/access.log combined  

Ahora tenemos que habilitar este nuevo archivo .conf creado y deshabilitar el archivo .conf predeterminado que se instala con la instalación predeterminada de Apache. Además, necesitamos habilitar mod_rewrite para que los enlaces permanentes funcionen correctamente.

sudo a2dissite 000-default.conf  
sudo a2ensite laravel.conf  
sudo a2enmod rewrite  
sudo service apache2 restart

Tu instalación de Laravel ahora está completa. Visita la dirección IP o el nombre de dominio de tu servidor con un navegador web (en mi caso http://192.168.1.100). Verás la página predeterminada de Laravel.

El marco Laravel se instaló correctamente en Ubuntu 18.04 LTS.

Descarga de máquina virtual de este tutorial

Este tutorial está disponible como una imagen de máquina virtual lista para usar en formato ovf/ova que es compatible con VMWare y Virtualbox. La imagen de la máquina virtual utiliza los siguientes detalles de inicio de sesión:

Inicio de sesión SSH / Shell

Nombre de usuario: administrator
Contraseña: howtoforge

Para convertirte en usuario root, ejecuta: sudo -s
Contraseña: howtoforge

La IP de la VM es 192.168.1.100, se puede cambiar en el archivo /etc/netplan/01-netcfg.yaml. Por favor, cambia todas las contraseñas anteriores para asegurar la máquina virtual.