PHPackages adyax/french-zip-code - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Utility & Helpers](/categories/utility) 4. / 5. adyax/french-zip-code ActiveLibrary[Utility & Helpers](/categories/utility) adyax/french-zip-code ===================== 3.0.9(6y ago)04.2kMIT Since Jun 19Pushed 6y ago3 watchersCompare [ Source](https://github.com/Adyax/French-zip-code)[ Packagist](https://packagist.org/packages/adyax/french-zip-code)[ RSS](/packages/adyax-french-zip-code/feed)WikiDiscussions master Synced today READMEChangelog (9)DependenciesVersions (14)Used By (0) French Zip-Code =============== [](#french-zip-code) A propos -------- [](#a-propos) L'objectif de ce dépôt est de maintenir une liste la plus à jour possible des régions, départements, villes et villages Français en Métropole, Département et Région d'Outre-Mer (*DROM*) et Collectivités d'Outre-Mer (*COM*). Origine des données ------------------- [](#origine-des-données) Les données utilisées proviennent du site de l'INSEE : - Métropole et DROM : - [*2018-03-28* - Régions](https://www.insee.fr/fr/information/3363419#titre-bloc-26) - [*2018-03-28* - Départements](https://www.insee.fr/fr/information/3363419#titre-bloc-23) - [*2018-03-28* - Villes](https://www.insee.fr/fr/information/3363419#titre-bloc-7) - COM : - [*2017-03-01* - Régions, Départements, Villes](https://www.insee.fr/fr/information/2028040) ### Métropole et DROM ⚠️ [](#métropole-et-drom-warning) Les fichiers fournit sont au format *.txt* encodés en **ISO-8859-15** avec **CRLF**. Il convient de les convertir en **UTF-8** avec **LF**. ### COM [](#com) La page indiquer est la ressource disponible, elle est donc parsée afin d'extraire la liste de entitées *Départements, villes et villages*. Clone, outils requis et commandes --------------------------------- [](#clone-outils-requis-et-commandes) Le dépôt utilise plusieurs technologies requises sur votre système d'exploitation : - [Docker](https://www.docker.com/) afin de concevoir les environnements de travail (*apache, php7 et mysql*). - [Make](http://www.gnu.org/software/make/) afin de mettre des commandes simple à disposition (*Makefile*). - Cloner le projet dans un répertoire de votre ordinateur. - Mettez à jour les fichiers présent dans `./storage/builder` avec les nouvelles ressources de l'INSEE : - cities.txt - departments.txt - regions.txt - Editer le ficher `.env.exemple` et enregistrer le sous `.env`, modifier les différentes variables requises : - **APP\_KEY** pour un bon fonctionnement de l'appli. - **GOOGLE\_MAPS\_KEY** une clé valide d'accès à [Google Maps API Geocoding](https://developers.google.com/maps/documentation/geocoding/start?hl=fr). - **COM\_URI** si la ressource des COM de l'INSEE à changer. - Dirigez vous dans son dossier en ligne de commande. - Faite alors un `make start` qui vas lancer le projet via docker. - Une fois le projet initialisé, faite un `make builder` qui vas lancer au travers des containers docker la récupération. - Lorsque le build sera terminer, vous pourrez demander un export des données dans `./Exports` via la commande `make export`. ### Commandes make [](#commandes-make) - `make help` permet de lister toutes les commandes disponible. - `make start` permet de lancer le projet. - `make stop` permet de stopper le projet. - `make restart` composition de `make stop` et `make start` permet de relancer le projet. - `make builder` permet de lancer la génération des données. - `make export` permet de lancer l'export des données générer. Participer ---------- [](#participer) Si vous le souhaitez vous pouvez participer à ce projet en améliorant le système : - De build utiliser par `php artisan builder:build` - D'export utiliser par `php artisan builder:export` Releases -------- [](#releases) Les données sont fournit dans 3 formats (*csv, json et sql*) afin que le maximum de personnes puissent les utiliser. Les fichiers disponibles utilisent un systeme de liaison permettant de naviger facilement entre les listes utilisant les codes INSEE de l'élément cible. Vous trouverez ci-dessous les éléments listés dans chaque fichiers. ### Régions (*regions*) [](#régions-regions) InformationCléL'ID unique*id*Le code INSEE de la région*code*Le nom*name*L'identifiant*slug*### Départements (*departments*) [](#départements-departments) InformationCléL'ID unique*id*La code INSEE de la région de référence*region\_code*Le code INSEE du département*code*Le nom*name*L'identifiant*slug*### Villes et villages (*cities*) [](#villes-et-villages-cities) InformationCléL'ID unique*id*Le code INSEE du département de référence*department\_code*Le code INSEE de la ville / du village*code*Le code postal*zip\_code*Le nom*name*L'identifiant*slug*La latitude*gps\_lat*La longitude*gps\_lng*Pourquoi ce dépôt ----------------- [](#pourquoi-ce-dépôt) En effet, les listes actuellement disponible sur internet ne sont visiblement pas à jour, qu'elle proviennent d'organisme tel que [data.gouv.fr](https://www.data.gouv.fr/fr/datasets/base-officielle-des-codes-postaux/) ou de site tel que [sql.sh](http://sql.sh/736-base-donnees-villes-francaises) ### Health Score 34 — LowBetter than 75% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity20 Limited adoption so far Community10 Small or concentrated contributor base Maturity70 Established project with proven stability Bus Factor1 Top contributor holds 63.3% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~52 days Recently: every ~21 days Total 11 Last Release 2418d ago Major Versions 2.0.0 → 3.0.02018-07-05 ### Community Maintainers ![](https://avatars.githubusercontent.com/u/5019669?v=4)[P1ratRuleZZZ](/maintainers/p1ratrulezzz)[@p1ratrulezzz](https://github.com/p1ratrulezzz) --- Top Contributors [![Stanislas-Poisson](https://avatars.githubusercontent.com/u/3681410?v=4)](https://github.com/Stanislas-Poisson "Stanislas-Poisson (38 commits)")[![p1ratrulezzz](https://avatars.githubusercontent.com/u/5019669?v=4)](https://github.com/p1ratrulezzz "p1ratrulezzz (22 commits)") --- Tags zip codefranceINSEEregionsvillepaysdepartments ### Embed Badge ![Health badge](/badges/adyax-french-zip-code/health.svg) ``` [![Health](https://phpackages.com/badges/adyax-french-zip-code/health.svg)](https://phpackages.com/packages/adyax-french-zip-code) ``` ### Alternatives [ip2location/ip2location-php \[Official Release\] IP2Location PHP API to get location info from IPv4 and IPv6 address. 2244.2M37](/packages/ip2location-ip2location-php)[pragmarx/zipcode A worldwide address-by-zipcode searcher. 10265.8k](/packages/pragmarx-zipcode)[juanparati/iso-codes A PHP library that provides ISO codes, currencies, languages, timezones and additional geopolitical information 17174.9k](/packages/juanparati-iso-codes)[gerardojbaez/geodata Laravel 5.2 package that provides basic geographical data like Countries, Regions and Cities. 3212.0k](/packages/gerardojbaez-geodata)[plin-code/laravel-istat-geography Laravel package for importing and managing Italian geography data from ISTAT 107.0k](/packages/plin-code-laravel-istat-geography) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)