(PHP 5, PHP 7)
mysqli::options -- mysqli_options — Définit les options
Style orienté objet
Style procédural
Utile pour définir des options de connexion et ainsi affecter le comportement de la connexion courante.
Cette fonction peut être appelée plusieurs fois pour définir plusieurs options.
mysqli_options() doit être appelée après mysqli_init() et avant mysqli_real_connect().
linkSeulement en style procédural : Un identifiant de lien retourné par la fonction mysqli_connect() ou par la fonction mysqli_init()
optionL'option que vous voulez définir. Il peut prendre une des valeurs suivantes :
| Nom | Description |
|---|---|
MYSQLI_OPT_CONNECT_TIMEOUT |
délai maximal de la connexion en secondes (supporté sous Windows avec TCP/IP depuis PHP 5.3.1) |
MYSQLI_OPT_LOCAL_INFILE |
active/désactive l'utilisation de LOAD LOCAL INFILE |
MYSQLI_INIT_COMMAND |
commande à exécuter après la connexion au serveur MySQL |
MYSQLI_READ_DEFAULT_FILE |
Lit les options depuis le nom de l'option plutôt que du fichier my.cnf |
MYSQLI_READ_DEFAULT_GROUP |
Lit les options du groupe depuis my.cnf
ou depuis le fichier spécifié avec MYSQL_READ_DEFAULT_FILE.
|
MYSQLI_SERVER_PUBLIC_KEY |
Fichier contenant la clé publique RSA utilisée avec l'authentification basée sur SHA-256. |
MYSQLI_OPT_NET_CMD_BUFFER_SIZE |
La taille du buffer interne de commande/réseau. Uniquement valide pour mysqlnd. |
MYSQLI_OPT_NET_READ_BUFFER_SIZE |
Taille, en octets, maximal de la partie à lire lors de la lecture du corps d'un paquet de commande MySQL. Uniquement valide pour mysqlnd. |
MYSQLI_OPT_INT_AND_FLOAT_NATIVE |
Convertie les colonnes entières et à virgules flottantes en nombre PHP. Uniquement valide pour mysqlnd. |
MYSQLI_OPT_SSL_VERIFY_SERVER_CERT |
valueLa valeur pour l'option.
Cette fonction retourne TRUE en cas de succès ou FALSE si une erreur survient.
| Version | Description |
|---|---|
| 5.5.0 |
Les options MYSQLI_SERVER_PUBLIC_KEY et
MYSQLI_SERVER_PUBLIC_KEY ont été ajoutées.
|
| 5.3.0 |
Les options MYSQLI_OPT_INT_AND_FLOAT_NATIVE,
MYSQLI_OPT_NET_CMD_BUFFER_SIZE,
MYSQLI_OPT_NET_READ_BUFFER_SIZE, et
MYSQLI_OPT_SSL_VERIFY_SERVER_CERT ont été ajoutées.
|
Voir mysqli_real_connect().
Note:
MySQLnd s'occupe toujours du jeu de caractères par défaut du serveur. Celui-ci est envoyé durant la négociation de la connexion ou l'authentification.
Libmysqlclient utilise le jeu de caractères par défaut de my.cnf ou via par un appel à mysqli_options() avant mysqli_real_connect(), mais après mysqli_init().