Configuration à l'exécution

Le comportement de ces fonctions est affecté par la configuration dans le fichier php.ini.

Options de configuration MySQLi

Nom	Défaut	Modifiable	Historique
mysqli.allow_local_infile	"0"	INI_SYSTEM	Antérieur à PHP 7.2.16 et 7.3.3 la valeur par défaut était "1".
mysqli.local_infile_directory		INI_SYSTEM	Disponible à partir de PHP 8.1.0.
mysqli.allow_persistent	"1"	INI_SYSTEM
mysqli.max_persistent	"-1"	INI_SYSTEM
mysqli.max_links	"-1"	INI_SYSTEM
mysqli.default_port	"3306"	INI_ALL
mysqli.default_socket	NULL	INI_ALL
mysqli.default_host	NULL	INI_ALL
mysqli.default_user	NULL	INI_ALL
mysqli.default_pw	NULL	INI_ALL
mysqli.reconnect	"0"	INI_SYSTEM	Supprimée à partir de PHP 8.2.0
mysqli.rollback_on_cached_plink	"0"	INI_SYSTEM

Pour plus de détails sur les modes INI_*, reportez-vous à Où une directive de configuration peut être modifiée.

Pour plus de détails et de définitions concernant les constantes INI_* ci-dessus, reportez-vous au chapitre sur les modifications de configuration.

Voici un éclaircissement sur l'utilisation des directives de configuration.

mysqli.allow_local_infile int

Autorise l'accès, depuis PHP, aux fichiers locaux chargés avec LOAD DATA

mysqli.local_infile_directory string

Autorise un chargement restreint LOCAL DATA vers des fichiers se trouvant dans le dossier désigné.

mysqli.allow_persistent int

Active la possibilité de créer des connexions persistantes en utilisant la fonction mysqli_connect().

mysqli.max_persistent int

Nombre maximal de connexions persistantes pouvant être réalisé. Définir à 0 pour "illimité".

mysqli.max_links int

Le nombre maximal de connexions MySQL par processus, incluant les connexions persistantes.

mysqli.default_port int

Le numéro par défaut de port TCP à utiliser lors de la connexion au serveur si aucun autre port n'est fourni. S'il n'est pas défini, le port sera obtenu à partir de la variable d'environnement MYSQL_TCP_PORT, l'entrée mysql-tcp dans /etc/services ou la constante de compilation MYSQL_PORT, dans cet ordre. Win32 n'utilisera que la constante MYSQL_PORT.

mysqli.default_socket string

Le nom par défaut du socket à utiliser lors des connexions locales au serveur si aucun autre nom n'est fourni.

mysqli.default_host string

Le serveur par défaut à utiliser lors de la connexion à un serveur si aucun autre hôte n'est fourni.

mysqli.default_user string

Le nom d'utilisateur par défaut à utiliser lors de la connexion à un serveur si aucun autre nom n'est fourni.

mysqli.default_pw string

Le mot de passe par défaut à utiliser lors de la connexion à un serveur si aucun autre mot de passe n'est fourni.

mysqli.reconnect int

Reconnexion automatique si la connexion est interrompue.

Note: Cette directive php.ini avait été ignorée par le pilote mysqlnd et a été supprimée à partir de PHP 8.2.0.

mysqli.rollback_on_cached_plink bool

Si cette option est activée, la fermeture d'une connexion permanente annule toutes les transactions en attente de cette connexion avant d'être replacée dans le pool de connexions persistantes. Sinon, les transactions en attente seront restaurées uniquement lorsque la connexion est réutilisée ou lorsqu'elle est réellement fermée.

Les utilisateurs ne peuvent changer MYSQL_OPT_READ_TIMEOUT via un appel de l'API ou au runtime. Notez que même si c'est possible, il y aura des différences sur la manière dont libmysqlclient et les flux vont interpréter la valeur de MYSQL_OPT_READ_TIMEOUT.