📌 Esquema d'instal·lació i configuració de Laravel en Alpine¶

🛠️ Instal·lació de dependències¶

Instal·lar Node.js, NPM i un editor de text.
```
apk add --no-cache nodejs npm nano
```

Instal·lar PHP seguint la documentació oficial (veure enllaç):

/bin/bash -c "$(curl -fsSL https://php.new/install/linux/8.4)"

Instal·lar Composer i l'instal·lador de Laravel.
```
composer global require laravel/installer
```

🏗️ Creació d'un projecte Laravel¶

Accedir a la carpeta compartida definida al docker-compose.yml (/laravel).
```
cd laravel
```
Crear una nova aplicació Laravel seleccionant opcions específiques (MariaDB, NO a les preguntes).
```
laravel new sergi-app
```
Entrar a la carpeta del projecte.
```
cd sergi-app
```

🔑 Instal·lació d'autenticació amb Laravel Breeze¶

Instal·lar Laravel Breeze.
```
composer require laravel/breeze --dev
```
Seleccionar opcions específiques durant la instal·lació (Blade with Alpine, YES, PEST).
```
php artisan breeze:install
```

🚀 Provar Laravel¶

Executar el servidor de Laravel.
```
php artisan serve
```
Verificar que Laravel està funcionant correctament amb una petició HTTP amb CURL.
```
curl http://localhost:8000
```

🛠️ Assignació de permisos¶

Assignar permisos a carpetes específiques perquè Laravel pugui modificar-les.

Verifica quines són les carpetes en qüestió i quin és l'usuari que haurà d'accedir

chmod -R 775 /laravel/sergi-app/storage /laravel/sergi-app/bootstrap/cache
chown -R www-data:www-data /laravel/sergi-app/storage /laravel/sergi-app/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.
```
nano .env
```

Veure Contingut

DB_CONNECTION=mysql
DB_HOST=mysql # Nom del servei del contenidor MySQL (com ho vas definir en docker-compose.yml)
DB_PORT=3306 # Port per defecte de MySQL
DB_DATABASE=laravel_db # Nom de la base de dades (laravel_db)
DB_USERNAME=sergiColl # L'usuari de MySQL que acabes de crear
DB_PASSWORD= # La contrasenya de l'usuari (en aquest cas està buida, per la qual cosa el deixem buit)

Aplicar la migració de la base de dades.
```
php artisan migrate
```
Verificar que les taules s'han creat correctament accedint a la base de dades MySQL.
```
mysql -u root
USE laravel_db;
SHOW TABLES;
```

📌 Comandes addicionals¶

Instal·lar les dependències i recompilar el frontend.
```
npm install && npm run build
```
Recompilar les dependències de Laravel.
```
composer dump-autoload
```

Netejar chaché de configuració de Laravel.

php artisan config:clear
php artisan cache:clear

🔧 Instal·lació i configuració de PHP-FPM¶

Instal·lar PHP-FPM.
```
apk add --no-cache php84-fpm
```
Verificar la instal·lació de PHP-FPM.
```
php-fpm84 -v
```
Editar la configuració de PHP-FPM per modificar l'usuari, el grup i la configuració de connexió.
```
nano /etc/php84/php-fpm.d/www.conf
```

Veure Contingut

user = www-data
group = www-data

Crear manualment l'usuari i el grup que hem establert al fitxer de configuració.
```
addgroup -S www-data
adduser -S -G www-data www-data
```

🚀 Iniciar PHP-FPM¶

Iniciar manualment el servei de PHP-FPM.
```
php-fpm84 
```
Verificar si el port està ocupat i solucionar possibles conflictes.
```
netstat -tuln | grep 9000
pkill php-fpm84
php-fpm84
```