yii2-module/yii2-insee-ban

A module that structures the data of the Base des Adresses Nationales (fr : BAN) from the INSEE and others

7.0.6 2024-12-13 10:36 UTC

Requires

• php: >=8.0
• php-extended/php-api-fr-insee-ban-object: ^7
• php-extended/php-basic-console-logger: ^7
• php-extended/php-http-client-factory-object: ^7
• php-extended/php-http-message-factory-psr17: ^7
• php-extended/php-multiple-logger: ^7
• php-extended/php-slugifier-object: ^7
• php-extended/polyfill-str-levenshtein: ^1
• yii2-extended/yii2-module-metadata-object: ^7
• yii2-extended/yii2-psr3-logger-bridge: ^7
• yii2-module/yii2-insee-cog: ^7
• yii2-module/yii2-log: ^7
• yii2-module/yii2-module-helper: ^7
• yiisoft/yii2: ^2

Requires (Dev)

• php-extended/placeholder-phpunit: ^9

MIT

• Anastaszor

• php
• address
• group
• base
• position
• INSEE
• france
• yii2
• ign
• ban
• dgfip
• etalab
• nationale
• adresses

README

A module that structures the data of the Base des Adresses Nationales (fr : BAN) from the INSEE and others.

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 install yii2-module/yii2-insee-ban ^7

Configuration

This module needs the following components to be set at the configuration level:

• 'db_insee_ban' should be a \yii\db\Connection

If you already have a database connection, you may use the following trick :

'db_insee_ban' => function() { return \Yii::$app->get('db'); },

where 'db' is the id of your database connection.

This module uses the following parameters to be set at the configuration level:

• InseeBanModule::tempDirPath may be configured to a valid directory or alias known by Yii. Its default is @app/runtime/insee-ban, which is automatically created if it does not exist. This parameter is used to download and uncompress the csv source files of the BAN, and should be cleared occasionnally.

Then the module should be configured as follows (in console.php or web.php) :

$config = [
	...
	'modules' => [
		...
		'insee-ban' => [
			'class' => 'Yii2Module\Yii2InseeBan\InseeBanModule',
		],
		...
	],
	...
];

License

MIT (See license file)