Configuration de la base de données

Aperçu des options de configuration de la base de données Nette.

Si vous n'utilisez pas l'ensemble du framework, mais seulement cette bibliothèque, lisez comment charger la configuration.

Connexion unique

Configurez une connexion unique à la base de données :

database:
	# DSN, uniquement la clé obligatoire
	dsn: "sqlite:%appDir%/Model/demo.db"
	user: ...
	password: ...

Crée les services Nette\Database\Connection et Nette\Database\Explorer, qui sont généralement transmis par autowiring ou par référence à leur nom.

Autres paramètres :

database:
	# affiche le panneau de la base de données dans Tracy Bar ?
	debugger: ...     # (bool) vaut true par défaut

	# affiche la requête EXPLAIN dans Tracy Bar ?
	explain: ...      # (bool) vaut true par défaut

	# activer le câblage automatique pour cette connexion ?
	autowired: ...    # (bool) vaut true par défaut pour la première connexion

	# conventions de la table: découverte, statique, ou nom de classe
	conventions: discovered # (string) Valeur par défaut: 'discovered'.

	options:
		# pour ne se connecter à la base de données qu'en cas de besoin ?
		lazy: ...     # (bool) a pour valeur par défaut false

		# Classe du pilote de base de données PHP
		driverClass:  # (string)

		# seulement MySQL: définit sql_mode
		sqlmode:      # (string)

		# uniquement MySQL: sets SET NAMES
		charset:      # (string) par défaut 'utf8mb4'

		# uniquement MySQL : convertit TINYINT(1) en bool
		convertBoolean : # (bool) valeur par défaut : false

		# renvoie les colonnes de date sous forme d'objets immuables (depuis la version 3.2.1)
		newDateTime :  # (bool) valeur par défaut : false

		# uniquement Oracle et SQLite: format de date
		formatDateTime: # (string) vaut par défaut 'U'.

La clé options peut contenir d'autres options qui peuvent être trouvées dans la documentation du pilote PDO, telles que :

database:
	options:
		PDO::MYSQL_ATTR_COMPRESS: true

Connexions multiples

Dans la configuration, nous pouvons définir plusieurs connexions de base de données en les divisant en sections nommées :

database:
	main:
		dsn: 'mysql:host=127.0.0.1;dbname=test'
		user: root
		password: password

	another:
		dsn: 'sqlite::memory:'

L'autocâblage n'est activé que pour les services de la première section. Ceci peut être modifié en utilisant autowired: false ou autowired: true.

Services DI

Ces services sont ajoutés au conteneur DI, où ### représente le nom de la connexion :

Nom	Type	Description
`database.###.connection`	Nette\Database\Connection	connexion à la base de données
`database.###.explorer`	Nette\Database\Explorer	Database Explorer

Si nous définissons une seule connexion, les noms des services seront database.default.connection et database.default.explorer. Si nous définissons plusieurs connexions comme dans l'exemple ci-dessus, les noms correspondront aux sections, c'est-à-dire database.main.connection, database.main.explorer et ensuite database.another.connection et database.another.explorer.

Nous passons les services non authentifiés explicitement en faisant référence à leur nom :

services:
	- UserFacade(@database.another.connection)