# A classe mysqli

(PHP 5, PHP 7, PHP 8)

## Introdução

Representa uma conexão entre o PHP e um banco de dados MySQL.

## Resumo da classe

class mysqli {
/* Propriedades */
public readonly int|string $affected_rows;
public readonly string $client_info;
public readonly int $client_version;
public readonly int $connect_errno;
public readonly ?string $connect_error;
public readonly int $errno;
public readonly string $error;
public readonly array $error_list;
public readonly int $field_count;
public readonly string $host_info;
public readonly ?string $info;
public readonly int|string $insert_id;
public readonly string $server_info;
public readonly int $server_version;
public readonly string $sqlstate;
public readonly int $protocol_version;
public readonly int $thread_id;
public readonly int $warning_count;
/* Métodos */
public function __construct(
?string `$hostname` = `null`,
?string `$username` = `null`,
#[\SensitiveParameter]?string `$password` = `null`,
?string `$database` = `null`,
?int `$port` = `null`,
?string `$socket` = `null`
)
public function autocommit(bool `$enable`): bool
public function begin_transaction(int `$flags` = 0, ?string `$name` = `null`): bool
public function change_user(string `$username`, #[\SensitiveParameter]string `$password`, ?string `$database`): bool
public function character_set_name(): string
public function close(): true
public function commit(int `$flags` = 0, ?string `$name` = `null`): bool
public function connect(
?string `$hostname` = `null`,
?string `$username` = `null`,
#[\SensitiveParameter]?string `$password` = `null`,
?string `$database` = `null`,
?int `$port` = `null`,
?string `$socket` = `null`
): bool
public function debug(string `$options`): true
public function dump_debug_info(): bool
public function execute_query(string `$query`, ?array `$params` = `null`): mysqli_result|bool
public function get_charset(): ?object
#[\Deprecated]
public function get_client_info(): string
public function get_connection_stats(): array
public function get_server_info(): string
public function get_warnings(): mysqli_warning|false
#[\Deprecated]
public function init(): ?bool
#[\Deprecated]
public function kill(int `$process_id`): bool
public function more_results(): bool
public function multi_query(string `$query`): bool
public function next_result(): bool
public function options(int `$option`, string|int `$value`): bool
#[\Deprecated]
public function ping(): bool
public static function poll(
?array `&$read`,
?array `&$error`,
array `&$reject`,
int `$seconds`,
int `$microseconds` = 0
): int|false
public function prepare(string `$query`): mysqli_stmt|false
public function query(string `$query`, int `$result_mode` = MYSQLI_STORE_RESULT): mysqli_result|bool
public function real_connect(
?string `$hostname` = null,
?string `$username` = null,
#[\SensitiveParameter]?string `$password` = null,
?string `$database` = null,
?int `$port` = null,
?string `$socket` = null,
int `$flags` = 0
): bool
public function real_escape_string(string `$string`): string
public function real_query(string `$query`): bool
public function reap_async_query(): mysqli_result|bool
#[\Deprecated]
public function refresh(int `$flags`): bool
public function release_savepoint(string `$name`): bool
public function rollback(int `$flags` = 0, ?string `$name` = null): bool
public function savepoint(string `$name`): bool
public function select_db(string `$database`): bool
public function set_charset(string `$charset`): bool
public function ssl_set(
?string `$key`,
?string `$certificate`,
?string `$ca_certificate`,
?string `$ca_path`,
?string `$cipher_algos`
): true
public function stat(): string|false
public function stmt_init(): mysqli_stmt|false
public function store_result(int `$mode` = 0): mysqli_result|false
public function thread_safe(): bool
public function use_result(): mysqli_result|false
}

## Índice

- mysqli::$affected_rows — Retorna o número de linhas afetadas pela operação MySQL anterior
- mysqli::autocommit — Ativa ou desativa a gravação automática das modificações no banco de dados
- mysqli::begin_transaction — Inicia uma transação
- mysqli::change_user — Altera o usuário da conexão com o banco de dados
- mysqli::character_set_name — Retorna o conjunto de caracteres atual da conexão com o banco de dados
- mysqli::close — Fecha uma conexão ao banco de dados previamente aberta
- mysqli::commit — Grava a transação atual
- mysqli::$connect_errno — Retorna o código de erro da última chamada de conexão
- mysqli::$connect_error — Retorna uma descrição do último erro de conexão
- mysqli::__construct — Abre uma nova conexão com o servidor MySQL
- mysqli::debug — Realiza operações de depuração
- mysqli::dump_debug_info — Descarrega informação de debug no log
- mysqli->errno — Retorna o código de erro para a chamada de função mais recente
- mysqli->error — Retorna uma string descrevendo o último erro
- mysqli::$error_list — Retorna uma lista de erros do último comando executado
- mysqli::execute_query — Prepara, vincula parâmetros e executa a instrução SQL
- mysqli::$field_count — Retorna o número de campos para a consulta mais recente
- mysqli::get_charset — Retorna um objeto de conjunto de caracteres
- mysqli::$client_info — Obtém informação do cliente MySQL
- mysqli::$client_version — Retorna a versão do cliente MySQL como um inteiro
- mysqli::get_connection_stats — Retorna estatísticas sobre a conexão do cliente
- mysqli::$host_info — Retorna uma string representando o tipo de conexão utilizada
- mysqli::$protocol_version — Retorna a versão do protocolo MySQL usada
- mysqli::$server_info — Retorna a versão do servidor MySQL
- mysqli::$server_version — Retorna a versão do servidor MySQL como um inteiro
- mysqli::get_warnings — Obtém o resultado de SHOW WARNINGS
- mysqli::$info — Recupera informação sobre a recente consulta executada
- mysqli::init — Inicializa o MySQLi e retorna um objeto a ser utilizado com mysqli_real_connect()
- mysqli::$insert_id — Retorna o valor gerado para uma coluna AUTO_INCREMENT pela última consulta
- mysqli::kill — Solicita ao servidor o encerramento de um thread do MySQL
- mysqli::more_results — Verifica se há mais algum resultado de uma consulta múltipla
- mysqli::multi_query — Executa uma ou mais consultas no banco de dados
- mysqli::next_result — Prepara o próximo resultado de multi_query
- mysqli::options — Define opções
- mysqli::ping — Faz ping em uma conexão de servidor ou tenta reconectar se a conexão cair
- mysqli::poll — Sondagem de conexões
- mysqli::prepare — Prepara uma instrução SQL para execução
- mysqli::query — Executa uma consulta no banco de dados
- mysqli::real_connect — Abre uma conexão a um servidor MySQL
- mysqli::real_escape_string — Escape caracteres especiais em uma string para uso em uma instrução SQL, levando em consideração o conjunto de caracteres atual da conexão
- mysqli::real_query — Executa uma consulta SQL
- mysqli::reap_async_query — Obtenha o resultado da consulta assíncrona
- mysqli::refresh — Atualiza
- mysqli::release_savepoint — Remove o ponto de salvamento nomeado do conjunto de pontos de salvamento da transação atual
- mysqli::rollback — Reverte a transação atual
- mysqli::savepoint — Define um ponto de salvamento de transação nomeado
- mysqli::select_db — Seleciona o banco de dados padrão para consultas de banco de dados
- mysqli::set_charset — Define o conjunto de caracteres do cliente
- mysqli::$sqlstate — Retorna o erro SQLSTATE da operação MySQL anterior
- mysqli::ssl_set — Usado para estabelecer conexões seguras usando SSL
- mysqli::stat — Obtém o status atual do sistema
- mysqli::stmt_init — Inicializa uma instrução e retorna um objeto para uso com mysqli_stmt_prepare
- mysqli::store_result — Transfere um conjunto de resultados da última consulta
- mysqli::$thread_id — Retorna o ID da thread para a conexão atual
- mysqli::thread_safe — Retorna se a segurança de thread é dada ou não
- mysqli::use_result — Iniciar uma recuperação de conjunto de resultados
- mysqli::$warning_count — Retorna o número de alertas gerados pela consulta mais recente

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