📘 ProcĂ©dure d'installation – Backend MES (Environnement de Qualification) NB : AprĂšs l’installation de tous les composants, NE PAS exĂ©cuter « apt upgrade » NB: Si erreur au lieu d'aller voir Chat regarder les erreur documenter a la fin du document ──────────────────────────────────────────────────── 🔧 1. Installation de PHP (version 8.3) a) Ajouter le dĂ©pĂŽt PHP : sudo add-apt-repository ppa:ondrej/php b) Mettre Ă  jour la liste des paquets : sudo apt update c) Installer PHP 8.3 et quelques modules essentiels : sudo apt install php8.3 php8.3-cli php8.3-{bz2,curl,mbstring,intl} d) Installer PHP-FPM : sudo apt install php8.3-fpm e) Mettre Ă  jour de nouveau : sudo apt update 📩 2. Installation de Composer et des extensions PHP sudo bash -c ' apt-get update && apt-get install -y --no-install-recommends \ cron \ curl \ firebird-dev \ ftp \ git \ libjpeg-dev \ libmagickwand-dev \ libpng-dev \ libzip-dev \ nodejs \ openssl \ redis-tools \ unzip \ zip \ zlib1g-dev \ php \ php-cli \ php-fpm \ php-dev \ php-pear \ php-mysql \ php-gd \ php-zip \ php-xml \ php-redis \ php-interbase \ && curl -sS https://getcomposer.org/installer | php -- \ --install-dir=/usr/local/bin --filename=composer # Nettoyage sudo rm -rf /var/lib/apt/lists/* # Installer Composer cd ~ curl -sS https://getcomposer.org/installer -o composer-setup.php sudo php composer-setup.php --install-dir=/usr/local/bin --filename=composer # Installer Redis via PECL sudo pecl install redis # Activer Redis pour PHP echo "extension=redis.so" | sudo tee /etc/php/8.3/mods-available/redis.ini sudo phpenmod redis # Activer les modules PHP installĂ©s (si besoin) sudo phpenmod gd mysql zip xml ftp pcntl interbase curl bz2 mbstring intl # RedĂ©marrer Apache pour prendre en compte les modifications sudo systemctl restart apache2 🧠 3. Installation de Redis a) Installer les paquets requis : sudo apt-get install lsb-release curl gpg b) Importer la clĂ© GPG de Redis : curl -fsSL https://packages.redis.io/gpg | sudo gpg --dearmor -o /usr/share/keyrings/redis-archive-keyring.gpg c) Ajuster les permissions : sudo chmod 644 /usr/share/keyrings/redis-archive-keyring.gpg d) Ajouter le dĂ©pĂŽt Redis : echo "deb [signed-by=/usr/share/keyrings/redis-archive-keyring.gpg] https://packages.redis.io/deb $(lsb_release -cs) main" | sudo tee /etc/apt/sources.list.d/redis.list e) Installer Redis : sudo apt-get update sudo apt-get install redis f) Activer et dĂ©marrer Redis : sudo systemctl enable redis-server sudo systemctl start redis-server 🧰 4. (Optionnel) RĂ©installation ou vĂ©rification de Composer curl -sS https://getcomposer.org/installer -o composer-setup.php sudo php composer-setup.php --install-dir=/usr/local/bin --filename=composer sudo composer self-update composer -v 🔗 5. Clonage du dĂ©pĂŽt Git git clone https://gitlab.dev.docaret.com/tracknlocate/mes/mes-api.git ⚙ 6. Configuration de l’environnement cd mes-api cp .env.example .env Modifier le fichier .env : APP_TIMEZONE : Europe/London → Europe/Paris APP_LANGUAGE : an → fr APP_FRONT_URL : localhost → https://nom_domaine_front DB_HOST : db_MariaDb → http://@ip_serveurDB ELASTICSEARCH_HOST : elastichsearch → http://@ip_serveurDB REDIS_HOST : http://localhost → localhost đŸ—ïž 7. Installation des dĂ©pendances et initialisation a) Installer les outils de compilation : sudo apt install build-essential b) Installer les dĂ©pendances PHP : composer install --no-interaction si erreur : Your lock file does not contain a compatible set of packages. Please run composer update. solution : sudo apt-get update sudo apt-get install php-curl c) GĂ©nĂ©rer la clĂ© de l’application : php artisan key:generate d) Lancer les migrations : php artisan migrate (En cas d’échec, vĂ©rifier les logs et les extensions manquantes) 🌐 8. CrĂ©ation d’un VirtualHost Apache (HTTP uniquement) ServerName mes-api.qualif.tracknlocate.loc DocumentRoot "/home/tracknlocate/mes-api/public" Header always set Access-Control-Allow-Origin "https://mes.qualif.tracknlocate.loc" Header always set Access-Control-Allow-Methods "POST, GET, OPTIONS, PUT, DELETE" Header always set Access-Control-Allow-Headers "Authorization, Content-Type, X-Requested-With" Header always set Access-Control-Allow-Credentials "true" Options Indexes FollowSymLinks AllowOverride All Require all granted ErrorLog ${APACHE_LOG_DIR}/mes-api-error.log CustomLog ${APACHE_LOG_DIR}/mes-api-access.log combined 🧯 9. RĂ©solution des problĂšmes courants a) ProblĂšme d’accĂšs aux logs Laravel Erreur : The stream or file "/home/tracknlocate/mes-api/storage/logs/laravel-2025-03-21.log" could not be opened in append mode: Permission denied Solution : sudo chgrp -R www-data /home/tracknlocate/mes-api/storage sudo chmod -R 775 /home/tracknlocate/mes-api/storage b) Classe "Redis" non trouvĂ©e Cause : installation de l’extension Redis pour une mauvaise version de PHP (ex. PHP 8.4 au lieu de 8.3) Solution – installation manuelle depuis GitHub : sudo apt install php8.3-dev gcc make autoconf -y git clone https://github.com/phpredis/phpredis.git cd phpredis git checkout 6.0.2 phpize8.3 ./configure --with-php-config=/usr/bin/php-config8.3 make sudo make install echo "extension=redis.so" | sudo tee /etc/php/8.3/mods-available/redis.ini sudo phpenmod -v 8.3 redis sudo systemctl restart apache2 # VĂ©rification : php -m | grep redis c) Composer detected issues in your platform: Your Composer dependencies require a PHP version ">= 8.4.0". (en gros votre composer tourne sur php 8.4 alors que apache tourne avec une version plus ancienne genre 8.1, 8.2 ou 8.3 donc ça bloque la communication entre le front est le back) solution : sudo apt-get update sudo apt-get install \ php8.4 \ libapache2-mod-php8.4 \ php8.4-common \ php8.4-mbstring \ php8.4-xml \ php8.4-mysql \ php8.4-curl \ php8.4-zip \ php8.4-gd ls /etc/apache2/mods-enabled/php*.load sudo a2dismod php8.1 # ou php8.2, php8.3 selon ce que tu vois sudo a2enmod php8.4 sudo systemctl restart apache2 d) The stream or file "/app/mes-api/storage/logs/laravel-2025-11-12.log" could not be opened in append mode: Failed to open stream: Permission denied The exception occurred while attempting to log erreur de permission dans les fichier de logs de laravel solution : sur le serveur back faire ça : cd /app/mes-api # Apache tourne quasi sĂ»rement sous www-data:www-data sudo chown -R www-data:www-data storage bootstrap/cache # Permissions propres sudo find storage -type d -exec chmod 775 {} \; sudo find storage -type f -exec chmod 664 {} \; sudo chmod -R 775 bootstrap/cache php artisan config:clear php artisan cache:clear puis retester d) RedisException PHP 8.4.14 12.3.0 Unable to find the socket transport "http" - did you forget to enable it when you configured PHP? (mauvaise conf redis vien quasi toujours du .env dans le back) solution: dans le .env du back enlever le http devant le localhost ✅ Fin de la procĂ©dure. Bonne installation et bon apprentissage ! sudo bash -c ' apt-get update && apt-get install -y --no-install-recommends \ cron \ curl \ firebird-dev \ ftp \ git \ libjpeg-dev \ libmagickwand-dev \ libpng-dev \ libzip-dev \ nodejs \ openssl \ redis-tools \ unzip \ zip \ zlib1g-dev \ php \ php-cli \ php-fpm \ php-dev \ php-pear \ php-mysql \ php-gd \ php-zip \ php-xml \ php-redis \ php-interbase \ && curl -sS https://getcomposer.org/installer | php -- \ --install-dir=/usr/local/bin --filename=composer '