La clase mysqli

(PHP 5, PHP 7, PHP 8)

Introducción

Representa una conexión entre PHP y una base de datos MySQL.

Sinopsis de la Clase

class mysqli {

/* Propiedades */

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

}

Tabla de contenidos

mysqli::$affected_rows — Devuelve el número de filas afectadas por la última operación MySQL
mysqli::autocommit — Activa o desactiva el modo auto-commit
mysqli::begin_transaction — Inicia una transacción
mysqli::change_user — Cambia el usuario de la conexión
mysqli::character_set_name — Devuelve el juego de caracteres actual para la conexión
mysqli::close — Cierra una conexión
mysqli::commit — Valida la transacción actual
mysqli::$connect_errno — Devuelve el código de error de la última llamada de conexión
mysqli::$connect_error — Devuelve una descripción del último error de conexión
mysqli::__construct — Abre una conexión a un servidor MySQL
mysqli::debug — Realiza acciones de depuración
mysqli::dump_debug_info — Escribe la información de depuración en los registros
mysqli::$errno — Devuelve el último código de error producido
mysqli::$error — Devuelve un string que describe el último error
mysqli::$error_list — Devuelve una lista de errores desde el último comando ejecutado
mysqli::execute_query — Prepara, vincula los parámetros y ejecuta una sentencia SQL
mysqli::$field_count — Devuelve el número de columnas para la última consulta
mysqli::get_charset — Devuelve un objeto que representa el juego de caracteres
mysqli::$client_info — Obtiene información sobre el cliente MySQL
mysqli::$client_version — Devuelve la versión del cliente MySQL como un entero
mysqli::get_connection_stats — Devuelve estadísticas sobre la conexión
mysqli::$host_info — Devuelve un string que contiene el tipo de conexión utilizada
mysqli::$protocol_version — Devuelve la versión del protocolo MySQL utilizado
mysqli::$server_info — Devuelve la versión del servidor MySQL
mysqli::$server_version — Devuelve un integer que representa la versión del servidor MySQL
mysqli::get_warnings — Lee el resultado de SHOW WARNINGS
mysqli::$info — Devuelve información acerca de la última consulta ejecutada
mysqli::init — Inicializa MySQLi y devuelve un objeto para usar con mysqli_real_connect()
mysqli::$insert_id — Devuelve el valor generado para una columna AUTO_INCREMENT por la última consulta
mysqli::kill — Solicita al servidor que finalice un hilo MySQL
mysqli::more_results — Comprueba si hay más conjuntos de resultados MySQL disponibles
mysqli::multi_query — Ejecuta una o varias consultas en la base de datos
mysqli::next_result — Prepara el siguiente resultado de una consulta múltiple
mysqli::options — Define las opciones
mysqli::ping — Verifica la conexión al servidor y reconecta si ya no existe
mysqli::poll — Verifica el estado de la conexión
mysqli::prepare — Prepara una consulta SQL para su ejecución
mysqli::query — Ejecuta una consulta en la base de datos
mysqli::real_connect — Establece una conexión con un servidor MySQL
mysqli::real_escape_string — Protege los caracteres especiales de un string para su uso en una consulta SQL, teniendo en cuenta el juego de caracteres actual de la conexión
mysqli::real_query — Ejecuta una consulta SQL
mysqli::reap_async_query — Lee un resultado para una consulta asíncrona
mysqli::refresh — Actualiza
mysqli::release_savepoint — Elimina el punto de guardado nombrado del conjunto de puntos de guardado de la transacción actual
mysqli::rollback — Revierte la transacción actual
mysqli::savepoint — Establece un punto de guardado nombrado de la transacción
mysqli::select_db — Selecciona una base de datos por defecto para las consultas
mysqli::set_charset — Define el juego de caracteres del cliente
mysqli::$sqlstate — Devuelve el error SQLSTATE de la última operación MySQL
mysqli::ssl_set — Utilizada para establecer una conexión segura con SSL
mysqli::stat — Obtiene el estado actual del sistema
mysqli::stmt_init — Inicializa una sentencia MySQL
mysqli::store_result — Transfiere un conjunto de resultados desde la última consulta
mysqli::$thread_id — Devuelve el identificador del hilo para la conexión actual
mysqli::thread_safe — Indica si el soporte de hilos está activado o no
mysqli::use_result — Inicializa la recuperación de un conjunto de resultados
mysqli::$warning_count — Devuelve el número de advertencias generadas por la última consulta ejecutada