array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'pt_BR', ), 'this' => array ( 0 => 'mysqli.options.php', 1 => 'mysqli::options', ), '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', ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); ?>
(PHP 5, PHP 7, PHP 8)
mysqli::options -- mysqli_options — Define opções
Estilo orientado a objetos
Estilo procedural
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().
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:
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_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 |
Se deve-se verificar ou não o certificado do servidor. |
value
O valor da opção.
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.
Veja mysqli_real_connect().
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().