# mysqli::options

# mysqli_options

(PHP 5, PHP 7, PHP 8)

mysqli::options -- mysqli_options — Establecer opciones

### Descripción

Estilo orientado a objetos

mysqli::options(int `$option`, mixed `$value`): bool

Estilo por procedimientos

mysqli_options(mysqli `$link`, int `$option`, mixed `$value`): bool

Se usa para establecer opciones extra y para modificar al comportamiento de una conexión.

Se puede llamar varias veces a esta función para establecer varias opciones.

mysqli_options() debería invocarse 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()

`opción`

  Opción que se desea establecer. Puede ser una de las siguientes.

  Opciones válidas
  Nombre | Descripción
  --- | ---
  `MYSQLI_OPT_CONNECT_TIMEOUT` | tiempo de expiración en segundos de la conexión (soportado en Windows con TCP/IP desde PHP 5.3.1)
  `MYSQLI_OPT_LOCAL_INFILE` | habilitar/deshabilitar el uso de `LOAD LOCAL INFILE`
  `MYSQLI_INIT_COMMAND` | comando a ejecutar tras conectar al servidor MySQL
  `MYSQLI_READ_DEFAULT_FILE` | Leer las opciones del fichero nombrado de opciones en lugar de my.cnf
  `MYSQLI_READ_DEFAULT_GROUP` | Leer opciones del grupo nombrado de my.cnf o del fichero especificado con `MYSQL_READ_DEFAULT_FILE`.
  `MYSQLI_SERVER_PUBLIC_KEY` | Fichero de clave pública RSA usado con la autenticación basada en SHA-256.
  `MYSQLI_OPT_NET_CMD_BUFFER_SIZE` | El tamaño del búfer interno de órdenes/red. Solo válido para mysqlnd.
  `MYSQLI_OPT_NET_READ_BUFFER_SIZE` | Tamaño de trozo de lectura máximo en bytes al leer el cuerpo de un paquete de órdenes de MySQL. Solo válido para mysqlnd.
  `MYSQLI_OPT_INT_AND_FLOAT_NATIVE` | Convertir columnas integer y float a números de PHP. Únicamente válido para mysqlnd.
  `MYSQLI_OPT_SSL_VERIFY_SERVER_CERT` |

`value`

  Valor de la opción.

### Valores devueltos

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

### Historial de cambios

Versión | Descripción
--- | ---
5.5.0 | Se añadieron las opciones `MYSQLI_SERVER_PUBLIC_KEY` y `MYSQLI_SERVER_PUBLIC_KEY`.
5.3.0 | Se añadierons las opciones `MYSQLI_OPT_INT_AND_FLOAT_NATIVE`, `MYSQLI_OPT_NET_CMD_BUFFER_SIZE`, `MYSQLI_OPT_NET_READ_BUFFER_SIZE`, y `MYSQLI_OPT_SSL_VERIFY_SERVER_CERT`.

### Ejemplos

Vea 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

- mysqli_init() - Inicializa y devuelve un recurso para utilizarlo con mysqli_real_connect()
- mysqli_real_connect() - Abre una conexión a un servidor mysql