Définit les options

# mysqli::options

# mysqli_options

(PHP 5, PHP 7)

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

### Description

Style orienté objet

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

Style procédural

mysqli_options ( mysqli `$link` , int `$option` , mixed `$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

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