⚙️ Installation

Guide complet pour installer et configurer l'intégrateur e-MECeF

⚠️

Prérequis

  • • PHP 8.0 ou supérieur
  • • Laravel 9.x ou supérieur
  • • Composer installé
  • • Connexion Internet (pour les appels API e-MECeF)
  • • Identifiants e-MECeF valides (NIM, TOKEN, IFU)
1

Cloner le Projet

Via Git

git clone https://github.com/votre-username/laravel-emecef-integrator.git
cd laravel-emecef-integrator

Ou télécharger le ZIP

📥 Télécharger ZIP Puis extraire dans votre dossier de projets
2

Installation des Dépendances

Installer les packages PHP

composer install

Copier le fichier d'environnement

cp .env.example .env

Générer la clé d'application

php artisan key:generate
3

Configuration

Configuration de base dans le fichier .env

# Configuration de l'application
APP_NAME="e-MECeF Integrator"
APP_ENV=local
APP_DEBUG=true
APP_URL=http://localhost:8000

# Base de données (optionnel pour les logs)
DB_CONNECTION=sqlite
# DB_HOST=127.0.0.1
# DB_PORT=3306
# DB_DATABASE=laravel
# DB_USERNAME=root
# DB_PASSWORD=

# Logs
LOG_CHANNEL=daily
LOG_DEPRECATIONS_CHANNEL=null
LOG_LEVEL=debug
ℹ️

Note importante

Ce service n'utilise pas de variables d'environnement pour les identifiants e-MECeF. Chaque utilisateur de votre API fournira ses propres identifiants (NIM, TOKEN, IFU) dans ses requêtes.

4

Démarrer le Serveur

Lancer le serveur de développement

php artisan serve

Le serveur sera disponible sur http://localhost:8000

Ou avec un port personnalisé

php artisan serve --port=8080
5

Vérification de l'Installation

Tester l'API de base

curl http://localhost:8000/api/emecef/info

✅ Réponse attendue : Informations sur l'API avec status "success": true

Accéder à la documentation

🐳 Installation avec Docker (Optionnel)

Créer le fichier docker-compose.yml

version: '3.8'
services:
  app:
    build: .
    ports:
      - "8000:8000"
    volumes:
      - .:/var/www/html
    environment:
      - APP_ENV=local
      - APP_DEBUG=true

Lancer avec Docker

docker-compose up -d

🔧 Dépannage

Erreur : "Class 'App\Services\EmecefService' not found"

Solution : Régénérer l'autoload Composer

composer dump-autoload

Erreur : "Permission denied"

Solution : Définir les bonnes permissions

chmod -R 755 storage bootstrap/cache

Port déjà utilisé

Solution : Utiliser un autre port

php artisan serve --port=8080

🎉 Installation Terminée !

Votre intégrateur e-MECeF est maintenant prêt. Voici les prochaines étapes :