README

实现 php-extended/php-api-fr-insee-sirene-interface 库的库。

安装

此库通过 composer 安装，所有类的自动加载都通过其自动加载器完成。

• 从他们的网站下载 composer.phar。
• 然后运行以下命令将此库作为依赖项安装
• php composer.phar php-extended/php-api-fr-insee-sirene-object ^7

基本用法

此库提供了一个独特的端点：\PhpExtended\Insee\InseeCogEndpoint，可以从该端点检索所有数据。

• 对于大多数用法，您可以使用以下代码

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 */
}

请注意，客户端必须遵循一些关于通过 X-Php-Download-File 请求和响应头处理文件的规定，以便能够解压缩下载的文件而无需使用数GB的内存。它还必须返回一个 X-Request-Uri 头，以获取完整的 URI。

要查看所需的最小 HTTP 客户端示例，请查看 InseeSireneEndpointTest 类文件，并找到使用的客户端。

但是，如果您有足够的内存，则可以绕过 ZipHttpEndpoint 以及所有 X-Php-Download-File 和 X-Request-Uri 的小把戏。

许可证

• 代码在 MIT 许可下（见许可证文件）。

• 数据在开放许可证下（英文 / 法语）。

• 这些数据包含个人可识别信息（PII），应按照 GDPR 进行处理。