array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'fr', ), 'this' => array ( 0 => 'mysqli.configuration.php', 1 => 'Configuration à l\'exécution', 2 => 'Configuration à l\'exécution', ), 'up' => array ( 0 => 'mysqli.setup.php', 1 => 'Installation/Configuration', ), 'prev' => array ( 0 => 'mysqli.installation.php', 1 => 'Installation', ), 'next' => array ( 0 => 'mysqli.persistconns.php', 1 => 'L\'extension mysqli et les connexions persistantes', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'fr', 'path' => 'reference/mysqli/ini.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

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, se reporter au chapitre sur les modifications de configuration.

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

mysqli.allow_local_infile bool

Autorise l'accès, à partir de 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é".

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.

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. À noter 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.