(PHP 5, PHP 7, PHP 8)
mysqli::options -- mysqli_options — Define las opciones
Estilo orientado a objetos
Estilo procedimental
Ú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().
mysqlSolo estilo procedimental: Un objeto mysqli devuelto por mysqli_connect() o mysqli_init()
optionLa opción que se desea definir. Puede tomar uno de los siguientes valores:
| 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. |
valueEl valor para la opción.
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.
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().