php-extended/php-api-fr-insee-sirene-object

A library that implements the php-extended/php-api-fr-insee-sirene-interface library

7.1.4 2024-12-09 07:50 UTC

Requires

• php: >=8.0
• php-extended/php-api-fr-insee-ban-object: ^7
• php-extended/php-api-fr-insee-sirene-interface: ^7.1
• php-extended/php-data-provider-csv: ^7
• php-extended/php-http-message-factory-psr17: ^7
• php-extended/php-reifier-object: ^7

Requires (Dev)

• php-extended/php-http-client-zip: ^7
• php-extended/placeholder-phpunit: ^9

MIT

• Anastaszor

• php
• api
• object
• implementation
• sirene
• insee.fr

README

A library that implements the php-extended/php-api-fr-insee-sirene-interface library.

Installation

The installation of this library is made via composer and the autoloading of all classes of this library is made through their autoloader.

• Download composer.phar from their website.
• Then run the following command to install this library as dependency :
• php composer.phar php-extended/php-api-fr-insee-sirene-object ^7

Basic Usage

This library gives an unique endpoint : \PhpExtended\Insee\InseeCogEndpoint from which all data can be retrieved.

• For most usages, you may use the following code :

use PhpExtended\Insee\InseeSireneEndpoint;
use PhpExtended\Endpoint\ZipHttpEndpoint;
use PhpExtended\Endpoint\HttpEndpoint;

/** $client \Psr\Http\Client\ClientInterface */

$endpoint = new InseeSireneEndpoint(new ZipHttpEndpoint(new HttpEndpoint($client)));

$unitesLegales = $endpoint->getLatestStockUniteLegaleIterator();

foreach($unitesLegales as $uniteLegale)
{
	/** @var $sireneLine \PhpExtended\Insee\InseeSireneUniteLegaleInterface */
}

Be wary that the client must follow a certain number of rules regarding the handling of files via the X-Php-Download-File request and response headers for the ZipHttpEndpoint to be able to unzip the downloaded file without having to use gigabytes of memory. It must also return an X-Request-Uri header to get the full uri back.

For an example of the minimal needed http client, look at the InseeSireneEndpointTest class file and find the client that is used.

If you have that much memory however, you can bypass the ZipHttpEndpoint and all of the X-Php-Download-File and X-Request-Uri shenanigans altogether.

License

• The code is under MIT (See license file).

• The data is under Open License (English / Français)

• This data contains Personal Identifiable Information (PII) and should be taken care of accordingly to the GDPR.