Comment configurer l'accès à MySQL/MariaDB ?

Pré-requis

  1. avoir créé une base de données MySQL/MariaDB ;
  2. avec au moins une table ;
  3. et un accès utilisateur et mot de passe.

Configuration de l'accès à MySQL/MariaDB

Dans le dossier de configuration ./application/configuration/ :

  1. copier/coller le fichier modèle _sample.loc.datasource.cfg.php ;
  2. renommer le fichier copié en remplaçant la partie _sample.loc par le nom de domaine de l'environnement cible, sans modifier son extension .datasource.cfg.php. Par exemple si votre nom de domaine en local est aftutorial.loc, alors le nom de fichier sera aftutorial.loc.datasource.cfg.php ;
  3. éditer ce nouveau fichier, puis personnaliser son contenu avec les informations de connexion à la base de données. Si plusieurs bases de données MySQL/MariaDB sont utilisées, alors renseigner les informations de connexion comme indiquées ci-dessous :
    <?php 
//Data sources list
$_dataSources = [
	//First data source
	'<key1>Ds' => [
		'type' => 'mysqli',
		'serverName' => '<127.0.0.1>',
		'userName' => '<userName>',
		'password' => '<password>',
		'dataSourceName' => '<databaseName>',
		'port' => <3306>
	],
	
	//Second data source
	'<key2>Ds' => [
		'type' => 'mysqli',
		'serverName' => '<127.0.0.1>',
		'userName' => '<userName>',
		'password' => '<password>',
		'dataSourceName' => '<databaseName>',
		'port' => <3306>
	],
	
	//Third data source
	//...
];
?>
    <key1> à <keyn> désignent un nom rattaché à leur base de données respective. Ces noms en camel case doivent obligatoirement être suffixés par Ds (Data Source). Voici un exemple de configuration d'une source de données :
    <?php 
//Data sources list
$_dataSources = [
	//MySqli database for development environment
	'mysqliDevDs' => [
		'type' => 'mysqli',
		'serverName' => '127.0.0.1',
		'userName' => 'myuser',
		'password' => 'MyPassword123',
		'dataSourceName' => 'my_database',
		'port' => 3306
	]
];
?>
  4. sauvegarder le fichier. La source de données peut maintenant être accessible depuis un BO par l'appel $this->mysqliDevDs.

L'accès aux données fera l'objet du tutoriel suivant...