Класс PDO

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

Введение

Представляет соединение между PHP и сервером базы данных.

Обзор класса

class PDO {

/* Константы */

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;

/* Методы */

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

}

Список изменений

Версия	Описание
8.4.0	Константы класса стали типизированными.

Содержание

PDO::beginTransaction — Инициализация транзакции
PDO::commit — Фиксирует транзакцию
PDO::connect — Подключается к базе данных и возвращает объект подкласса PDO для драйвера, который поддерживает заданную БД
PDO::__construct — Создаёт объект PDO, который предоставляет соединение с базой данных
PDO::errorCode — Возвращает код SQLSTATE результата последней операции с базой данных
PDO::errorInfo — Получает расширенную информацию об ошибке, произошедшей в ходе последнего обращения к базе данных
PDO::exec — Выполняет SQL-запрос и возвращает количество затронутых строк
PDO::getAttribute — Получает атрибут соединения с базой данных
PDO::getAvailableDrivers — Возвращает массив доступных драйверов PDO
PDO::inTransaction — Проверяет, начата ли транзакция
PDO::lastInsertId — Возвращает ID последней вставленной строки или значение последовательности
PDO::prepare — Подготавливает запрос к выполнению и возвращает связанный с этим запросом объект
PDO::query — Подготавливает и выполняет выражение SQL без заполнителей
PDO::quote — Форматирует строку в SQL-литерал
PDO::rollBack — Откат транзакции
PDO::setAttribute — Устанавливает атрибут