PHP download

Download the PHP package kaveraa/api-gouv-publique-fr without Composer

On this page you can find all versions of the php package kaveraa/api-gouv-publique-fr. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.

Table of contents
Download kaveraa/api-gouv-publique-fr
More information about kaveraa/api-gouv-publique-fr
Files in kaveraa/api-gouv-publique-fr

Vendor kaveraa
Package api-gouv-publique-fr
Short Description Typed PHP client for French public APIs (company search, address and Geo) with Laravel and Symfony bridges. Unofficial.
License MIT
Homepage https://github.com/kaveraa/api-gouv-publique-fr

Keywords symfony geo bundle laravel Siren Siret commune france ban adresse open-data api-gouv

FAQ

After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.

Example:

If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.

In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.

Some PHP packages are not free to download and because of that hosted in private repositories. In this case some credentials are needed to access such packages. Please use the auth.json textarea to insert credentials, if a package is coming from a private repository. You can look here for more information.

Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
To use Composer is sometimes complicated. Especially for beginners.
Composer needs much resources. Sometimes they are not available on a simple webspace.
If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.

Please rate this library. Is it a good library?

Example code of kaveraa/api-gouv-publique-fr

Informations about the package api-gouv-publique-fr

API Gouv Publique FR

English - Français

A typed PHP client for French public APIs. Version 0.1 covers company search ("Recherche d'entreprises") and address search (the BAN, served by the Geoplateforme). Version 0.2 adds the Geo API (communes, departements, regions, EPCI). Version 0.3 adds a Symfony bundle. It works in any PHP project. It has optional bridges for Laravel and Symfony. Version 1.0 is stable: see the backward compatibility promise.

This is an unofficial project. It is not affiliated with the French State.

Requirements

PHP 8.3 or newer
Laravel 12 or 13 (optional)
Symfony 7.4 or 8 (optional)

Install

Laravel example

Plain PHP example

This example uses Symfony HttpClient as the PSR-18 client and Nyholm as the PSR-17 factory.

Guides

Quick start
Company search
Address search
Geo API
Laravel
Symfony
Plain PHP
Errors, cache and rate limit
Testing
Backward compatibility
Upgrade from 0.3 to 0.4
FAQ

Features

Typed objects (DTOs) for companies, establishments, managers, addresses, communes, departements, regions and EPCI.
One exception class per problem, all with a common parent: ApiException.
Optional response cache, off by default. It works with any PSR-16 cache.
Rate limit retry in Laravel (HTTP 429).
Laravel validation rules: Siren, Siret and EntrepriseExiste.
Symfony bundle: configuration, autowired clients and a response cache on a cache pool.
Symfony validation constraints: Siren, Siret and EntrepriseExiste.
Test fakes and factories for your own tests, and a fake mode for Symfony tests.

Not included

The INSEE SIRENE API is not included.

Unofficial notice

This package is not made by the French State and is not affiliated with it. "api.gouv.fr" and the API names belong to their owners. Please read the terms of use of each API.

License

MIT. See LICENSE.

Contributing

See SECURITY.md.

All versions of api-gouv-publique-fr with dependencies

PHP Build Version

Package Version

Version v1.0.0 Release 01. Oct 2026
create-project require 0 people chose require and
0 people chose create-project.

Download

Download latest version of api-gouv-publique-fr from vendor kaveraa

Requires php Version ^8.3
ext-json Version *
psr/http-client Version ^1.0
psr/http-factory Version ^1.0
psr/simple-cache Version ^2.0 || ^3.0

Composer command for our command line client (download client) This client runs in each environment. You don't need a specific PHP version etc. The first 20 API calls are free. Standard composer command

The package kaveraa/api-gouv-publique-fr contains the following files

Loading the files please wait ...