Skip to content

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

🛠️ Instal·lació de dependències

  1. Instal·lar Node.js, NPM i un editor de text.
    sh sudo apt update && sudo apt install -y nodejs npm nano
  2. 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
  3. 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

  1. Accedir a la carpeta compartida definida al docker-compose.yml (/laravel).
    sh cd /laravel
  2. Crear una nova aplicació Laravel seleccionant opcions específiques (MariaDB, NO a les preguntes).
    sh composer create-project --prefer-dist laravel/laravel myapp
  3. Entrar a la carpeta del projecte.
    sh cd myapp

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

  1. Instal·lar Laravel Breeze.
    sh composer require laravel/breeze --dev
  2. 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

  1. Executar el servidor de Laravel.
    sh php artisan serve --host=0.0.0.0 --port=8000 &
  2. Verificar que Laravel està funcionant correctament amb una petició HTTP amb CURL.
    sh curl -I http://localhost:8000

🛠️ Assignació de permisos

  1. 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ó

  1. Editar el fitxer de configuració .env per definir els paràmetres de connexió a MySQL.
    sh cp .env.example .env nano .env
  2. Aplicar la migració de la base de dades.
    sh php artisan migrate
  3. 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

  1. Instal·lar les dependències i recompilar el frontend.
    sh npm install && npm run dev
  2. Recompilar les dependències de Laravel.
    sh composer install --optimize-autoloader --no-dev
  3. Netejar cache de configuració de Laravel.
    sh php artisan config:clear && php artisan cache:clear

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

  1. Instal·lar PHP-FPM.
    sh sudo apt install -y php-fpm
  2. Verificar la instal·lació de PHP-FPM.
    sh php-fpm -v
  3. 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
  4. 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

  1. Iniciar manualment el servei de PHP-FPM.
    sh sudo systemctl start php8.1-fpm
  2. Verificar si el port està ocupat i solucionar possibles conflictes.
    sh sudo netstat -tulnp | grep php-fpm