mysqli::options

mysqli_options

(PHP 5, PHP 7, PHP 8)

mysqli::options -- mysqli_optionsDefine las opciones

Descripción

Estilo orientado a objetos

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

Estilo por procedimientos

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

Útil para definir opciones de conexión y así afectar el comportamiento de la conexión actual.

Esta función puede ser llamada múltiples veces para definir múltiples opciones.

mysqli_options() debe ser llamada después de mysqli_init() y antes de mysqli_real_connect().

Parámetros

link

Sólo estilo por procediminetos: Un identificador de enlace devuelto por mysqli_connect() o mysqli_init()

option

La opción que se desea definir. Puede tomar uno de los siguientes valores:

Opciones válidas
Nombre Descripción
MYSQLI_OPT_CONNECT_TIMEOUT Tiempo máximo de conexión en segundos
MYSQLI_OPT_READ_TIMEOUT Tiempo de espera de ejecución de un comando en segundos. Disponible a partir de PHP 7.2.0.
MYSQLI_OPT_LOCAL_INFILE Activa/desactiva el uso de LOAD LOCAL INFILE
MYSQLI_INIT_COMMAND Comando a ejecutar después de la conexión al servidor MySQL
MYSQLI_SET_CHARSET_NAME El juego de caracteres a definir por defecto.
MYSQLI_READ_DEFAULT_FILE Lee las opciones desde el nombre de la opción en lugar del archivo my.cnf No soportado por mysqlnd
MYSQLI_READ_DEFAULT_GROUP Lee las opciones del grupo desde my.cnf o desde el archivo especificado con MYSQL_READ_DEFAULT_FILE. No soportado por mysqlnd
MYSQLI_SERVER_PUBLIC_KEY Archivo que contiene la clave pública RSA utilizada con la autenticación basada en SHA-256.
MYSQLI_OPT_NET_CMD_BUFFER_SIZE El tamaño del buffer interno de comando/red. Únicamente válido para mysqlnd.
MYSQLI_OPT_NET_READ_BUFFER_SIZE Tamaño, en bytes, máximo de la parte a leer durante la lectura del cuerpo de un paquete de comando MySQL. Únicamente válido para mysqlnd.
MYSQLI_OPT_INT_AND_FLOAT_NATIVE Convierte las columnas enteras y de coma flotante en números PHP al utilizar declaraciones no preparadas. Válido únicamente para mysqlnd.
MYSQLI_OPT_SSL_VERIFY_SERVER_CERT Si el certificado del servidor debe ser verificado o no.

value

El valor para la opción.

Valores devueltos

Devuelve true en caso de éxito o false en caso de error.

Errores/Excepciones

If mysqli error reporting is enabled (MYSQLI_REPORT_ERROR) and the requested operation fails, a warning is generated. If, in addition, the mode is set to MYSQLI_REPORT_STRICT, a mysqli_sql_exception is thrown instead.

Ejemplos

Ver mysqli_real_connect().

Notas

Nota:

MySQLnd siempre utiliza el juego de caracteres de idioma predeterminado. El juego de caracteres se envía en la autentificación/acuerdo que se produce durante la conexión, que utilizará mysqlnd.

Libmysqlclient utiliza el juego de caracteres predeterminado definido en my.cnf o se puede establecer llamando mysqli_options() antes de user mysqli_real_connect(), pero después de mysqli_init().

Ver también