# mysqli::options

# mysqli_options

(PHP 5, PHP 7, PHP 8)

mysqli::options -- mysqli_options — Définit les options

### Description

Style orienté objet

public mysqli::options(int `$option`, string|int `$value`): bool

Style procédural

mysqli_options(mysqli `$mysql`, int `$option`, string|int `$value`): bool

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

`mysql`

  Seulement en style procédural : Un objet mysqli retourné par la fonction mysqli_connect() ou 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
  `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 nombres PHP lors de l'utilisation de déclarations non préparées. Valable uniquement pour mysqlnd.
  `MYSQLI_OPT_SSL_VERIFY_SERVER_CERT` | Si le certificat de serveur doit être vérifier ou non.

`value`

  La valeur pour l'option.

### Valeurs de retour

Cette fonction retourne `true` en cas de succès ou `false` si une erreur survient.

### Erreurs / Exceptions

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.

### 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_init() - Initialise MySQLi et retourne un objet à utiliser avec mysqli_real_connect()
- mysqli_real_connect() - Ouvre une connexion à un serveur MySQL