Define las opciones

# mysqli::options

# mysqli_options

(PHP 5, PHP 7, PHP 8)

mysqli::options -- mysqli_options — Define las opciones

### Descripción

Estilo orientado a objetos

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

Estilo procedimental

function 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_OPT_LOAD_DATA_LOCAL_DIR` | Directorio a utilizar para `LOAD DATA 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 se debe verificar o no el certificado del servidor.
  `MYSQLI_OPT_CAN_HANDLE_EXPIRED_PASSWORDS` | Si el cliente debe aceptar contraseñas expiradas.
  `1` | Si se debe utilizar la compresión de comunicación de red.

`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

- mysqli_init() - Inicializa MySQLi y devuelve un objeto para usar con mysqli_real_connect()
- mysqli_real_connect() - Establece una conexión con un servidor MySQL

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open