Le comportement de ces fonctions est affecté par la configuration dans le fichier php.ini.
| Nom | Défaut | Modifiable | Historique |
|---|---|---|---|
| mysqli.allow_local_infile | "0" | PHP_INI_SYSTEM | Disponible à partir de PHP 5.2.4. Antérieur à PHP 7.2.16 et 7.3.3 la valeur par défaut était "1". |
| mysqli.allow_persistent | "1" | PHP_INI_SYSTEM | Disponible à partir de PHP 5.3.0. |
| mysqli.max_persistent | "-1" | PHP_INI_SYSTEM | Disponible à partir de PHP 5.3.0. |
| mysqli.max_links | "-1" | PHP_INI_SYSTEM | |
| mysqli.default_port | "3306" | PHP_INI_ALL | |
| mysqli.default_socket | NULL | PHP_INI_ALL | |
| mysqli.default_host | NULL | PHP_INI_ALL | |
| mysqli.default_user | NULL | PHP_INI_ALL | |
| mysqli.default_pw | NULL | PHP_INI_ALL | |
| mysqli.reconnect | "0" | PHP_INI_SYSTEM | |
| mysqli.rollback_on_cached_plink | TRUE | PHP_INI_SYSTEM | Disponible à partir de PHP 5.6.0. |
Pour plus de détails et de définitions concernant les constantes PHP_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
entier
Autorise l'accès, depuis PHP, aux fichiers locaux chargés avec LOAD DATA
mysqli.allow_persistent
entier
Active la possibilité de créer des connexions persistantes en utilisant la fonction mysqli_connect().
mysqli.max_persistent
entier
Nombre maximal de connexions persistantes pouvant être réalisé. Définir à 0 pour "illimité".
mysqli.max_links
entier
Le nombre maximal de connexions MySQL par processus, incluant les connexions persistantes.
mysqli.default_port
entier
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
chaîne de caractères
Le nom par défaut du socket à utiliser lors des connexions locales au serveur si aucun autre nom n'est fourni.
mysqli.default_host
chaîne de caractères
Le serveur par défaut à utiliser lors de la connexion à un serveur si aucun autre hôte n'est fourni. Ne s'applique pas avec le safe mode.
mysqli.default_user
chaîne de caractères
Le nom d'utilisateur par défaut à utiliser lors de la connexion à un serveur si aucun autre nom n'est fourni. Ne s'applique pas avec le safe mode.
mysqli.default_pw
chaîne de caractères
Le mot de passe par défaut à utiliser lors de la connexion à un serveur si aucun autre mot de passe n'est fourni. Ne s'applique pas avec le safe mode.
mysqli.reconnect
entier
Reconnexion automatique si la connexion est interrompue.
Note: Cette directive php.ini est ignoré par le pilote mysqlnd.
mysqli.rollback_on_cached_plink
booléen
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.