mysqli
PHP Manual

mysqli::options

mysqli_options

(PHP 5, PHP 7)

mysqli::options -- mysqli_optionsDéfinit les options

Description

Style orienté objet

bool mysqli::options ( int $option , mixed $value )

Style procédural

bool mysqli_options ( mysqli $link , int $option , mixed $value )

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().

Liste de paramètres

link

Seulement en style procédural : Un identifiant de lien retourné par la fonction mysqli_connect() ou par la fonction mysqli_init()

option

L'option que vous voulez définir. Il peut prendre une des valeurs suivantes :

Options valides
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

value

La valeur pour l'option.

Valeurs de retour

Cette fonction retourne TRUE en cas de succès ou FALSE si une erreur survient.

Historique

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.

Exemples

Voir mysqli_real_connect().

Notes

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().

Voir aussi


mysqli
PHP Manual