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 procedimental

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

mysql

Solo estilo procedimental: Un objeto mysqli 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

Esta función retorna true en caso de éxito o false si ocurre un error.

Errores/Excepciones

Si el informe de errores de mysqli está habilitado (MYSQLI_REPORT_ERROR) y la operación solicitada falla, se genera una advertencia. Si, además, el modo está configurado como MYSQLI_REPORT_STRICT, se lanza una mysqli_sql_exception en su lugar.

Ejemplos

Ver mysqli_real_connect().

Notas

Nota:

MySQLnd siempre asume el juego de caracteres predeterminado del servidor. Este juego de caracteres es enviado durante el intercambio de conexión/autenticación, el cual mysqlnd utilizará.

Libmysqlclient utiliza el juego de caracteres predeterminado establecido en el my.cnf o mediante una llamada explícita a mysqli_options() antes de llamar a mysqli_real_connect(), pero después de mysqli_init().

Ver también