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 | Antérieur à PHP 7.2.16 et 7.3.3 la valeur par défaut était "1". |
| mysqli.local_infile_directory | PHP_INI_SYSTEM | Disponible à partir de PHP 8.1.0. | |
| mysqli.allow_persistent | "1" | PHP_INI_SYSTEM | |
| mysqli.max_persistent | "-1" | PHP_INI_SYSTEM | |
| 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 | Supprimée à partir de PHP 8.2.0 |
| mysqli.rollback_on_cached_plink | "0" | PHP_INI_SYSTEM |
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
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.