(PHP 5, PHP 7, PHP 8)
mysqli::options -- mysqli_options — Définit les options
Style orienté objet
$option, string|int $value): boolStyle 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().
mysqlSeulement en style procédural : Un objet mysqli 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 |
MYSQLI_OPT_READ_TIMEOUT |
Résultat d'execution durée d'expiration d'une commande en secondes. Disponible à partir de PHP 7.2.0. |
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_SET_CHARSET_NAME |
Le jeu de caractère à définir par défaut. |
MYSQLI_READ_DEFAULT_FILE |
Lit les options depuis le nom de l'option plutôt que du fichier my.cnf Pas supporté par mysqlnd |
MYSQLI_READ_DEFAULT_GROUP |
Lit les options du groupe depuis my.cnf
ou depuis le fichier spécifié avec MYSQL_READ_DEFAULT_FILE.
Pas supporté par mysqlnd
|
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 |
Si le certificat de serveur doit être vérifier ou non. |
valueLa valeur pour l'option.
Cette fonction retourne true en cas de succès ou false si une erreur survient.
Si le rapport d'erreurs mysqli est activé (MYSQLI_REPORT_ERROR) et que l'opération demandée échoue,
un avertissement est généré. Si, en plus, le mode est défini sur MYSQLI_REPORT_STRICT,
une mysqli_sql_exception est lancée à la place.
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().