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 __construct(
    ?string $hostname = null,
    ?string $username = null,
    #[\SensitiveParameter] ?string $password = null,
    ?string $database = null,
    ?int $port = null,
    ?string $socket = null
)

public autocommit(bool $enable): bool

public begin_transaction(int $flags = 0, ?string $name = null): bool

public change_user(string $username, #[\SensitiveParameter] string $password, ?string $database): bool

public character_set_name(): string

public close(): true

public commit(int $flags = 0, ?string $name = null): bool

public connect(
    ?string $hostname = null,
    ?string $username = null,
    #[\SensitiveParameter] ?string $password = null,
    ?string $database = null,
    ?int $port = null,
    ?string $socket = null
): bool

public debug(string $options): true

public dump_debug_info(): bool

public execute_query(string $query, ?array $params = null): mysqli_result|bool

public get_charset(): ?object

#[\Deprecated]
public get_client_info(): string

public get_connection_stats(): array

public get_server_info(): string

public get_warnings(): mysqli_warning|false

#[\Deprecated]
public init(): ?bool

#[\Deprecated]
public kill(int $process_id): bool

public more_results(): bool

public multi_query(string $query): bool

public next_result(): bool

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

#[\Deprecated]
public ping(): bool

public static poll(
    ?array &$read,
    ?array &$error,
    array &$reject,
    int $seconds,
    int $microseconds = 0
): int|false

public prepare(string $query): mysqli_stmt|false

public query(string $query, int $result_mode = MYSQLI_STORE_RESULT): mysqli_result|bool

public 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 real_escape_string(string $string): string

public real_query(string $query): bool

public reap_async_query(): mysqli_result|bool

#[\Deprecated]
public refresh(int $flags): bool

public release_savepoint(string $name): bool

public rollback(int $flags = 0, ?string $name = null): bool

public savepoint(string $name): bool

public select_db(string $database): bool

public set_charset(string $charset): bool

public ssl_set(
    ?string $key,
    ?string $certificate,
    ?string $ca_certificate,
    ?string $ca_path,
    ?string $cipher_algos
): true

public stat(): string|false

public stmt_init(): mysqli_stmt|false

public store_result(int $mode = 0): mysqli_result|false

public thread_safe(): bool

public 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