array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'pt_BR', ), 'this' => array ( 0 => 'mysqli.options.php', 1 => 'mysqli::options', 2 => 'Define opções', ), 'up' => array ( 0 => 'class.mysqli.php', 1 => 'mysqli', ), 'prev' => array ( 0 => 'mysqli.next-result.php', 1 => 'mysqli::next_result', ), 'next' => array ( 0 => 'mysqli.ping.php', 1 => 'mysqli::ping', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'pt_BR', 'path' => 'reference/mysqli/mysqli/options.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

mysqli::options

mysqli_options

(PHP 5, PHP 7, PHP 8)

mysqli::options -- mysqli_options — Define opções

Descrição

Estilo orientado a objetos

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

Estilo procedural

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

Usado para definir opções extras de conexão e afetar o comportamento de uma conexão.

Esta função pode ser chamada várias vezes para definir várias opções.

mysqli_options() deve ser chamado depois de mysqli_init() e antes de mysqli_real_connect().

Parâmetros

mysql

Somente no estilo procedural: Um objeto mysqli retornado por mysqli_connect() ou mysqli_init()

option

A opção que você deseja definir. Pode ser um dos seguintes valores:
Valid options
Name Description
MYSQLI_OPT_CONNECT_TIMEOUT Tempo limite de conexão em segundos
MYSQLI_OPT_READ_TIMEOUT Tempo limite do resultado da execução do comando em segundos. Disponível a partir do PHP 7.2.0.
MYSQLI_OPT_LOCAL_INFILE Ativar/desativar o uso de LOAD LOCAL INFILE
MYSQLI_OPT_LOAD_DATA_LOCAL_DIR Diretório a ser usado para LOAD DATA LOCAL INFILE.
MYSQLI_INIT_COMMAND Comando para executar depois ao conectar ao servidor MySQL
MYSQLI_SET_CHARSET_NAME O conjunto de caracteres a ser definido como padrão..
MYSQLI_READ_DEFAULT_FILE Lê as opções do arquivo de opções nomeadas em vez de my.cnf Não suportado por mysqlnd.
MYSQLI_READ_DEFAULT_GROUP Leia as opções do grupo nomeado de my.cnf ou o arquivo especificado com MYSQL_READ_DEFAULT_FILE. Não suportado pelo mysqlnd.
MYSQLI_SERVER_PUBLIC_KEY Arquivo de chave pública RSA usado com a autenticação baseada em SHA-256.
MYSQLI_OPT_NET_CMD_BUFFER_SIZE O tamanho do buffer interno de comando/rede. Válido apenas para mysqlnd.
MYSQLI_OPT_NET_READ_BUFFER_SIZE Tamanho máximo do bloco de leitura em bytes ao ler o corpo de um pacote de comando do MySQL. Válido apenas para mysqlnd.
MYSQLI_OPT_INT_AND_FLOAT_NATIVE Converte colunas de números inteiros e pontos flutuantes de volta para números PHP ao usar instruções não preparadas. Válido apenas para mysqlnd.
MYSQLI_OPT_SSL_VERIFY_SERVER_CERT Informa se o certificado do servidor deve ser verificado.
MYSQLI_OPT_CAN_HANDLE_EXPIRED_PASSWORDS Informa se o cliente deve aceitar senhas expiradas.
1 Informa se deve ser usada compressão na comunicação de rede.

value

O valor da opção.

Valor Retornado

Retorna true em caso de sucesso ou false em caso de falha.

Erros/Exceções

Se o relatório de erros da extensão mysqli estiver habilitado (MYSQLI_REPORT_ERROR) e a operação solicitada falhar, um aviso será gerado. Se, além disso, o modo for definido como MYSQLI_REPORT_STRICT, uma exceção mysqli_sql_exception será lançada em vez do aviso.

Exemplos

Veja mysqli_real_connect().

Notas

Nota:

O MySQLnd sempre assume o conjunto de caracteres padrão do servidor. Este conjunto de caracteres é enviado durante a criação/autenticação da conexão e será usado pelo mysqlnd.

A libmysqlclient usa o conjunto de caracteres padrão definido no arquivo my.cnf ou definido por uma chamada explícita a mysqli_options() antes de chamar mysqli_real_connect(), mas depois de chamar mysqli_init().

Veja Também