mysqli::options

    mysqli_options

    (PHP 5, PHP 7, PHP 8)

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

    Description

    Style orienté objet

    publicmysqli::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
    NomDescription
    MYSQLI_OPT_CONNECT_TIMEOUTDélai maximal de la connexion en secondes
    MYSQLI_OPT_READ_TIMEOUTRésultat d'execution durée d'expiration d'une commande en secondes. Disponible à partir de PHP 7.2.0.
    MYSQLI_OPT_LOCAL_INFILEActive/désactive l'utilisation de LOAD LOCAL INFILE
    MYSQLI_INIT_COMMANDCommande à exécuter après la connexion au serveur MySQL
    MYSQLI_SET_CHARSET_NAMELe 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

    To Top