La clase PDO

(PHP 5 >= 5.1.0, PHP 7, PHP 8, PECL pdo >= 0.1.0)

Introducción

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

Sinopsis de la Clase

class PDO {

/* Constantes */

public const int PARAM_NULL;

public const int PARAM_BOOL = 5;

public const int PARAM_INT = 1;

public const int PARAM_STR = 2;

public const int PARAM_LOB = 3;

public const int PARAM_STMT = 4;

public const int PARAM_INPUT_OUTPUT;

public const int PARAM_STR_NATL;

public const int PARAM_STR_CHAR;

public const int PARAM_EVT_ALLOC;

public const int PARAM_EVT_FREE;

public const int PARAM_EVT_EXEC_PRE;

public const int PARAM_EVT_EXEC_POST;

public const int PARAM_EVT_FETCH_PRE;

public const int PARAM_EVT_FETCH_POST;

public const int PARAM_EVT_NORMALIZE;

public const int FETCH_DEFAULT;

public const int FETCH_LAZY;

public const int FETCH_ASSOC;

public const int FETCH_NUM;

public const int FETCH_BOTH;

public const int FETCH_OBJ;

public const int FETCH_BOUND;

public const int FETCH_COLUMN;

public const int FETCH_CLASS;

public const int FETCH_INTO;

public const int FETCH_FUNC;

public const int FETCH_GROUP;

public const int FETCH_UNIQUE;

public const int FETCH_KEY_PAIR;

public const int FETCH_CLASSTYPE;

public const int FETCH_SERIALIZE;

public const int FETCH_PROPS_LATE;

public const int FETCH_NAMED;

public const int ATTR_AUTOCOMMIT;

public const int ATTR_PREFETCH;

public const int ATTR_TIMEOUT;

public const int ATTR_ERRMODE;

public const int ATTR_SERVER_VERSION;

public const int ATTR_CLIENT_VERSION;

public const int ATTR_SERVER_INFO;

public const int ATTR_CONNECTION_STATUS;

public const int ATTR_CASE;

public const int ATTR_CURSOR_NAME;

public const int ATTR_CURSOR;

public const int ATTR_ORACLE_NULLS;

public const int ATTR_PERSISTENT;

public const int ATTR_STATEMENT_CLASS;

public const int ATTR_FETCH_TABLE_NAMES;

public const int ATTR_FETCH_CATALOG_NAMES;

public const int ATTR_DRIVER_NAME;

public const int ATTR_STRINGIFY_FETCHES;

public const int ATTR_MAX_COLUMN_LEN;

public const int ATTR_EMULATE_PREPARES;

public const int ATTR_DEFAULT_FETCH_MODE;

public const int ATTR_DEFAULT_STR_PARAM;

public const int ERRMODE_SILENT;

public const int ERRMODE_WARNING;

public const int ERRMODE_EXCEPTION;

public const int CASE_NATURAL;

public const int CASE_LOWER;

public const int CASE_UPPER;

public const int NULL_NATURAL;

public const int NULL_EMPTY_STRING;

public const int NULL_TO_STRING;

public const string ERR_NONE;

public const int FETCH_ORI_NEXT;

public const int FETCH_ORI_PRIOR;

public const int FETCH_ORI_FIRST;

public const int FETCH_ORI_LAST;

public const int FETCH_ORI_ABS;

public const int FETCH_ORI_REL;

public const int CURSOR_FWDONLY;

public const int CURSOR_SCROLL;

/* Métodos */

public function __construct(
    string $dsn,
    ?string $username = null,
    #[\SensitiveParameter] ?string $password = null,
    ?array $options = null
)

public function beginTransaction(): bool

public function commit(): bool

public static function connect(
    string $dsn,
    ?string $username = null,
    #[\SensitiveParameter] ?string $password = null,
    ?array $options = null
): static

public function errorCode(): ?string

public function errorInfo(): array

public function exec(string $statement): int|false

public function getAttribute(int $attribute): mixed

public static function getAvailableDrivers(): array

public function inTransaction(): bool

public function lastInsertId(?string $name = null): string|false

public function prepare(string $query, array $options = []): PDOStatement|false

public function query(string $query, ?int $fetchMode = null): PDOStatement|false

public function query(string $query, ?int $fetchMode = PDO::FETCH_COLUMN, int $colno): PDOStatement|false

public function query(
    string $query,
    ?int $fetchMode = PDO::FETCH_CLASS,
    string $classname,
    array $constructorArgs
): PDOStatement|false

public function query(string $query, ?int $fetchMode = PDO::FETCH_INTO, object $object): PDOStatement|false

public function quote(string $string, int $type = PDO::PARAM_STR): string|false

public function rollBack(): bool

public function setAttribute(int $attribute, mixed $value): bool

}

Historial de cambios

Versión	Descripción
8.4.0	Las constantes de clase ahora están tipadas.

Tabla de contenidos

PDO::beginTransaction — Inicia una transacción
PDO::commit — Valida una transacción
PDO::connect — Conecta a una base de datos y devuelve una subclase PDO para los controladores que lo soportan
PDO::__construct — Crea una instancia PDO que representa una conexión a la base de datos
PDO::errorCode — Devuelve el SQLSTATE asociado con la última operación sobre la base de datos
PDO::errorInfo — Devuelve las informaciones asociadas al error durante la última operación sobre la base de datos
PDO::exec — Ejecuta una consulta SQL y devuelve el número de filas afectadas
PDO::getAttribute — Recupera un atributo de una conexión a una base de datos
PDO::getAvailableDrivers — Devuelve la lista de controladores PDO disponibles
PDO::inTransaction — Verifica si se encuentra en una transacción
PDO::lastInsertId — Devuelve el identificador de la última fila insertada o el valor de una secuencia
PDO::prepare — Prepara una consulta para su ejecución y devuelve un objeto
PDO::query — Prepara y ejecuta una consulta SQL sin marcadores de sustitución
PDO::quote — Protege una cadena para usarla en una consulta SQL PDO
PDO::rollBack — Anula una transacción
PDO::setAttribute — Configura un atributo PDO