camerzone/laravel-zones

Gestion des zones administratives du Cameroun

v1.0.0 2025-05-28 05:49 UTC

Requires

• php: >=8.0
• illuminate/database: >=9.0.0
• illuminate/support: >=9.0.0

MIT

README

Un package Laravel pour gérer les zones géographiques du Cameroun (Régions, Divisions, Arrondissements).

Installation

Vous pouvez installer le package via Composer :

composer require camerzone/laravel-zones

Configuration

Publiez les fichiers de configuration et de migration :

php artisan vendor:publish --provider="Camerzone\LaravelZones\ZoneServiceProvider"

Exécutez les migrations :

php artisan migrate

Le package inclut des seeders pour peupler la base de données avec les données géographiques du Cameroun. Vous pouvez exécuter tous les seeders en une seule commande :

php artisan db:seed --class=PackageDatabaseSeeder

Structure des données

Le package utilise une structure hiérarchique pour les zones :

• Niveau 1 : Régions
• Niveau 2 : Départements
• Niveau 3 : Divisions
• Niveau 4 : Arrondissements

Utilisation

Modèle Zone

use Camerzone\LaravelZones\Models\Zone;

// Récupérer toutes les régions
$regions = Zone::where('level_id', 1)->get();

// Récupérer toutes les divisions
$divisions = Zone::where('level_id', 3)->get();

// Récupérer les arrondissements d'une division
$arrondissements = Zone::where('parent_id', $divisionId)->get();

Relations

Le modèle Zone inclut des relations pour faciliter la navigation dans la hiérarchie :

$zone = Zone::find($id);

// Récupérer la division parente
$parent = $zone->parent;

// Récupérer les arrondissements enfants
$children = $zone->children;

Contribution

Les contributions sont les bienvenues ! N'hésitez pas à ouvrir une issue ou à soumettre une pull request.

Licence

Ce package est open-sourced sous la licence MIT.