Entorno de Desarrollo Local Laravel en Ubuntu para Escritorio

Sobre Ubuntu Desktop 20.04 y lo haremos instalando PHP y algunos módulos, CURL, MySQL, Composer y Laravel Installer. Nos será útil porque ciertas aplicaciones ( Multiinquilino ) no se ejecutan correctamente sobre entornos virtuales( XAMP ) o en contenedores ( Docker ).

Paso 1 – Instalar PHP

Actualizamos los paquetes y versiones
Instalamos el módulo software-properties-common
Instalamos el repositorio ppa:ondrej/php con todas las versiones de php
Volvemos a actualizar los paquetes
Instalamos la versión 7.4 de php
Instalamos una serie de módulos php más comunes
Mostramos una lista con los módulos instalados en el sistema

sudo apt-get update
sudo apt -y install 
sudo add-apt-repository ppa:ondrej/php
sudo apt-get update
sudo apt -y install php7.4
sudo apt-get install -y php7.4-cli php7.4-json php7.4-common php7.4-mysql php7.4-zip php7.4-gd php7.4-mbstring php7.4-curl php7.4-xml php7.4-bcmath
php -m

Módulos que hemos instalado:

php7.4-cli – intérprete de la línea de comandos
php7.4-json – para trabajar con datos en formato json
php7.4-common – documentación, ejemplos, y módulos comunes para PHP
php7.4-mysql – para trabajar con una base de datos MySQL
php7.4-zip – para trabajar con archivos comprimidos
php7.4-gd – para trabajar con imágenes
php7.4-mbstring – para manejar non-ASCII strings
php7.4-curl – te permite hacer peticiones HTTP en PHP
php7.4-xml – para trabajar con datos en formato XML
php7.4-bcmath – para trabajar con precisión en coma flotante

Paso 2 – Instalar MySQL

Vamos a instalar la versión 8 de MySQL:

Actualizamos los paquetes y versiones
Instalamos mysql-server
Entramos con el usuario root en la línea de comandos de mysql
Comprobamos el método de autenticación utilizado por nuestros usuarios
Modificamos el usuario root al método con contraseña (mysql_native_password), en mi caso el password estará vacío
Indicamos al servidor que vuelva a cargar la tabla de servicios
Tras salir de la línea de comandos volvemos a entrar con el usuario root y su contraseña -p (en mi caso está vacía)
Podemos crear un nuevo usuario non-root con contraseña
Y concederle los privilegios apropiados

sudo apt update
sudo apt install mysql-server
sudo mysql
mysql> SELECT user,authentication_string,plugin,host FROM mysql.user;
mysql> ALTER USER 'root'@'localhost' IDENTIFIED WITH mysql_native_password BY '';
mysql> FLUSH PRIVILEGES
mysql -u root
mysql> CREATE USER 'myname'@'localhost' IDENTIFIED BY 'password';
mysql> GRANT ALL PRIVILEGES ON *.* TO 'myname'@'localhost' WITH GRANT OPTION;

Paso 3 – Instalar Composer

Instalaremos composer 2 de forma global:

Actualizamos los paquetes y versiones
Instalamos curl
Descargamos el instalador
Verificamos la descarga
Instalamos Composer de manera global
Comprobamos que está instalado correctamente

apt update
sudo apt install curl
curl -sS https://getcomposer.org/installer -o composer-setup.php
HASH=`curl -sS https://composer.github.io/installer.sig`
sudo php composer-setup.php --install-dir=/usr/local/bin --filename=composer
composer

Paso 4 – Instalar Laravel Installer

Instalamos el instalador de Laravel
Abrimos el archivo de configuración .bashrc para editarlo
Añadimos Composer al path para acceder a laravel globalmente en la última línea del archivo

composer global require "laravel/installer"
nano ~/.bashrc
export PATH="$HOME/.config/composer/vendor/bin:$PATH"

Paso 5 – Crear un nuevo proyecto con Laravel

Vamos a crear un nuevo proyecto con Laravel Installer y además un repositorio público en GitHub.

GitHub CLI

En primer lugar vamos a instalar GitHub CLI y a autenticar nuestra cuenta :

curl -fsSL https://cli.github.com/packages/githubcli-archive-keyring.gpg | sudo gpg --dearmor -o /usr/share/keyrings/githubcli-archive-keyring.gpg
echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/githubcli-archive-keyring.gpg] https://cli.github.com/packages stable main" | sudo tee /etc/apt/sources.list.d/github-cli.list > /dev/null
sudo apt update
sudo apt install gh
gh auth login

Nuevo Proyecto

Creamos el proyecto y el repositorio :

laravel new example-app --github="--public"

Base de Datos

Creamos la base de datos :

mysql -u root
mysql> CREATE DATABASE example_app;

Editamos el fichero .env :

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=example_app
DB_USERNAME=root
DB_PASSWORD=

TablePus

Instalamos esta herramienta gratuita para la administración de bases de datos :

wget -O - -q http://deb.tableplus.com/apt.tableplus.com.gpg.key | sudo apt-key add - 
sudo add-apt-repository "deb [arch=amd64] https://deb.tableplus.com/debian tableplus main"
sudo apt update
sudo apt install tableplus
tableplus

Conexión con la Base de Datos

Para probar la conexión a la base de datos modificamos la siguiente ruta del archivo web.php :

<?php
Route::get('/', function () {
    try {
        DB::connection()->getPdo();
        $caught = false;
    } catch (Exception $e) {
        $caught = true;
        die("No se pudo conectar a la base de datos.  Por favor, revisa tu configuración. error:" . $e );
    }

    if(!$caught){
        echo 'Conexión Correcta ¡¡¡';
    }
});

Servidor de Laravel

Iniciamos el servidor :

php artisan serve

Con esto debemos tener un servidor corriendo en la siguiente dirección http://127.0.0.1:8000.

Y si todo ha ido bien, debe darnos el siguiente resultado :

Conexión Correcta ¡¡¡
Navegador

Paso 6 – Configurar el Visual Studio Code para Laravel

Estas extensiones son las que yo utilizo para desarrollar de forma más productiva :

PHP Intelephense
PHP Namespace Resolver
php cs fixer
Laravel Snippets
Laravel Blade Snippets
SQLTools
SQLTools MySQL/MariaDB

Si tienes algo que añadir utiliza los comentarios. Espero que halla resultado útil.