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" | 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 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
intAutorise l'accès, depuis PHP, aux fichiers locaux chargés avec LOAD DATA
mysqli.local_infile_directory
stringAutorise un chargement restreint LOCAL DATA vers des fichiers se trouvant dans le dossier désigné.
mysqli.allow_persistent
intActive la possibilité de créer des connexions persistantes en utilisant la fonction mysqli_connect().
mysqli.max_persistent
intNombre maximal de connexions persistantes pouvant être réalisé. Définir à 0 pour "illimité".
mysqli.max_links
intLe 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
stringLe nom par défaut du socket à utiliser lors des connexions locales au serveur si aucun autre nom n'est fourni.
mysqli.default_host
stringLe serveur par défaut à utiliser lors de la connexion à un serveur si aucun autre hôte n'est fourni.
mysqli.default_user
stringLe nom d'utilisateur par défaut à utiliser lors de la connexion à un serveur si aucun autre nom n'est fourni.
mysqli.default_pw
stringLe mot de passe par défaut à utiliser lors de la connexion à un serveur si aucun autre mot de passe n'est fourni.
mysqli.reconnect
intReconnexion 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
boolSi 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
.