📌 Esquema d'instal·lació i configuració de Laravel en Ubuntu
🛠️ Instal·lació de dependències
- Instal·lar Node.js, NPM i un editor de text.
sh sudo apt update && sudo apt install -y nodejs npm nano - Instal·lar PHP seguint la documentació oficial (veure enllaç):
sh sudo apt install -y php php-cli php-mbstring php-xml php-curl php-tokenizer php-zip php-openssl php-pdo php-mysql php-session php-json php-fileinfo php-phar php-fpm curl git unzip - Instal·lar Composer i l'instal·lador de Laravel.
sh sudo curl -sS https://getcomposer.org/installer | sudo php -- --install-dir=/usr/local/bin --filename=composer
🏗️ Creació d'un projecte Laravel
- Accedir a la carpeta compartida definida al docker-compose.yml (/laravel).
sh cd /laravel - Crear una nova aplicació Laravel seleccionant opcions específiques (MariaDB, NO a les preguntes).
sh composer create-project --prefer-dist laravel/laravel myapp - Entrar a la carpeta del projecte.
sh cd myapp
🔑 Instal·lació d'autenticació amb Laravel Breeze
- Instal·lar Laravel Breeze.
sh composer require laravel/breeze --dev - Seleccionar opcions específiques durant la instal·lació (Blade with Alpine, YES, PEST).
sh php artisan breeze:install blade --yes npm install && npm run dev
🚀 Provar Laravel
- Executar el servidor de Laravel.
sh php artisan serve --host=0.0.0.0 --port=8000 & - Verificar que Laravel està funcionant correctament amb una petició HTTP amb CURL.
sh curl -I http://localhost:8000
🛠️ Assignació de permisos
- Assignar permisos a carpetes específiques perquè Laravel pugui modificar-les.
sh sudo chown -R www-data:www-data /laravel/myapp sudo chmod -R 775 /laravel/myapp/storage /laravel/myapp/bootstrap/cache
📦 Configuració de la base de dades i migració
- Editar el fitxer de configuració .env per definir els paràmetres de connexió a MySQL.
sh cp .env.example .env nano .env - Aplicar la migració de la base de dades.
sh php artisan migrate - Verificar que les taules s'han creat correctament accedint a la base de dades MySQL.
sh mysql -u root -p -e "SHOW DATABASES;"
📌 Comandes addicionals
- Instal·lar les dependències i recompilar el frontend.
sh npm install && npm run dev - Recompilar les dependències de Laravel.
sh composer install --optimize-autoloader --no-dev - Netejar cache de configuració de Laravel.
sh php artisan config:clear && php artisan cache:clear
🔧 Instal·lació i configuració de PHP-FPM
- Instal·lar PHP-FPM.
sh sudo apt install -y php-fpm - Verificar la instal·lació de PHP-FPM.
sh php-fpm -v - Editar la configuració de PHP-FPM per modificar l'usuari, el grup i la configuració de connexió.
sh sudo nano /etc/php/8.1/fpm/pool.d/www.conf - Crear manualment l'usuari i el grup que hem establert al fitxer de configuració.
sh sudo useradd -r -M -d /var/www -s /usr/sbin/nologin www-data
🚀 Iniciar PHP-FPM
- Iniciar manualment el servei de PHP-FPM.
sh sudo systemctl start php8.1-fpm - Verificar si el port està ocupat i solucionar possibles conflictes.
sh sudo netstat -tulnp | grep php-fpm