mysqli::options

Table des matières

mysqli_options

(PHP 5, PHP 7)

mysqli::options -- mysqli_options — Dé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_init() - Initialise MySQLi et retourne une ressource à utiliser avec mysqli_real_connect()
mysqli_real_connect() - Ouvre une connexion à un serveur MySQL

Rechercher une fonction PHP

Document créé le 30/01/2003, dernière modification le 26/10/2018
Source du document imprimé : https://www.gaudry.be/php-rf-mysqli.options.html

L'infobrol est un site personnel dont le contenu n'engage que moi. Le texte est mis à disposition sous licence CreativeCommons(BY-NC-SA). Plus d'info sur les conditions d'utilisation et sur l'auteur.

Références

Manuel PHP : http://php.net

Ces références et liens indiquent des documents consultés lors de la rédaction de cette page, ou qui peuvent apporter un complément d'information, mais les auteurs de ces sources ne peuvent être tenus responsables du contenu de cette page.
L'auteur de ce site est seul responsable de la manière dont sont présentés ici les différents concepts, et des libertés qui sont prises avec les ouvrages de référence. N'oubliez pas que vous devez croiser les informations de sources multiples afin de diminuer les risques d'erreurs.

Table des matières Haut