PHP: полный мануал с примерами, функциями и ООП

PHP 8.4+ · PDO; соответствующий драйвер

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

<?php
$db = PDO::connect('sqlite::memory:');
$db->exec(file_get_contents(__DIR__ . '/schema.sql'));
$statement = $db->query('SELECT name, stock FROM products WHERE id = 2');
$row = $statement->fetch(PDO::FETCH_ASSOC);
echo $row['name'], ' — ', $row['stock'], " шт.\n";

Перчатки — 15 шт.

Создать соединение с драйверным подклассом, если он предоставлен расширением.

$db обозначает соединение, $statement — подготовленную команду и её текущий результат. -> вызывает метод конкретного объекта, :: — статический метод или константу класса. Круглые скобки содержат аргументы; результат справа от = сохраняется в переменной. Это отдельные шаги: выполнить SQL и прочитать полученные строки. Основы: объекты, аргументы и возврат.

new возвращает объект соединения. Любая ошибка подключения вызывает PDOException независимо от ERRMODE. Три формы DSN: полный driver:..., доверенный alias из pdo.dsn.NAME в php.ini (не .htaccess/httpd.conf), исторический uri: с файлом/URL DSN. uri: устарел с PHP 8.5 из-за риска внешнего источника: для нового кода используйте собственную конфигурацию и полный DSN. Передавать пользовательский DSN нельзя. PDO не переводит диалекты SQL и не добавляет отсутствующую поддержку БД. Фабрика существует с 8.4; возвращает подходящий Pdo\Sqlite/Mysql/Pgsql/Odbc/Dblib/Firebird либо обычный PDO, если подкласса у драйвера нет.

Как читать этот вариант. Статическая фабрика выбирает драйверный подкласс. new PDO продолжает создавать базовый PDO; наличие драйверного объекта не меняет смысл SQL.

<?php
$db = PDO::connect('sqlite::memory:');
echo get_class($db), "\n";
echo $db->query('SELECT 7')->fetchColumn(), "\n";

Pdo\Sqlite
7

Как читать этот вариант. После PDO::connect доступен типизированный API Pdo\Sqlite. Это учебная функция с фиксированной прибавкой, а не расчёт налогов; callback исполняется PHP при выполнении SELECT.

<?php
$db = PDO::connect('sqlite::memory:');
$db->createFunction('gross', function ($net) { return $net + 20; }, 1);
echo $db->query('SELECT gross(100)')->fetchColumn(), "\n";

120

Рядом: PDO::__construct(), Pdo\Sqlite::createFunction().

• PHP: PDO::connect

PHP 5.1+; примеры PHP 8.2+ · PDO; соответствующий драйвер

PDO::getAvailableDrivers(): array

<?php
if (!in_array('sqlite', PDO::getAvailableDrivers(), true)) {
    exit("Каталог не открыт: включите pdo_sqlite в PHP этого процесса.\n");
}
require __DIR__ . '/catalog.php';
$statement = $db->query('SELECT name, stock FROM products WHERE id = 1');
$row = $statement->fetch(PDO::FETCH_ASSOC);
echo $row['name'], ' — ', $row['stock'], " шт.\n";

Молоток — 8 шт.

Получить имена доступных в текущем процессе PDO-драйверов.

$db обозначает соединение, $statement — подготовленную команду и её текущий результат. -> вызывает метод конкретного объекта, :: — статический метод или константу класса. Круглые скобки содержат аргументы; результат справа от = сохраняется в переменной. Это отдельные шаги: выполнить SQL и прочитать полученные строки. Основы: объекты, аргументы и возврат.

Возвращает массив строк вроде sqlite/mysql/pgsql; без драйверов пустой массив. Это возможность создать соединение, а не проверка доступности сервера или наличия таблиц.

Как читать этот вариант. Список содержит драйверы текущего PHP-процесса, а не установленного где-то сервера. PDO без нужного драйвера не соединится с БД.

<?php
$drivers = PDO::getAvailableDrivers();
echo in_array('sqlite', $drivers, true) ? "SQLite готов\n" : "Нужен pdo_sqlite\n";

SQLite готов

Как читать этот вариант. pdo_drivers — процедурный вариант той же операции. Пустой массив означает отсутствие загруженных PDO-драйверов; набор в веб-SAPI может отличаться от CLI.

<?php
var_dump(pdo_drivers() === PDO::getAvailableDrivers());

bool(true)

Рядом: PDO::__construct().

• PHP: PDO::getAvailableDrivers

PHP 5.1+; примеры PHP 8.2+ · PDO; соответствующий драйвер

pdo_drivers(): array

<?php
if (!in_array('sqlite', PDO::getAvailableDrivers(), true)) {
    exit("Каталог не открыт: включите pdo_sqlite в PHP этого процесса.\n");
}
require __DIR__ . '/catalog.php';
$statement = $db->query('SELECT name, stock FROM products WHERE id = 1');
$row = $statement->fetch(PDO::FETCH_ASSOC);
echo $row['name'], ' — ', $row['stock'], " шт.\n";

Молоток — 8 шт.

Получить имена доступных в текущем процессе PDO-драйверов.

$db обозначает соединение, $statement — подготовленную команду и её текущий результат. -> вызывает метод конкретного объекта, :: — статический метод или константу класса. Круглые скобки содержат аргументы; результат справа от = сохраняется в переменной. Это отдельные шаги: выполнить SQL и прочитать полученные строки. Основы: объекты, аргументы и возврат.

Возвращает массив строк вроде sqlite/mysql/pgsql; без драйверов пустой массив. Это возможность создать соединение, а не проверка доступности сервера или наличия таблиц.

Как читать этот вариант. Список содержит драйверы текущего PHP-процесса, а не установленного где-то сервера. PDO без нужного драйвера не соединится с БД.

<?php
$drivers = PDO::getAvailableDrivers();
echo in_array('sqlite', $drivers, true) ? "SQLite готов\n" : "Нужен pdo_sqlite\n";

SQLite готов

Как читать этот вариант. pdo_drivers — процедурный вариант той же операции. Пустой массив означает отсутствие загруженных PDO-драйверов; набор в веб-SAPI может отличаться от CLI.

<?php
var_dump(pdo_drivers() === PDO::getAvailableDrivers());

bool(true)

Рядом: PDO::__construct().

• PHP: pdo_drivers

PHP 5.1+; примеры PHP 8.2+ · PDO; соответствующий драйвер

PDO::getAttribute(int $attribute): mixed

<?php
require __DIR__ . '/catalog.php';
$driver = $db->getAttribute(PDO::ATTR_DRIVER_NAME);
if ($driver !== 'sqlite') { throw new RuntimeException('Этот урок рассчитан на SQLite'); }
$statement = $db->query('SELECT name, stock FROM products WHERE id = 2');
$row = $statement->fetch(PDO::FETCH_ASSOC);
echo $row['name'], ' — ', $row['stock'], " шт.\n";

Перчатки — 15 шт.

Прочитать настройку соединения или сведения драйвера.

$db обозначает соединение, $statement — подготовленную команду и её текущий результат. -> вызывает метод конкретного объекта, :: — статический метод или константу класса. Круглые скобки содержат аргументы; результат справа от = сохраняется в переменной. Это отдельные шаги: выполнить SQL и прочитать полученные строки. Основы: объекты, аргументы и возврат.

Тип результата зависит от атрибута; по документации неуспех даёт null, неподдерживаемый атрибут может выбросить PDOException. С 8.4 читается STRINGIFY_FETCHES; MySQL/Firebird AUTOCOMMIT и MySQL EMULATE_PREPARES/DIRECT_QUERY возвращают bool вместо int. Нельзя переносить драйверный атрибут на другой драйвер.

При неудаче SQL-операции режим ERRMODE_SILENT оставляет false и диагностику, ERRMODE_WARNING добавляет E_WARNING, ERRMODE_EXCEPTION выбрасывает PDOException (стандарт с PHP 8.0). Ошибки аргументов и отдельные ошибки состояния могут возникать независимо от этого режима. В примерах режим задан явно; сообщение драйвера не выводится посетителю.

Как читать этот вариант. getAttribute относится к соединению. Одно имя атрибута не означает поддержку всеми драйверами; не перебирайте чужие константы без проверки драйвера.

<?php
$db = new PDO('sqlite::memory:', null, null, [PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION]);
echo $db->getAttribute(PDO::ATTR_DRIVER_NAME), "\n";
var_dump($db->getAttribute(PDO::ATTR_ERRMODE) === PDO::ERRMODE_EXCEPTION);

sqlite
bool(true)

Как читать этот вариант. Getter STRINGIFY_FETCHES поддержан с PHP 8.4. Эта опция меняет чтение результата, а не тип столбца БД; null остаётся null, если ORACLE_NULLS не требует преобразования.

<?php
$db = new PDO('sqlite::memory:', null, null, [PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION]);
$db->setAttribute(PDO::ATTR_STRINGIFY_FETCHES, true);
var_dump($db->getAttribute(PDO::ATTR_STRINGIFY_FETCHES));
var_dump($db->query('SELECT 12')->fetchColumn());

bool(true)
string(2) "12"

Рядом: PDO::setAttribute(), PDOStatement::getAttribute().

• PHP: PDO::getAttribute

PHP 5.1+; примеры PHP 8.2+ · PDO; соответствующий драйвер

PDO::setAttribute(int $attribute, mixed $value): bool

<?php
require __DIR__ . '/catalog.php';
$db->setAttribute(PDO::ATTR_DEFAULT_FETCH_MODE, PDO::FETCH_ASSOC);
$statement = $db->query('SELECT name, stock FROM products WHERE id = 2');
$row = $statement->fetch();
echo $row['name'], ' — ', $row['stock'], " шт.\n";

Перчатки — 15 шт.

Настроить выдачу и поведение соединения под договор приложения.

$db обозначает соединение, $statement — подготовленную команду и её текущий результат. -> вызывает метод конкретного объекта, :: — статический метод или константу класса. Круглые скобки содержат аргументы; результат справа от = сохраняется в переменной. Это отдельные шаги: выполнить SQL и прочитать полученные строки. Основы: объекты, аргументы и возврат.

true при успехе, false при неудаче; ошибки режима зависят от ERRMODE. Полная таблица атрибутов находится в разделе констант. TIMEOUT — секунды, но в SQLite это ожидание блокировки записи, в другом драйвере может быть соединение/чтение. STATEMENT_CLASS требует [имя, аргументы конструктора] и несовместим с persistent. ATTR_PERSISTENT задают при создании, не этим методом. EMULATE_PREPARES=false просит нативную подготовку, но поддержка и fallback зависят от драйвера.

При неудаче SQL-операции режим ERRMODE_SILENT оставляет false и диагностику, ERRMODE_WARNING добавляет E_WARNING, ERRMODE_EXCEPTION выбрасывает PDOException (стандарт с PHP 8.0). Ошибки аргументов и отдельные ошибки состояния могут возникать независимо от этого режима. В примерах режим задан явно; сообщение драйвера не выводится посетителю.

Как читать этот вариант. CASE меняет ключи в PHP-результате, а не имена столбцов в схеме. Выбирайте один договор на границе проекта.

<?php
$db = new PDO('sqlite::memory:', null, null, [PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION]);
$db->setAttribute(PDO::ATTR_CASE, PDO::CASE_LOWER);
$row = $db->query('SELECT 42 AS OrderID')->fetch(PDO::FETCH_ASSOC);
echo $row['orderid'], "\n";

42

Как читать этот вариант. Несмотря на название, ORACLE_NULLS доступен всем драйверам. Превращение пустого текста в null теряет исходное различие, поэтому его задают по реальной схеме данных.

<?php
$db = new PDO('sqlite::memory:', null, null, [PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION]);
$db->setAttribute(PDO::ATTR_ORACLE_NULLS, PDO::NULL_NATURAL);
var_dump($db->query("SELECT ''")->fetchColumn());
$db->setAttribute(PDO::ATTR_ORACLE_NULLS, PDO::NULL_EMPTY_STRING);
var_dump($db->query("SELECT ''")->fetchColumn());

string(0) ""
NULL

Рядом: PDO::getAttribute(), PDOStatement::setAttribute().

• PHP: PDO::setAttribute

PHP 5.1+; примеры PHP 8.2+ · PDO; соответствующий драйвер

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

<?php
require __DIR__ . '/catalog.php';
$statement = $db->prepare('INSERT INTO products (name, stock) VALUES (:name, :stock)');
$statement->execute(['name'=>'Отвёртка', 'stock'=>4]);
$id = $db->lastInsertId();
$statement = $db->prepare('SELECT name, stock FROM products WHERE id = :id');
$statement->execute(['id'=>$id]);
$row = $statement->fetch();
echo 'Товар #', $id, ': ', $row['name'], ' — ', $row['stock'], " шт.\n";

Товар #4: Отвёртка — 4 шт.

Получить созданный идентификатор или значение последовательности на данном соединении.

$db обозначает соединение, $statement — подготовленную команду и её текущий результат. -> вызывает метод конкретного объекта, :: — статический метод или константу класса. Круглые скобки содержат аргументы; результат справа от = сохраняется в переменной. Это отдельные шаги: выполнить SQL и прочитать полученные строки. Основы: объекты, аргументы и возврат.

Возвращает строку либо false/ошибку. Возможность/смысл различаются: БД может не иметь auto increment/sequence; неподдерживаемая операция — SQLSTATE IM001. Не делайте предположение о последнем ID каждой строки многострочного INSERT и о переносимости между драйверами; когда СУБД поддерживает RETURNING, результат запроса обычно точнее связан с вставкой.

При неудаче SQL-операции режим ERRMODE_SILENT оставляет false и диагностику, ERRMODE_WARNING добавляет E_WARNING, ERRMODE_EXCEPTION выбрасывает PDOException (стандарт с PHP 8.0). Ошибки аргументов и отдельные ошибки состояния могут возникать независимо от этого режима. В примерах режим задан явно; сообщение драйвера не выводится посетителю.

Как читать этот вариант. Возврат — строка, даже когда ID выглядит числом. Получайте ID на том же соединении непосредственно после нужного INSERT; не заменяйте MAX(id), который может прочитать чужую запись.

<?php
$db = new PDO('sqlite::memory:', null, null, [PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION]);
$db->exec('CREATE TABLE orders (id INTEGER PRIMARY KEY, label TEXT)');
$db->exec("INSERT INTO orders (label) VALUES ('First')");
$id = $db->lastInsertId();
var_dump($id);

string(1) "1"

Как читать этот вариант. Две связанные записи созданы одной транзакцией; это не универсальное правило получения ID для всех драйверов. PostgreSQL часто удобнее INSERT ... RETURNING, а sequence-name имеет собственный смысл.

<?php
$db = new PDO('sqlite::memory:', null, null, [PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION]);
$db->exec('CREATE TABLE orders (id INTEGER PRIMARY KEY)');
$db->exec('CREATE TABLE lines (order_id INTEGER, sku TEXT)');
$db->beginTransaction();
$db->exec('INSERT INTO orders DEFAULT VALUES');
$id = $db->lastInsertId();
$statement = $db->prepare('INSERT INTO lines VALUES (?, ?)');
$statement->execute([$id, 'PEN']);
$db->commit();
echo $db->query('SELECT order_id || char(58) || sku FROM lines')->fetchColumn(), "\n";

1:PEN

Рядом: PDO::exec(), PDOStatement::execute().

• PHP: PDO::lastInsertId

PHP 5.1+; примеры PHP 8.2+ · PDO; соответствующий драйвер

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

<?php
require __DIR__ . '/catalog.php';
$name = "Кисть O'Reilly";
$quoted = $db->quote($name);
if ($quoted === false) { throw new RuntimeException('Драйвер не поддерживает quote'); }
$db->exec('INSERT INTO products (name, stock) VALUES (' . $quoted . ', 2)');
$statement = $db->query('SELECT name, stock FROM products WHERE id = 4');
$row = $statement->fetch(PDO::FETCH_ASSOC);
echo $row['name'], ' — ', $row['stock'], " шт.\n";

Кисть O'Reilly — 2 шт.

Получить строковый SQL-литерал для редкого случая ручной сборки доверенного запроса.

$db обозначает соединение, $statement — подготовленную команду и её текущий результат. -> вызывает метод конкретного объекта, :: — статический метод или константу класса. Круглые скобки содержат аргументы; результат справа от = сохраняется в переменной. Это отдельные шаги: выполнить SQL и прочитать полученные строки. Основы: объекты, аргументы и возврат.

Возвращает строку с кавычками и нужным драйверу экранированием, false при отсутствии поддержки (в частности ODBC). Корректная кодировка соединения должна быть задана на сервере/в DSN. Предпочитайте параметры: quote не защищает произвольную структуру SQL и не делает идентификатор безопасным. SQLite PHP 8.5 сообщает об ошибке NUL вместо прежнего молчаливого обрезания.

При неудаче SQL-операции режим ERRMODE_SILENT оставляет false и диагностику, ERRMODE_WARNING добавляет E_WARNING, ERRMODE_EXCEPTION выбрасывает PDOException (стандарт с PHP 8.0). Ошибки аргументов и отдельные ошибки состояния могут возникать независимо от этого режима. В примерах режим задан явно; сообщение драйвера не выводится посетителю.

Как читать этот вариант. В результат уже входят внешние SQL-кавычки. Это цитирование строкового значения, не имени таблицы и не шаблона LIKE. Для входных данных обычнее prepare/execute.

<?php
$db = new PDO('sqlite::memory:', null, null, [PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION]);
echo $db->quote("O'Brien"), "\n";

'O''Brien'

Как читать этот вариант. До 8.5 SQLite quote мог молча обрезать строку по NUL; теперь сообщение зависит от ERRMODE. Для двоичного значения нужен подходящий параметр LOB, а не ручная текстовая склейка.

<?php
$db = new PDO('sqlite::memory:', null, null, [PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION]);
try { $db->quote("a\0b"); } catch (PDOException $error) { echo "NUL нельзя цитировать как текст\n"; }

NUL нельзя цитировать как текст

Рядом: PDO::prepare(), PDOStatement::bindValue().

• PHP: PDO::quote

PHP 5.1+; примеры PHP 8.2+ · PDO; соответствующий драйвер

PDOStatement::bindColumn(string|int $column, mixed &$var, int $type = PDO::PARAM_STR, int $maxLength = 0, mixed $driverOptions = null): bool

<?php
require __DIR__ . '/catalog.php';
$statement = $db->query('SELECT name, stock FROM products ORDER BY id');
$statement->bindColumn('name', $name);
$statement->bindColumn('stock', $stock, PDO::PARAM_INT);
while ($statement->fetch(PDO::FETCH_BOUND)) {
    echo $name, ' — ', $stock, " шт.\n";
}

Молоток — 8 шт.
Перчатки — 15 шт.
Кисть — 0 шт.

Связать столбец результата с переменной PHP, которую будет обновлять чтение.

$db обозначает соединение, $statement — подготовленную команду и её текущий результат. -> вызывает метод конкретного объекта, :: — статический метод или константу класса. Круглые скобки содержат аргументы; результат справа от = сохраняется в переменной. Это отдельные шаги: выполнить SQL и прочитать полученные строки. Основы: объекты, аргументы и возврат.

true/false; привязка сама строку не читает. Обычно переносимый порядок execute → bindColumn → fetch, потому что до выполнения метаданных может не быть. Исключение: PostgreSQL PARAM_LOB нужно привязать до execute, чтобы получить поток вместо целочисленного OID. Каждый fetch/fetchAll обновляет связанные переменные; это не массив истории всех значений.

При неудаче SQL-операции режим ERRMODE_SILENT оставляет false и диагностику, ERRMODE_WARNING добавляет E_WARNING, ERRMODE_EXCEPTION выбрасывает PDOException (стандарт с PHP 8.0). Ошибки аргументов и отдельные ошибки состояния могут возникать независимо от этого режима. В примерах режим задан явно; сообщение драйвера не выводится посетителю.

Как читать этот вариант. Связывание результата отличается от связывания входа. fetch обновляет $name и $price. При FETCH_BOUND сам возврат true/false служит признаком наличия строки.

<?php
$db = new PDO('sqlite::memory:', null, null, [PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION]);
$db->exec('CREATE TABLE products (id INTEGER PRIMARY KEY, name TEXT NOT NULL, price INTEGER NOT NULL)');
$db->exec("INSERT INTO products VALUES (1, 'Pen', 120), (2, 'Notebook', 350), (3, 'Box', 200)");
$statement = $db->query('SELECT name, price FROM products WHERE id = 1');
$statement->bindColumn(1, $name, PDO::PARAM_STR);
$statement->bindColumn('price', $price, PDO::PARAM_INT);
if ($statement->fetch(PDO::FETCH_BOUND)) { echo $name, ':', $price, "\n"; }

Pen:120

Как читать этот вариант. Переменная $price перезаписывается на каждом fetch. Для простой суммы SQL SUM(price) обычно избавляет от переноса всех цен; цикл уместен, когда на строку нужна собственная PHP-логика.

<?php
$db = new PDO('sqlite::memory:', null, null, [PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION]);
$db->exec('CREATE TABLE products (id INTEGER PRIMARY KEY, name TEXT NOT NULL, price INTEGER NOT NULL)');
$db->exec("INSERT INTO products VALUES (1, 'Pen', 120), (2, 'Notebook', 350), (3, 'Box', 200)");
$statement = $db->query('SELECT price FROM products ORDER BY id');
$statement->bindColumn(1, $price, PDO::PARAM_INT);
$total = 0;
while ($statement->fetch(PDO::FETCH_BOUND)) { $total += $price; }
echo $total, "\n";

670

Рядом: PDOStatement::fetch(), PDOStatement::bindParam().

• PHP: PDOStatement::bindColumn

PHP 5.1+; примеры PHP 8.2+ · PDO; соответствующий драйвер

PDOStatement::fetchObject(?string $class = "stdClass", array $constructorArgs = []): object|false

<?php
require __DIR__ . '/catalog.php';
$statement = $db->query('SELECT name, stock FROM products WHERE id = 1');
$product = $statement->fetchObject();
if ($product === false) { exit("Товар не найден\n"); }
echo $product->name, ' — ', $product->stock, " шт.\n";

Молоток — 8 шт.

Прочитать одну строку как stdClass либо заданный класс представления.

$db обозначает соединение, $statement — подготовленную команду и её текущий результат. -> вызывает метод конкретного объекта, :: — статический метод или константу класса. Круглые скобки содержат аргументы; результат справа от = сохраняется в переменной. Это отдельные шаги: выполнить SQL и прочитать полученные строки. Основы: объекты, аргументы и возврат.

Объект или false при конце/неудаче. Сначала присваиваются свойства из колонок, затем вызывается конструктор; он может перезаписать их. Для порядка «конструктор → свойства» нужен setFetchMode(CLASS | PROPS_LATE). Типы свойств и ошибки конструктора остаются правилами PHP. Не выбирайте имя произвольного класса из внешних данных.

При неудаче SQL-операции режим ERRMODE_SILENT оставляет false и диагностику, ERRMODE_WARNING добавляет E_WARNING, ERRMODE_EXCEPTION выбрасывает PDOException (стандарт с PHP 8.0). Ошибки аргументов и отдельные ошибки состояния могут возникать независимо от этого режима. В примерах режим задан явно; сообщение драйвера не выводится посетителю.

Как читать этот вариант. Без имени класса создаётся stdClass. Стрелка читает свойство объекта, квадратные скобки массива здесь не подходят; при отсутствии строки проверяют === false.

<?php
$db = new PDO('sqlite::memory:', null, null, [PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION]);
$db->exec('CREATE TABLE products (id INTEGER PRIMARY KEY, name TEXT NOT NULL, price INTEGER NOT NULL)');
$db->exec("INSERT INTO products VALUES (1, 'Pen', 120), (2, 'Notebook', 350), (3, 'Box', 200)");
$product = $db->query('SELECT name, price FROM products WHERE id = 1')->fetchObject();
echo $product->name, ':', $product->price, "\n";

Pen:120

Как читать этот вариант. name приходит из SQL-свойства, RUB — из массива аргументов конструктора. Это два независимых канала. Сложный объект с инвариантами лучше создавать явно из проверенного массива, а не обходить его конструктор гидратацией.

<?php
$db = new PDO('sqlite::memory:', null, null, [PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION]);
$db->exec('CREATE TABLE products (id INTEGER PRIMARY KEY, name TEXT NOT NULL, price INTEGER NOT NULL)');
$db->exec("INSERT INTO products VALUES (1, 'Pen', 120), (2, 'Notebook', 350), (3, 'Box', 200)");
class ProductView {
    public string $name;
    public function __construct(public string $currency) {}
}
$statement = $db->query('SELECT name FROM products WHERE id = 2');
$product = $statement->fetchObject(ProductView::class, ['RUB']);
echo $product->name, ':', $product->currency, "\n";

Notebook:RUB

Рядом: PDOStatement::fetch(), PDOStatement::setFetchMode().

• PHP: PDOStatement::fetchObject

PHP 5.1+; примеры PHP 8.2+ · PDO; соответствующий драйвер

PDOStatement::setFetchMode(int $mode, mixed ...$args): true

<?php
require __DIR__ . '/catalog.php';
$statement = $db->query('SELECT name, stock FROM products ORDER BY id');
$statement->setFetchMode(PDO::FETCH_ASSOC);
foreach ($statement as $product) {
    echo $product['name'], ' — ', $product['stock'], " шт.\n";
}

Молоток — 8 шт.
Перчатки — 15 шт.
Кисть — 0 шт.

Выбрать форму строк по умолчанию для данного результата.

$db обозначает соединение, $statement — подготовленную команду и её текущий результат. -> вызывает метод конкретного объекта, :: — статический метод или константу класса. Круглые скобки содержат аргументы; результат справа от = сохраняется в переменной. Это отдельные шаги: выполнить SQL и прочитать полученные строки. Основы: объекты, аргументы и возврат.

true (с 8.4 тип возврата уточнён с bool). Неверное сочетание аргументов/режима вызывает ошибку. С 8.5 менять режим внутри текущего fetch/fetchObject/fetchAll запрещено Error. С 8.5 constructorArgs использует правила call_user_func_array: строковые ключи — имена параметров, ссылочные параметры требуют ссылочных элементов [&$value], автоматического оборачивания больше нет. FETCH_INTO обновляет один существующий объект; хранить его повторно как отдельные снимки без клонирования нельзя.

При неудаче SQL-операции режим ERRMODE_SILENT оставляет false и диагностику, ERRMODE_WARNING добавляет E_WARNING, ERRMODE_EXCEPTION выбрасывает PDOException (стандарт с PHP 8.0). Ошибки аргументов и отдельные ошибки состояния могут возникать независимо от этого режима. В примерах режим задан явно; сообщение драйвера не выводится посетителю.

Как читать этот вариант. Режим принадлежит конкретному statement. Другие запросы этого соединения его не наследуют; их общий default меняют атрибутом соединения.

<?php
$db = new PDO('sqlite::memory:', null, null, [PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION]);
$db->exec('CREATE TABLE products (id INTEGER PRIMARY KEY, name TEXT NOT NULL, price INTEGER NOT NULL)');
$db->exec("INSERT INTO products VALUES (1, 'Pen', 120), (2, 'Notebook', 350), (3, 'Box', 200)");
$statement = $db->query('SELECT id, name FROM products ORDER BY id');
$statement->setFetchMode(PDO::FETCH_COLUMN, 1);
foreach ($statement as $name) { echo $name, "\n"; }

Pen
Notebook
Box

Как читать этот вариант. При CLASS конструктор идёт после колонок и перезаписывает label. С PROPS_LATE порядок обратный. Модель нужна, чтобы запись из БД случайно не обходила правила вашего доменного объекта.

<?php
$db = new PDO('sqlite::memory:', null, null, [PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION]);
class LabelView {
    public string $label;
    public function __construct() { $this->label = 'constructor'; }
}
$statement = $db->query("SELECT 'database' AS label");
$statement->setFetchMode(PDO::FETCH_CLASS, LabelView::class);
echo $statement->fetch()->label, "\n";
$statement->execute();
$statement->setFetchMode(PDO::FETCH_CLASS | PDO::FETCH_PROPS_LATE, LabelView::class);
echo $statement->fetch()->label, "\n";

constructor
database

Рядом: PDO::setAttribute(), PDOStatement::fetchAll(), PDOStatement::fetchObject().

• PHP: PDOStatement::setFetchMode

PHP 8.0+ · PDO; соответствующий драйвер

PDOStatement::getIterator(): Iterator

<?php
require __DIR__ . '/catalog.php';
$statement = $db->query('SELECT name, stock FROM products ORDER BY id');
$iterator = $statement->getIterator();
foreach ($iterator as $row) {
    echo $row['name'], ' — ', $row['stock'], " шт.\n";
}

Молоток — 8 шт.
Перчатки — 15 шт.
Кисть — 0 шт.

Передать чтение строк инструментам работы с итераторами.

$db обозначает соединение, $statement — подготовленную команду и её текущий результат. -> вызывает метод конкретного объекта, :: — статический метод или константу класса. Круглые скобки содержат аргументы; результат справа от = сохраняется в переменной. Это отдельные шаги: выполнить SQL и прочитать полученные строки. Основы: объекты, аргументы и возврат.

Возвращает Iterator, связанный с текущим результатом; это реализация IteratorAggregate в PHP 8. Официальная страница содержит только сигнатуру: практическое поведение примеров сверено с PHP 8.5 и реализацией PDO. Последовательный курсор не является массивом произвольного доступа; повторный проход не следует считать перемоткой SQL. Не перемешивайте fetch и обход разных итераторов одного statement без ясного владения позицией.

При неудаче SQL-операции режим ERRMODE_SILENT оставляет false и диагностику, ERRMODE_WARNING добавляет E_WARNING, ERRMODE_EXCEPTION выбрасывает PDOException (стандарт с PHP 8.0). Ошибки аргументов и отдельные ошибки состояния могут возникать независимо от этого режима. В примерах режим задан явно; сообщение драйвера не выводится посетителю.

Как читать этот вариант. Это тот же поток строк statement, а не независимая копия. Обычно foreach ($statement ...) короче; явный Iterator нужен коду, который принимает именно итератор.

<?php
$db = new PDO('sqlite::memory:', null, null, [PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION]);
$db->exec('CREATE TABLE products (id INTEGER PRIMARY KEY, name TEXT NOT NULL, price INTEGER NOT NULL)');
$db->exec("INSERT INTO products VALUES (1, 'Pen', 120), (2, 'Notebook', 350), (3, 'Box', 200)");
$statement = $db->query('SELECT name FROM products ORDER BY id');
$statement->setFetchMode(PDO::FETCH_ASSOC);
$iterator = $statement->getIterator();
foreach ($iterator as $row) { echo $row['name'], "\n"; }

Pen
Notebook
Box

Как читать этот вариант. LimitIterator останавливает PHP-обход после двух значений, но не переписывает SQL и не гарантирует экономию серверного буфера. Для ограничения самого запроса используйте SQL LIMIT/драйверный аналог.

<?php
$db = new PDO('sqlite::memory:', null, null, [PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION]);
$db->exec('CREATE TABLE products (id INTEGER PRIMARY KEY, name TEXT NOT NULL, price INTEGER NOT NULL)');
$db->exec("INSERT INTO products VALUES (1, 'Pen', 120), (2, 'Notebook', 350), (3, 'Box', 200)");
$statement = $db->query('SELECT name FROM products ORDER BY id');
$statement->setFetchMode(PDO::FETCH_COLUMN, 0);
$iterator = new LimitIterator($statement->getIterator(), 0, 2);
foreach ($iterator as $name) { echo $name, "\n"; }
$statement->closeCursor();

Pen
Notebook

Рядом: PDOStatement::fetch(), PDOStatement::closeCursor().

• PHP: PDOStatement::getIterator

PHP 5.1+; примеры PHP 8.2+ · PDO; соответствующий драйвер

PDO::errorCode(): ?string

<?php
require __DIR__ . '/catalog.php';
$db->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_SILENT);
$db->exec("INSERT INTO products VALUES (1, 'Дубликат', 1)");
$diagnostic = $db->errorCode();
$state = $diagnostic;
if ($state === '23000') {
    echo "Товар с таким номером уже есть: новая запись не сохранена.\n";
}
$statement = $db->query('SELECT name, stock FROM products WHERE id = 1');
$row = $statement->fetch(PDO::FETCH_ASSOC);
echo $row['name'], ' — ', $row['stock'], " шт.\n";

Товар с таким номером уже есть: новая запись не сохранена.
Молоток — 8 шт.

Получить SQLSTATE последней операции соединения.

$db обозначает соединение, $statement — подготовленную команду и её текущий результат. -> вызывает метод конкретного объекта, :: — статический метод или константу класса. Круглые скобки содержат аргументы; результат справа от = сохраняется в переменной. Это отдельные шаги: выполнить SQL и прочитать полученные строки. Основы: объекты, аргументы и возврат.

SQLSTATE — пять букв/цифр: первые две обозначают класс, следующие три подкласс; 00000 — успех, 01 — предупреждение, IM — ошибка реализации PDO/ODBC. До операции возможно null. Ошибка execute у statement не обязана отражаться в $db: спрашивайте именно statement.

Как читать этот вариант. Пример специально использует SILENT и строго проверяет возврат. SQLSTATE — строка из пяти знаков; конкретные коды драйвера и сообщения не являются универсальными между БД.

<?php
$db = new PDO('sqlite::memory:', null, null, [PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION]);
$db->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_SILENT);
$ok = $db->exec('INSERT INTO missing_table VALUES (1)');
var_dump($ok);
echo $db->errorCode(), "\n";

bool(false)
HY000

Как читать этот вариант. После успешной новой операции состояние обновилось. Нужную диагностику сохраняют сразу, прежде чем делать ещё один запрос; 00000 соответствует PDO::ERR_NONE.

<?php
$db = new PDO('sqlite::memory:', null, null, [PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION]);
$db->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_SILENT);
$ok = $db->exec('INSERT INTO missing_table VALUES (1)');
$db->exec('CREATE TABLE ready (id INTEGER)');
echo $db->errorCode(), "\n";

00000

Рядом: PDO::errorInfo().

• PHP: PDO::errorCode

PHP 5.1+; примеры PHP 8.2+ · PDO; соответствующий драйвер

PDO::errorInfo(): array

<?php
require __DIR__ . '/catalog.php';
$db->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_SILENT);
$db->exec("INSERT INTO products VALUES (1, 'Дубликат', 1)");
$diagnostic = $db->errorInfo();
$state = $diagnostic[0];
if ($state === '23000') {
    echo "Товар с таким номером уже есть: новая запись не сохранена.\n";
}
$statement = $db->query('SELECT name, stock FROM products WHERE id = 1');
$row = $statement->fetch(PDO::FETCH_ASSOC);
echo $row['name'], ' — ', $row['stock'], " шт.\n";

Товар с таким номером уже есть: новая запись не сохранена.
Молоток — 8 шт.

Получить подробности SQL-ошибки для технической диагностики.

$db обозначает соединение, $statement — подготовленную команду и её текущий результат. -> вызывает метод конкретного объекта, :: — статический метод или константу класса. Круглые скобки содержат аргументы; результат справа от = сохраняется в переменной. Это отдельные шаги: выполнить SQL и прочитать полученные строки. Основы: объекты, аргументы и возврат.

Массив минимум [SQLSTATE, driverCode, driverMessage]; без ошибки драйвера элементы после 0 могут быть null. Тип/содержание полей драйвера зависят от расширения. Читать нужно у объекта, который выполнял проблемную операцию, сразу после неё. Не отдавайте SQL и сырое сообщение через публичную форму/API; человеку нужен понятный отказ и идентификатор обращения.

Как читать этот вариант. Элемент 0 — SQLSTATE, 1 — код конкретного драйвера, 2 — его сообщение. Здесь проверяется форма, а не нестабильный текст SQLite; SQL/имена/данные могут быть чувствительными.

<?php
$db = new PDO('sqlite::memory:', null, null, [PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION]);
$db->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_SILENT);
$ok = $db->exec('INSERT INTO missing_table VALUES (1)');
$info = $db->errorInfo();
echo $info[0], "\n";
var_dump(is_int($info[1]), is_string($info[2]));

HY000
bool(true)
bool(true)

Как читать этот вариант. Успешный SQLSTATE не требует показа посетителю всей диагностической структуры. Используйте результат операции как основной договор, errorInfo — для разбора отказа.

<?php
$db = new PDO('sqlite::memory:', null, null, [PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION]);
$db->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_SILENT);
$db->exec('CREATE TABLE ready (id INTEGER)');
$info = $db->errorInfo();
echo $info[0], "\n";

00000

Рядом: PDO::errorCode().

• PHP: PDO::errorInfo

PHP 5.1+; примеры PHP 8.2+ · PDO; соответствующий драйвер

PDOStatement::errorCode(): ?string

<?php
require __DIR__ . '/catalog.php';
$db->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_SILENT);
$statement = $db->prepare('INSERT INTO products (id, name, stock) VALUES (1, :name, 1)');
$statement->execute(['name'=>'Дубликат']);
$diagnostic = $statement->errorCode();
$state = $diagnostic;
if ($state === '23000') {
    echo "Товар с таким номером уже есть: новая запись не сохранена.\n";
}
$statement = $db->query('SELECT name, stock FROM products WHERE id = 1');
$row = $statement->fetch(PDO::FETCH_ASSOC);
echo $row['name'], ' — ', $row['stock'], " шт.\n";

Товар с таким номером уже есть: новая запись не сохранена.
Молоток — 8 шт.

Получить SQLSTATE последней операции данного statement.

$db обозначает соединение, $statement — подготовленную команду и её текущий результат. -> вызывает метод конкретного объекта, :: — статический метод или константу класса. Круглые скобки содержат аргументы; результат справа от = сохраняется в переменной. Это отдельные шаги: выполнить SQL и прочитать полученные строки. Основы: объекты, аргументы и возврат.

SQLSTATE — пять букв/цифр: первые две обозначают класс, следующие три подкласс; 00000 — успех, 01 — предупреждение, IM — ошибка реализации PDO/ODBC. До операции возможно null. Соединение и другие команды имеют собственную диагностику. После исключения можно читать errorInfo самого исключения.

Как читать этот вариант. Пример специально использует SILENT и строго проверяет возврат. SQLSTATE — строка из пяти знаков; конкретные коды драйвера и сообщения не являются универсальными между БД.

<?php
$db = new PDO('sqlite::memory:', null, null, [PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION]);
$db->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_SILENT);
$db->exec('CREATE TABLE orders (id INTEGER PRIMARY KEY)');
$db->exec('INSERT INTO orders VALUES (1)');
$statement = $db->prepare('INSERT INTO orders VALUES (?)');
$ok = $statement->execute([1]);
var_dump($ok);
echo $statement->errorCode(), "\n";

bool(false)
23000

Как читать этот вариант. После успешной новой операции состояние обновилось. Нужную диагностику сохраняют сразу, прежде чем делать ещё один запрос; 00000 соответствует PDO::ERR_NONE.

<?php
$db = new PDO('sqlite::memory:', null, null, [PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION]);
$db->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_SILENT);
$db->exec('CREATE TABLE orders (id INTEGER PRIMARY KEY)');
$db->exec('INSERT INTO orders VALUES (1)');
$statement = $db->prepare('INSERT INTO orders VALUES (?)');
$ok = $statement->execute([1]);
$statement->closeCursor();
$statement->execute([2]);
echo $statement->errorCode(), "\n";

00000

Рядом: PDOStatement::errorInfo().

• PHP: PDOStatement::errorCode

PHP 5.1+; примеры PHP 8.2+ · PDO; соответствующий драйвер

PDOStatement::errorInfo(): array

<?php
require __DIR__ . '/catalog.php';
$db->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_SILENT);
$statement = $db->prepare('INSERT INTO products (id, name, stock) VALUES (1, :name, 1)');
$statement->execute(['name'=>'Дубликат']);
$diagnostic = $statement->errorInfo();
$state = $diagnostic[0];
if ($state === '23000') {
    echo "Товар с таким номером уже есть: новая запись не сохранена.\n";
}
$statement = $db->query('SELECT name, stock FROM products WHERE id = 1');
$row = $statement->fetch(PDO::FETCH_ASSOC);
echo $row['name'], ' — ', $row['stock'], " шт.\n";

Товар с таким номером уже есть: новая запись не сохранена.
Молоток — 8 шт.

Получить подробности SQL-ошибки для технической диагностики.

$db обозначает соединение, $statement — подготовленную команду и её текущий результат. -> вызывает метод конкретного объекта, :: — статический метод или константу класса. Круглые скобки содержат аргументы; результат справа от = сохраняется в переменной. Это отдельные шаги: выполнить SQL и прочитать полученные строки. Основы: объекты, аргументы и возврат.

Массив минимум [SQLSTATE, driverCode, driverMessage]; без ошибки драйвера элементы после 0 могут быть null. Тип/содержание полей драйвера зависят от расширения. Читать нужно у объекта, который выполнял проблемную операцию, сразу после неё. Не отдавайте SQL и сырое сообщение через публичную форму/API; человеку нужен понятный отказ и идентификатор обращения.

Как читать этот вариант. Элемент 0 — SQLSTATE, 1 — код конкретного драйвера, 2 — его сообщение. Здесь проверяется форма, а не нестабильный текст SQLite; SQL/имена/данные могут быть чувствительными.

<?php
$db = new PDO('sqlite::memory:', null, null, [PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION]);
$db->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_SILENT);
$db->exec('CREATE TABLE orders (id INTEGER PRIMARY KEY)');
$db->exec('INSERT INTO orders VALUES (1)');
$statement = $db->prepare('INSERT INTO orders VALUES (?)');
$ok = $statement->execute([1]);
$info = $statement->errorInfo();
echo $info[0], "\n";
var_dump(is_int($info[1]), is_string($info[2]));

23000
bool(true)
bool(true)

Как читать этот вариант. Успешный SQLSTATE не требует показа посетителю всей диагностической структуры. Используйте результат операции как основной договор, errorInfo — для разбора отказа.

<?php
$db = new PDO('sqlite::memory:', null, null, [PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION]);
$db->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_SILENT);
$db->exec('CREATE TABLE orders (id INTEGER PRIMARY KEY)');
$db->exec('INSERT INTO orders VALUES (1)');
$statement = $db->prepare('INSERT INTO orders VALUES (?)');
$statement->closeCursor();
$statement->execute([2]);
$info = $statement->errorInfo();
echo $info[0], "\n";

00000

Рядом: PDOStatement::errorCode().

• PHP: PDOStatement::errorInfo

PHP 5.1+; примеры PHP 8.2+ · PDO; соответствующий драйвер

PDOStatement::columnCount(): int

<?php
require __DIR__ . '/catalog.php';
$statement = $db->query('SELECT name, stock FROM products ORDER BY id');
if ($statement->columnCount() !== 2) { throw new RuntimeException('Неожиданные колонки экспорта'); }
echo "Товар;Остаток\n";
while (($row = $statement->fetch(PDO::FETCH_NUM)) !== false) {
    echo $row[0], ';', $row[1], "\n";
}

Товар;Остаток
Молоток;8
Перчатки;15
Кисть;0

Узнать, сколько столбцов имеет текущий набор результата.

$db обозначает соединение, $statement — подготовленную команду и её текущий результат. -> вызывает метод конкретного объекта, :: — статический метод или константу класса. Круглые скобки содержат аргументы; результат справа от = сохраняется в переменной. Это отдельные шаги: выполнить SQL и прочитать полученные строки. Основы: объекты, аргументы и возврат.

Число столбцов, в том числе у пустого результата; 0 если набора нет. После query доступно сразу, после prepare — надёжно только после execute. Это не число строк и не число параметров SQL.

При неудаче SQL-операции режим ERRMODE_SILENT оставляет false и диагностику, ERRMODE_WARNING добавляет E_WARNING, ERRMODE_EXCEPTION выбрасывает PDOException (стандарт с PHP 8.0). Ошибки аргументов и отдельные ошибки состояния могут возникать независимо от этого режима. В примерах режим задан явно; сообщение драйвера не выводится посетителю.

Как читать этот вариант. Число колонок описывает форму результата, не количество строк. Даже без найденных товаров запрос объявляет id и name.

<?php
$db = new PDO('sqlite::memory:', null, null, [PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION]);
$db->exec('CREATE TABLE products (id INTEGER PRIMARY KEY, name TEXT NOT NULL, price INTEGER NOT NULL)');
$db->exec("INSERT INTO products VALUES (1, 'Pen', 120), (2, 'Notebook', 350), (3, 'Box', 200)");
$statement = $db->query('SELECT id, name FROM products WHERE id = 99');
echo $statement->columnCount(), "\n";
var_dump($statement->fetch(PDO::FETCH_ASSOC));

2
bool(false)

Как читать этот вариант. После prepare метаданные ещё не гарантированы. После execute можно строить подписи экспорта и читать колонки, но не определять всю бизнес-схему только по результату.

<?php
$db = new PDO('sqlite::memory:', null, null, [PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION]);
$db->exec('CREATE TABLE products (id INTEGER PRIMARY KEY, name TEXT NOT NULL, price INTEGER NOT NULL)');
$db->exec("INSERT INTO products VALUES (1, 'Pen', 120), (2, 'Notebook', 350), (3, 'Box', 200)");
$statement = $db->prepare('SELECT name, price FROM products WHERE id = ?');
$statement->execute([1]);
echo $statement->columnCount(), "\n";

2

Рядом: PDOStatement::getColumnMeta(), PDOStatement::rowCount().

• PHP: PDOStatement::columnCount

PHP 5.1+; примеры PHP 8.2+ · PDO; соответствующий драйвер

PDOStatement::getColumnMeta(int $column): array|false

<?php
require __DIR__ . '/catalog.php';
$statement = $db->query('SELECT name AS product, stock AS available FROM products WHERE id = 1');
$first = $statement->getColumnMeta(0);
$second = $statement->getColumnMeta(1);
if ($first === false || $second === false) { throw new RuntimeException('Метаданные недоступны'); }
echo $first['name'], ';', $second['name'], "\n";
$row = $statement->fetch(PDO::FETCH_NUM);
echo $row[0], ';', $row[1], "\n";

product;available
Молоток;8

Получить метаданные конкретной колонки текущей выдачи.

$db обозначает соединение, $statement — подготовленную команду и её текущий результат. -> вызывает метод конкретного объекта, :: — статический метод или константу класса. Круглые скобки содержат аргументы; результат справа от = сохраняется в переменной. Это отдельные шаги: выполнить SQL и прочитать полученные строки. Основы: объекты, аргументы и возврат.

Массив или false, если столбца/результата нет. Поля: native_type — внутреннее представление, driver:decl_type — объявленный SQL-тип (не для выражений), flags, name, table, len, precision, pdo_type (PARAM_*). len часто -1, precision часто 0. API необязателен для драйверов, хотя документированные PDO-драйверы реализуют его. Не строите миграции схемы из неполных метаданных SELECT.

При неудаче SQL-операции режим ERRMODE_SILENT оставляет false и диагностику, ERRMODE_WARNING добавляет E_WARNING, ERRMODE_EXCEPTION выбрасывает PDOException (стандарт с PHP 8.0). Ошибки аргументов и отдельные ошибки состояния могут возникать независимо от этого режима. В примерах режим задан явно; сообщение драйвера не выводится посетителю.

Как читать этот вариант. Номер метаданных начинается с 0. SQL-псевдоним становится именем результата; показывать его пользователю напрямую можно только если это подходящая подпись.

<?php
$db = new PDO('sqlite::memory:', null, null, [PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION]);
$db->exec('CREATE TABLE products (id INTEGER PRIMARY KEY, name TEXT NOT NULL, price INTEGER NOT NULL)');
$db->exec("INSERT INTO products VALUES (1, 'Pen', 120), (2, 'Notebook', 350), (3, 'Box', 200)");
$statement = $db->query('SELECT name AS product_name, price FROM products');
$meta = $statement->getColumnMeta(0);
echo $meta['name'], "\n";

product_name

Как читать этот вариант. У выражения может не быть driver:decl_type/table. Даже физические метаданные различаются по драйверу и версии; проверяйте существование ключей.

<?php
$db = new PDO('sqlite::memory:', null, null, [PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION]);
$db->exec('CREATE TABLE products (id INTEGER PRIMARY KEY, name TEXT NOT NULL, price INTEGER NOT NULL)');
$db->exec("INSERT INTO products VALUES (1, 'Pen', 120), (2, 'Notebook', 350), (3, 'Box', 200)");
$statement = $db->query('SELECT price * 2 AS double_price FROM products');
$meta = $statement->getColumnMeta(0);
echo $meta['name'], "\n";
echo $meta['sqlite:decl_type'] ?? 'Нет объявленного типа', "\n";

double_price
Нет объявленного типа

Рядом: PDOStatement::columnCount(), PDOStatement::fetch().

• PHP: PDOStatement::getColumnMeta

PHP 5.1+; примеры PHP 8.2+ · PDO; соответствующий драйвер

PDOStatement::debugDumpParams(): ?bool

<?php
require __DIR__ . '/catalog.php';
$statement = $db->prepare('SELECT name, stock FROM products WHERE id = :id');
$statement->bindValue(':id', 2, PDO::PARAM_INT);
ob_start();
$statement->debugDumpParams();
$diagnostic = ob_get_clean();
if (str_contains($diagnostic, ':id')) { echo "Маркер :id присутствует в диагностике\n"; }
$statement->execute();
$row = $statement->fetch(PDO::FETCH_ASSOC);
echo $row['name'], ' — ', $row['stock'], " шт.\n";

Маркер :id присутствует в диагностике
Перчатки — 15 шт.

Посмотреть SQL-шаблон и существующие привязки во время локальной отладки.

$db обозначает соединение, $statement — подготовленную команду и её текущий результат. -> вызывает метод конкретного объекта, :: — статический метод или константу класса. Круглые скобки содержат аргументы; результат справа от = сохраняется в переменной. Это отдельные шаги: выполнить SQL и прочитать полученные строки. Основы: объекты, аргументы и возврат.

Печатает SQL, число Params, имя/позицию/тип param_type и is_param; позиция может быть -1, если драйвер её не сообщает. Возврат null при нормальной работе либо false при ошибке. Только текущие связанные параметры, не лишние переданные значения. При эмуляции с 7.2 возможен sent SQL со значениями. Для программного анализа стабильнее собственный безопасный журнал структуры: формат дампа предназначен человеку.

Как читать этот вариант. debugDumpParams печатает напрямую и не возвращает строку. ob_start перехватывает вывод, ob_get_clean забирает строку и закрывает буфер. В примере не печатается потенциально чувствительный дамп.

<?php
$db = new PDO('sqlite::memory:', null, null, [PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION]);
$statement = $db->prepare('SELECT :id');
$statement->bindValue(':id', 42, PDO::PARAM_INT);
ob_start();
$result = $statement->debugDumpParams();
$dump = ob_get_clean();
var_dump($result, str_contains($dump, 'Params:  1'));

NULL
bool(true)

Как читать этот вариант. Нативный режим не обязан показывать SQL с подставленными значениями. С PHP 7.2 при эмуляции дамп может содержать полный sent SQL и секретные данные; не помещайте его в общий журнал запросов автоматически.

<?php
$db = new PDO('sqlite::memory:', null, null, [PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION]);
$statement = $db->prepare('SELECT :name');
$statement->bindValue(':name', 'sample');
ob_start();
$statement->debugDumpParams();
$dump = ob_get_clean();
echo str_contains($dump, 'SELECT :name') ? "Шаблон найден\n" : "Шаблон не найден\n";

Шаблон найден

Рядом: PDOStatement::bindValue().

• PHP: PDOStatement::debugDumpParams

PHP 8.4+ · PDO; соответствующий драйвер

Pdo\Sqlite::createFunction(string $function_name, callable $callback, int $num_args = -1, int $flags = 0): bool

<?php
require __DIR__ . '/catalog.php';
$db->createFunction('stock_label', function ($stock) {
    return $stock > 0 ? $stock . ' шт.' : 'Нет в наличии';
}, 1);
$row = $db->query('SELECT name, stock_label(stock) AS availability FROM products WHERE id = 3')->fetch(PDO::FETCH_ASSOC);
echo $row['name'], ': ', $row['availability'], "\n";

Кисть: Нет в наличии

Добавить в SQLite скалярную функцию, реализованную PHP-кодом.

$db обозначает соединение, $statement — подготовленную команду и её текущий результат. -> вызывает метод конкретного объекта, :: — статический метод или константу класса. Круглые скобки содержат аргументы; результат справа от = сохраняется в переменной. Это отдельные шаги: выполнить SQL и прочитать полученные строки. Основы: объекты, аргументы и возврат.

true/false при регистрации. Можно переопределить встроенную SQL-функцию, но это меняет поведение только данного соединения и усложняет переносимость. SQL может вызывать callback многократно; не помещайте туда оплату/отправку сообщений. Доступно через драйверный подкласс с 8.4.

Как читать этот вариант. createFunction связывает имя SQL с PHP callback на этом соединении. В SELECT значение 100 становится аргументом callback, 130 возвращается в вычисление SQL; это не встроенная функция всех баз SQLite.

<?php
$db = new Pdo\Sqlite('sqlite::memory:');
$db->createFunction('with_fee', fn ($price) => $price + 30, 1);
echo $db->query('SELECT with_fee(100)')->fetchColumn(), "\n";

130

Как читать этот вариант. Флаг DETERMINISTIC обещает один результат для одинаковых входов в пределах SQL-операции. Callback с часами, случайностью или внешним запросом такого обещания не выполняет. На больших выборках каждый PHP-вызов добавляет работу, поэтому встроенное SQL-выражение часто проще.

<?php
$db = new Pdo\Sqlite('sqlite::memory:');
$db->createFunction('item_label', fn ($sku, $name) => $sku . ': ' . $name, 2, Pdo\Sqlite::DETERMINISTIC);
echo $db->query("SELECT item_label('PEN-1', 'Pen')")->fetchColumn(), "\n";

PEN-1: Pen

Рядом: PDO::connect(), Pdo\Sqlite::createAggregate().

• PHP: Pdo\Sqlite::createFunction

PHP 5.1+; устарело с PHP 8.5 · PDO; соответствующий драйвер

PDO::sqliteCreateFunction(string $function_name, callable $callback, int $num_args = -1, int $flags = 0): bool

<?php
require __DIR__ . '/catalog.php';
$db->createFunction('stock_label', function ($stock) {
    return $stock > 0 ? $stock . ' шт.' : 'Нет в наличии';
}, 1);
$row = $db->query('SELECT name, stock_label(stock) AS availability FROM products WHERE id = 3')->fetch(PDO::FETCH_ASSOC);
echo $row['name'], ': ', $row['availability'], "\n";

Кисть: Нет в наличии

Добавить в SQLite скалярную функцию, реализованную PHP-кодом.

$db обозначает соединение, $statement — подготовленную команду и её текущий результат. -> вызывает метод конкретного объекта, :: — статический метод или константу класса. Круглые скобки содержат аргументы; результат справа от = сохраняется в переменной. Это отдельные шаги: выполнить SQL и прочитать полученные строки. Основы: объекты, аргументы и возврат.

true/false при регистрации. Можно переопределить встроенную SQL-функцию, но это меняет поведение только данного соединения и усложняет переносимость. SQL может вызывать callback многократно; не помещайте туда оплату/отправку сообщений. Старый метод — alias, с 8.5 deprecated; миграция: новый драйверный объект и короткое имя.

Как читать этот вариант. Историческое имя требует pdo_sqlite и базовый PDO. Пример приведён для миграции и только проверяется на синтаксис: современный код использует Pdo\Sqlite::createFunction.

<?php
$db = new PDO('sqlite::memory:');
$db->sqliteCreateFunction('with_fee', fn ($price) => $price + 30, 1);
echo $db->query('SELECT with_fee(100)')->fetchColumn();

На PHP до 8.5: 130; в 8.5 также предупреждение устаревания.

Как читать этот вариант. Флаг DETERMINISTIC обещает один результат для одинаковых входов в пределах SQL-операции. Callback с часами, случайностью или внешним запросом такого обещания не выполняет. На больших выборках каждый PHP-вызов добавляет работу, поэтому встроенное SQL-выражение часто проще.

<?php
$db = new Pdo\Sqlite('sqlite::memory:');
$db->createFunction('item_label', fn ($sku, $name) => $sku . ': ' . $name, 2, Pdo\Sqlite::DETERMINISTIC);
echo $db->query("SELECT item_label('PEN-1', 'Pen')")->fetchColumn(), "\n";

PEN-1: Pen

Рядом: PDO::connect(), Pdo\Sqlite::createAggregate().

• PHP: PDO::sqliteCreateFunction

PHP 8.4+ · PDO; соответствующий драйвер

Pdo\Sqlite::createAggregate(string $name, callable $step, callable $finalize, int $numArgs = -1): bool

<?php
require __DIR__ . '/catalog.php';
$db->createAggregate('stock_total',
    function ($sum, $rowNumber, $stock) { return ($sum ?? 0) + $stock; },
    function ($sum, $rowCount) { return $sum ?? 0; }, 1);
$row = $db->query('SELECT stock_total(stock) AS total FROM products')->fetch(PDO::FETCH_ASSOC);
echo 'Всего на складе: ', $row['total'], " шт.\n";

Всего на складе: 23 шт.

Вычислить собственный итог по нескольким строкам SQLite.

$db обозначает соединение, $statement — подготовленную команду и её текущий результат. -> вызывает метод конкретного объекта, :: — статический метод или константу класса. Круглые скобки содержат аргументы; результат справа от = сохраняется в переменной. Это отдельные шаги: выполнить SQL и прочитать полученные строки. Основы: объекты, аргументы и возврат.

true/false. Состояние накапливают в возвращаемом context, а не рассчитывают на изменение копии параметра без return. finalize должен вернуть скаляр/null, не PHP-массив. Возможны пользовательские агрегаты и GROUP BY; встроенные SUM/AVG дешевле и понятнее, если делают нужное.

Как читать этот вариант. step получает контекст предыдущего шага, номер строки и два SQL-аргумента. Возвращённые 240 переходят в следующий context, затем получается 590; finalize превращает последнее состояние в итог. Обычный SUM(price*quantity) здесь проще: пример объясняет устройство, которое пригодится для действительно собственного агрегата.

<?php
$db = new Pdo\Sqlite('sqlite::memory:');
$db->createAggregate('weighted_sum',
    fn ($context, $rowNumber, $price, $quantity) => ($context ?? 0) + $price * $quantity,
    fn ($context, $rowCount) => $context ?? 0,
    2
);
echo $db->query('SELECT weighted_sum(price, quantity) FROM (SELECT 120 AS price, 2 AS quantity UNION ALL SELECT 350, 1)')->fetchColumn(), "\n";

590

Как читать этот вариант. Пустая выборка оставляет context=null. finalize явно выбирает итог 0. Это бизнес-решение: среднее по пустому набору, например, логичнее вернуть null, а не делить на ноль.

<?php
$db = new Pdo\Sqlite('sqlite::memory:');
$db->createAggregate('total_units', fn ($sum, $row, $value) => ($sum ?? 0) + $value, fn ($sum, $count) => $sum ?? 0, 1);
echo $db->query('SELECT total_units(value) FROM (SELECT 1 AS value) WHERE 0')->fetchColumn(), "\n";

0

Рядом: Pdo\Sqlite::createFunction().

• PHP: Pdo\Sqlite::createAggregate

PHP 5.1+; устарело с PHP 8.5 · PDO; соответствующий драйвер

PDO::sqliteCreateAggregate(string $name, callable $step, callable $finalize, int $numArgs = -1): bool

<?php
require __DIR__ . '/catalog.php';
$db->createAggregate('stock_total',
    function ($sum, $rowNumber, $stock) { return ($sum ?? 0) + $stock; },
    function ($sum, $rowCount) { return $sum ?? 0; }, 1);
$row = $db->query('SELECT stock_total(stock) AS total FROM products')->fetch(PDO::FETCH_ASSOC);
echo 'Всего на складе: ', $row['total'], " шт.\n";

Всего на складе: 23 шт.

Вычислить собственный итог по нескольким строкам SQLite.

$db обозначает соединение, $statement — подготовленную команду и её текущий результат. -> вызывает метод конкретного объекта, :: — статический метод или константу класса. Круглые скобки содержат аргументы; результат справа от = сохраняется в переменной. Это отдельные шаги: выполнить SQL и прочитать полученные строки. Основы: объекты, аргументы и возврат.

true/false. Состояние накапливают в возвращаемом context, а не рассчитывают на изменение копии параметра без return. finalize должен вернуть скаляр/null, не PHP-массив. Возможны пользовательские агрегаты и GROUP BY; встроенные SUM/AVG дешевле и понятнее, если делают нужное. Старое имя alias устарело с 8.5; оба современных примера показывают целевой API миграции.

Как читать этот вариант. step получает контекст предыдущего шага, номер строки и два SQL-аргумента. Возвращённые 240 переходят в следующий context, затем получается 590; finalize превращает последнее состояние в итог. Обычный SUM(price*quantity) здесь проще: пример объясняет устройство, которое пригодится для действительно собственного агрегата.

<?php
$db = new Pdo\Sqlite('sqlite::memory:');
$db->createAggregate('weighted_sum',
    fn ($context, $rowNumber, $price, $quantity) => ($context ?? 0) + $price * $quantity,
    fn ($context, $rowCount) => $context ?? 0,
    2
);
echo $db->query('SELECT weighted_sum(price, quantity) FROM (SELECT 120 AS price, 2 AS quantity UNION ALL SELECT 350, 1)')->fetchColumn(), "\n";

590

Как читать этот вариант. Пустая выборка оставляет context=null. finalize явно выбирает итог 0. Это бизнес-решение: среднее по пустому набору, например, логичнее вернуть null, а не делить на ноль.

<?php
$db = new Pdo\Sqlite('sqlite::memory:');
$db->createAggregate('total_units', fn ($sum, $row, $value) => ($sum ?? 0) + $value, fn ($sum, $count) => $sum ?? 0, 1);
echo $db->query('SELECT total_units(value) FROM (SELECT 1 AS value) WHERE 0')->fetchColumn(), "\n";

0

Рядом: Pdo\Sqlite::createFunction().

• PHP: PDO::sqliteCreateAggregate

PHP 8.4+ · PDO; соответствующий драйвер

Pdo\Sqlite::createCollation(string $name, callable $callback): bool

<?php
require __DIR__ . '/catalog.php';
$db->exec('CREATE TABLE shelves (label TEXT NOT NULL)');
$db->exec("INSERT INTO shelves VALUES ('A10'), ('A2'), ('A1')");
$db->createCollation('shelf_order', function ($left, $right) { return strnatcmp($left, $right); });
$statement = $db->query('SELECT label FROM shelves ORDER BY label COLLATE shelf_order');
foreach ($statement as $row) { echo $row['label'], "\n"; }

A1
A2
A10

Задать собственное сравнение строк для COLLATE в SQLite.

$db обозначает соединение, $statement — подготовленную команду и её текущий результат. -> вызывает метод конкретного объекта, :: — статический метод или константу класса. Круглые скобки содержат аргументы; результат справа от = сохраняется в переменной. Это отдельные шаги: выполнить SQL и прочитать полученные строки. Основы: объекты, аргументы и возврат.

true/false. С PHP 8.4 нецелый возврат callback вызывает TypeError вместо прежнего приведения. Callback может переопределить существующее правило; смена смысла collation у индексированных данных требует согласованной перестройки индекса. Встроенная сортировка не вызывает PHP на каждое сравнение; своё правило выбирают ради нужной семантики.

Как читать этот вариант. Обычное текстовое сравнение ставит item10 раньше item2. Callback сравнивает строки естественным порядком, <=> 0 нормализует результат в -1/0/1.

<?php
$db = new Pdo\Sqlite('sqlite::memory:');
$db->createCollation('natural_sku', fn (string $a, string $b): int => strnatcmp($a, $b) <=> 0);
$rows = $db->query("SELECT sku FROM (SELECT 'item10' AS sku UNION ALL SELECT 'item2') ORDER BY sku COLLATE natural_sku")->fetchAll(PDO::FETCH_COLUMN);
echo implode(', ', $rows), "\n";

item2, item10

Как читать этот вариант. Здесь метки ASCII, strlen считает байты. Для человеческих Unicode-названий нужны согласованные правила Unicode/локали, например Collator. Компаратор обязан быть последовательным, иначе сортировка/индексы ненадёжны.

<?php
$db = new Pdo\Sqlite('sqlite::memory:');
$db->createCollation('label_length', function (string $a, string $b): int {
    return (strlen($a) <=> strlen($b)) ?: (strcmp($a, $b) <=> 0);
});
echo implode(', ', $db->query("SELECT label FROM (SELECT 'box' AS label UNION ALL SELECT 'a' UNION ALL SELECT 'pen') ORDER BY label COLLATE label_length")->fetchAll(PDO::FETCH_COLUMN)), "\n";

a, box, pen

Рядом: Pdo\Sqlite::createFunction().

• PHP: Pdo\Sqlite::createCollation

PHP 5.3.11+; устарело с PHP 8.5 · PDO; соответствующий драйвер

PDO::sqliteCreateCollation(string $name, callable $callback): bool

<?php
require __DIR__ . '/catalog.php';
$db->exec('CREATE TABLE shelves (label TEXT NOT NULL)');
$db->exec("INSERT INTO shelves VALUES ('A10'), ('A2'), ('A1')");
$db->createCollation('shelf_order', function ($left, $right) { return strnatcmp($left, $right); });
$statement = $db->query('SELECT label FROM shelves ORDER BY label COLLATE shelf_order');
foreach ($statement as $row) { echo $row['label'], "\n"; }

A1
A2
A10

Задать собственное сравнение строк для COLLATE в SQLite.

$db обозначает соединение, $statement — подготовленную команду и её текущий результат. -> вызывает метод конкретного объекта, :: — статический метод или константу класса. Круглые скобки содержат аргументы; результат справа от = сохраняется в переменной. Это отдельные шаги: выполнить SQL и прочитать полученные строки. Основы: объекты, аргументы и возврат.

true/false. С PHP 8.4 нецелый возврат callback вызывает TypeError вместо прежнего приведения. Callback может переопределить существующее правило; смена смысла collation у индексированных данных требует согласованной перестройки индекса. Встроенная сортировка не вызывает PHP на каждое сравнение; своё правило выбирают ради нужной семантики. Старое имя — deprecated alias с 8.5; примеры показывают замену.

Как читать этот вариант. Обычное текстовое сравнение ставит item10 раньше item2. Callback сравнивает строки естественным порядком, <=> 0 нормализует результат в -1/0/1.

<?php
$db = new Pdo\Sqlite('sqlite::memory:');
$db->createCollation('natural_sku', fn (string $a, string $b): int => strnatcmp($a, $b) <=> 0);
$rows = $db->query("SELECT sku FROM (SELECT 'item10' AS sku UNION ALL SELECT 'item2') ORDER BY sku COLLATE natural_sku")->fetchAll(PDO::FETCH_COLUMN);
echo implode(', ', $rows), "\n";

item2, item10

Как читать этот вариант. Здесь метки ASCII, strlen считает байты. Для человеческих Unicode-названий нужны согласованные правила Unicode/локали, например Collator. Компаратор обязан быть последовательным, иначе сортировка/индексы ненадёжны.

<?php
$db = new Pdo\Sqlite('sqlite::memory:');
$db->createCollation('label_length', function (string $a, string $b): int {
    return (strlen($a) <=> strlen($b)) ?: (strcmp($a, $b) <=> 0);
});
echo implode(', ', $db->query("SELECT label FROM (SELECT 'box' AS label UNION ALL SELECT 'a' UNION ALL SELECT 'pen') ORDER BY label COLLATE label_length")->fetchAll(PDO::FETCH_COLUMN)), "\n";

a, box, pen

Рядом: Pdo\Sqlite::createFunction().

• PHP: PDO::sqliteCreateCollation

PHP 8.4+ · PDO; соответствующий драйвер

Pdo\Sqlite::openBlob(string $table, string $column, int $rowid, ?string $dbname = "main", int $flags = Pdo\Sqlite::OPEN_READONLY): resource|false

<?php
require __DIR__ . '/catalog.php';
$db->exec('CREATE TABLE receipts (id INTEGER PRIMARY KEY, body BLOB NOT NULL)');
$db->exec("INSERT INTO receipts VALUES (1, X'524543454950542023310A')");
$stream = $db->openBlob('receipts', 'body', 1, 'main');
if ($stream === false) { throw new RuntimeException('Квитанция недоступна'); }
echo stream_get_contents($stream);
fclose($stream);

RECEIPT #1

Получить поток к конкретному BLOB SQLite для чтения или изменения по частям.

$db обозначает соединение, $statement — подготовленную команду и её текущий результат. -> вызывает метод конкретного объекта, :: — статический метод или константу класса. Круглые скобки содержат аргументы; результат справа от = сохраняется в переменной. Это отдельные шаги: выполнить SQL и прочитать полученные строки. Основы: объекты, аргументы и возврат.

Поток либо false; ошибка открытия в PHP 8.5.11 сопровождается E_WARNING независимо от режима SQL-ошибок. Размер уже задан: попытка записи за пределы вызывает предупреждение/ошибку потока. Запись разрешена не для каждой SQLite-колонки/таблицы: indexed/PRIMARY KEY/UNIQUE и дочерний foreign key при включённой проверке имеют ограничения; WITHOUT ROWID не подходит. Изменение строки другим UPDATE/DELETE делает открытый blob handle просроченным; для изменения размера сначала меняют значение в SQL, затем открывают новый поток. После работы fclose до завершения связанных операций. Официальная карточка неполная: договор дополнен исходником PHP и SQLite incremental BLOB API, два сценария выполнены локально.

Как читать этот вариант. Поток указывает на BLOB существующей строки с rowid=1. fread прочитал три байта, не потребовав fetchAll всей таблицы. Хранилище данных остаётся SQLite.

<?php
$db = new Pdo\Sqlite('sqlite::memory:');
$db->exec('CREATE TABLE documents (id INTEGER PRIMARY KEY, body BLOB)');
$db->exec("INSERT INTO documents VALUES (1, X'4142434445')");
$stream = $db->openBlob('documents', 'body', 1);
echo fread($stream, 3), "\n";
fclose($stream);

ABC

Как читать этот вариант. zeroblob выделил размер. Поток BLOB позволяет менять байты в существующих границах, а не увеличивать поле как обычный файл; для другого размера нужен SQL UPDATE/новое значение.

<?php
$db = new Pdo\Sqlite('sqlite::memory:');
$db->exec('CREATE TABLE documents (id INTEGER PRIMARY KEY, body BLOB)');
$db->exec('INSERT INTO documents VALUES (1, zeroblob(5))');
$stream = $db->openBlob('documents', 'body', 1, 'main', Pdo\Sqlite::OPEN_READWRITE);
fwrite($stream, 'HELLO');
fclose($stream);
echo $db->query('SELECT hex(body) FROM documents')->fetchColumn(), "\n";

48454C4C4F

Рядом: PDOStatement::bindColumn().

• PHP: Pdo\Sqlite::openBlob

PHP 8.4+; зависит от сборки · PDO; соответствующий драйвер

Pdo\Sqlite::loadExtension(string $name): void

<?php
require __DIR__ . '/catalog.php';
$library = __DIR__ . '/native/report-extension';
if (!is_file($library)) {
    echo "Расширенный отчёт недоступен: библиотека не установлена\n";
} else {
    $db->loadExtension($library);
    echo "Библиотека отчёта подключена\n";
}

Расширенный отчёт недоступен: библиотека не установлена

Подключить установленное доверенное нативное расширение SQLite, когда его возможностей нет в базовой сборке.

$db обозначает соединение, $statement — подготовленную команду и её текущий результат. -> вызывает метод конкретного объекта, :: — статический метод или константу класса. Круглые скобки содержат аргументы; результат справа от = сохраняется в переменной. Это отдельные шаги: выполнить SQL и прочитать полученные строки. Основы: объекты, аргументы и возврат.

Возврата нет. Пустой путь ValueError, недоступная/неподходящая библиотека PDOException; ограничения сборки и многопоточного веб-SAPI также возможны. PHP 8.5.11 временно разрешает загрузку через C API и после отключает, не открывая SQL load_extension(). Не передавайте путь из запроса посетителя. Примеры проверяют отказы; успешная загрузка отдельного стороннего бинарника здесь не заявлена.

Как читать этот вариант. Ничего не загружается: показана проверка аргумента. Возможность метода зависит от сборки PDO_SQLITE_OMIT_LOAD_EXTENSION; на такой сборке метода может не быть.

<?php
$db = new Pdo\Sqlite('sqlite::memory:');
try { $db->loadExtension(''); } catch (ValueError $error) { echo "Нужно имя файла\n"; }

Нужно имя файла

Как читать этот вариант. Файл заведомо отсутствует в изолированном каталоге. В рабочем проекте разрешённый абсолютный путь приходит из конфигурации развёртывания; это загрузка нативного кода в процесс, не установка Composer-пакета.

<?php
$db = new Pdo\Sqlite('sqlite::memory:');
try { $db->loadExtension(__DIR__ . '/missing-extension-library'); } catch (PDOException $error) { echo "Библиотека недоступна\n"; }

Библиотека недоступна

Рядом: Pdo\Sqlite::createFunction().

• PHP: Pdo\Sqlite::loadExtension

PHP 8.5+ · PDO; соответствующий драйвер

Pdo\Sqlite::setAuthorizer(?callable $callback): void

<?php
require __DIR__ . '/catalog.php';
const SQLITE_SELECT_ACTION = 21;
const SQLITE_READ_ACTION = 20;
$db->setAuthorizer(function ($action, $table = null) {
    if ($action === SQLITE_SELECT_ACTION) { return Pdo\Sqlite::OK; }
    if ($action === SQLITE_READ_ACTION && $table === 'products') { return Pdo\Sqlite::OK; }
    return Pdo\Sqlite::DENY;
});
$row = $db->query('SELECT name, stock FROM products WHERE id = 1')->fetch(PDO::FETCH_ASSOC);
echo $row['name'], ' — ', $row['stock'], " шт.\n";
try { $db->exec('DELETE FROM products'); }
catch (Exception $error) { echo "Отчёт не имеет права удалять товары\n"; }
$db->setAuthorizer(null);

Молоток — 8 шт.
Отчёт не имеет права удалять товары

Ограничить действия SQL при подготовке команд SQLite.

$db обозначает соединение, $statement — подготовленную команду и её текущий результат. -> вызывает метод конкретного объекта, :: — статический метод или константу класса. Круглые скобки содержат аргументы; результат справа от = сохраняется в переменной. Это отдельные шаги: выполнить SQL и прочитать полученные строки. Основы: объекты, аргументы и возврат.

На соединении один callback, новая установка заменяет старую. Он вызывается при подготовке и переподготовке, не обязательно на каждой строке/каждом execute. Вернуть OK — разрешить, DENY — отказ команды, IGNORE для чтения — заменить поле null; для DELETE у SQLite другой смысл IGNORE, поэтому не считайте универсальным запретом. Callback не должен менять то же соединение. Не-int даёт TypeError, другой int ValueError при подготовке; метод установки возвращает void. Имена объектов SQLite могут приходить в разном регистре: сравнивайте их без учёта регистра. Коды действий определены SQLite, а константы OK/DENY/IGNORE принадлежат Pdo\Sqlite.

Как читать этот вариант. 11 — документированный код действия SQLITE_DROP_TABLE. Это небольшой пример одного запрета, не готовая безопасная консоль для произвольного SQL: отдельно нужны полный список разрешений, ограничения времени/размера/файлов и прав процесса.

<?php
$db = new Pdo\Sqlite('sqlite::memory:');
$db->exec('CREATE TABLE notes (id INTEGER)');
const SQLITE_DROP_TABLE_ACTION = 11;
$db->setAuthorizer(fn ($action, $a, $b, $database, $trigger) => $action === SQLITE_DROP_TABLE_ACTION ? Pdo\Sqlite::DENY : Pdo\Sqlite::OK);
try { $db->exec('DROP TABLE notes'); } catch (PDOException $error) { echo "Удаление запрещено\n"; }
$db->setAuthorizer(null);
echo $db->query('SELECT COUNT(*) FROM notes')->fetchColumn(), "\n";

Удаление запрещено
0

Как читать этот вариант. Для READ код 20 и аргументы table/column определяют доступ к полю. IGNORE подменяет конкретное чтение null. Авторизация приложения по пользователям/строкам — отдельный уровень: callback не знает автоматически, кто открыл страницу.

<?php
$db = new Pdo\Sqlite('sqlite::memory:');
$db->exec('CREATE TABLE customers (name TEXT, secret TEXT)');
$db->exec("INSERT INTO customers VALUES ('Anna', 'private')");
const SQLITE_READ_ACTION = 20;
$db->setAuthorizer(fn ($action, $table, $column, $database, $trigger) => $action === SQLITE_READ_ACTION && strcasecmp($table ?? '', 'customers') === 0 && strcasecmp($column ?? '', 'secret') === 0 ? Pdo\Sqlite::IGNORE : Pdo\Sqlite::OK);
$row = $db->query('SELECT name, secret FROM customers')->fetch(PDO::FETCH_ASSOC);
echo $row['name'], "\n";
var_dump($row['secret']);

Anna
NULL

Рядом: PDO::prepare().

• PHP: Pdo\Sqlite::setAuthorizer

PHP 5.1+; примеры PHP 8.2+ · PDO; соответствующий драйвер

PDOStatement::getAttribute(int $name): mixed

<?php
require __DIR__ . '/catalog.php';
$statement = $db->prepare('SELECT name, stock FROM products WHERE id = 1');
$readOnly = $statement->getAttribute(Pdo\Sqlite::ATTR_READONLY_STATEMENT);
if (!$readOnly) { throw new RuntimeException('Ожидалась команда чтения'); }
$statement->execute();
$row = $statement->fetch(PDO::FETCH_ASSOC);
echo $row['name'], ' — ', $row['stock'], " шт.\n";

Молоток — 8 шт.

Прочитать драйверную характеристику команды и её результата.

$db обозначает соединение, $statement — подготовленную команду и её текущий результат. -> вызывает метод конкретного объекта, :: — статический метод или константу класса. Круглые скобки содержат аргументы; результат справа от = сохраняется в переменной. Это отдельные шаги: выполнить SQL и прочитать полученные строки. Основы: объекты, аргументы и возврат.

Тип зависит от атрибута; общих универсальных атрибутов у statement нет. Firebird/ODBC ATTR_CURSOR_NAME — имя курсора; PostgreSQL Pdo\Pgsql::ATTR_RESULT_MEMORY_SIZE с 8.4 — байты памяти результата. SQLite имеет READONLY_STATEMENT, BUSY_STATEMENT (8.5), EXPLAIN_STATEMENT (8.5). Неподдерживаемый атрибут сообщает ошибку драйвера; PDO::ATTR_ERRMODE и другие настройки соединения читают у $db, не здесь.

При неудаче SQL-операции режим ERRMODE_SILENT оставляет false и диагностику, ERRMODE_WARNING добавляет E_WARNING, ERRMODE_EXCEPTION выбрасывает PDOException (стандарт с PHP 8.0). Ошибки аргументов и отдельные ошибки состояния могут возникать независимо от этого режима. В примерах режим задан явно; сообщение драйвера не выводится посетителю.

Как читать этот вариант. Это свойство подготовленной SQL-команды. Оно не заменяет авторизацию приложения и не означает отсутствие работы или чтения данных; API специфичен SQLite.

<?php
$db = new PDO('sqlite::memory:', null, null, [PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION]);
$statement = $db->prepare('SELECT 1');
var_dump($statement->getAttribute(Pdo\Sqlite::ATTR_READONLY_STATEMENT));

bool(true)

Как читать этот вариант. Атрибут PHP 8.5 показывает, что statement исполнен и ещё имеет ожидающие строки. Это состояние конкретной команды, не общий уровень нагрузки базы.

<?php
$db = new PDO('sqlite::memory:', null, null, [PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION]);
$statement = $db->query('SELECT 1 UNION ALL SELECT 2');
var_dump($statement->getAttribute(Pdo\Sqlite::ATTR_BUSY_STATEMENT));
$statement->closeCursor();
var_dump($statement->getAttribute(Pdo\Sqlite::ATTR_BUSY_STATEMENT));

bool(true)
bool(false)

Рядом: PDO::getAttribute(), PDOStatement::setAttribute().

• PHP: PDOStatement::getAttribute

PHP 5.1+; примеры PHP 8.2+ · PDO; соответствующий драйвер

PDOStatement::setAttribute(int $attribute, mixed $value): bool

<?php
require __DIR__ . '/catalog.php';
$statement = $db->prepare('SELECT name, stock FROM products WHERE id = 1');
$statement->setAttribute(Pdo\Sqlite::ATTR_EXPLAIN_STATEMENT, Pdo\Sqlite::EXPLAIN_MODE_EXPLAIN_QUERY_PLAN);
$statement->execute();
$plan = $statement->fetch(PDO::FETCH_ASSOC);
echo str_contains($plan['detail'], 'SEARCH') ? "Поиск по ключу\n" : "Проверьте план чтения\n";
$statement->closeCursor();
$statement->setAttribute(Pdo\Sqlite::ATTR_EXPLAIN_STATEMENT, Pdo\Sqlite::EXPLAIN_MODE_PREPARED);
$statement->execute();
$row = $statement->fetch(PDO::FETCH_ASSOC);
echo $row['name'], ' — ', $row['stock'], " шт.\n";

Поиск по ключу
Молоток — 8 шт.

Изменить драйверную настройку конкретного statement.

$db обозначает соединение, $statement — подготовленную команду и её текущий результат. -> вызывает метод конкретного объекта, :: — статический метод или константу класса. Круглые скобки содержат аргументы; результат справа от = сохраняется в переменной. Это отдельные шаги: выполнить SQL и прочитать полученные строки. Основы: объекты, аргументы и возврат.

true/false. В PHP 8.5 слишком длинное имя Firebird-курсора вызывает ValueError. SQLite EXPLAIN требует libsqlite >=3.43.0, иначе ValueError; доступные режимы PREPARED/EXPLAIN/EXPLAIN_QUERY_PLAN. Методы не устанавливают общие параметры соединения: ERRMODE, AUTOCOMMIT и прочие задают через PDO::setAttribute. Имя курсора применяют к WHERE CURRENT OF только в поддерживающей это СУБД.

При неудаче SQL-операции режим ERRMODE_SILENT оставляет false и диагностику, ERRMODE_WARNING добавляет E_WARNING, ERRMODE_EXCEPTION выбрасывает PDOException (стандарт с PHP 8.0). Ошибки аргументов и отдельные ошибки состояния могут возникать независимо от этого режима. В примерах режим задан явно; сообщение драйвера не выводится посетителю.

Как читать этот вариант. PHP 8.5 и libsqlite не старше 3.43.0. План описывает способ выполнения, не найденный товар; текст detail зависит от SQLite и не фиксируется здесь как стабильная строка.

<?php
$db = new PDO('sqlite::memory:', null, null, [PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION]);
$db->exec('CREATE TABLE products (id INTEGER PRIMARY KEY, name TEXT)');
$statement = $db->prepare('SELECT name FROM products WHERE id = 1');
$statement->setAttribute(Pdo\Sqlite::ATTR_EXPLAIN_STATEMENT, Pdo\Sqlite::EXPLAIN_MODE_EXPLAIN_QUERY_PLAN);
$statement->execute();
$row = $statement->fetch(PDO::FETCH_ASSOC);
var_dump(isset($row['detail']));

bool(true)

Как читать этот вариант. PREPARED возвращает исполнение исходного SQL. EXPLAIN выдаёт инструкции виртуальной машины, QUERY_PLAN — высокоуровневый план; это различные диагностические результаты.

<?php
$db = new PDO('sqlite::memory:', null, null, [PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION]);
$statement = $db->prepare('SELECT 42 AS answer');
$statement->setAttribute(Pdo\Sqlite::ATTR_EXPLAIN_STATEMENT, Pdo\Sqlite::EXPLAIN_MODE_EXPLAIN);
$statement->setAttribute(Pdo\Sqlite::ATTR_EXPLAIN_STATEMENT, Pdo\Sqlite::EXPLAIN_MODE_PREPARED);
$statement->execute();
echo $statement->fetchColumn(), "\n";

42

Рядом: PDOStatement::getAttribute(), PDO::setAttribute().

• PHP: PDOStatement::setAttribute

PHP 5.1+; примеры PHP 8.2+ · PDO; соответствующий драйвер

PDOStatement::nextRowset(): bool

<?php
require __DIR__ . '/catalog.php';
$statement = $db->query('SELECT name, stock FROM products ORDER BY id; SELECT COUNT(*) AS total FROM products');
foreach ($statement->fetchAll(PDO::FETCH_ASSOC) as $row) { echo $row['name'], ' — ', $row['stock'], " шт.\n"; }
if (!$statement->nextRowset()) { throw new RuntimeException('Итоговый набор отсутствует'); }
echo 'Всего позиций: ', $statement->fetchColumn(), "\n";
$statement->closeCursor();

Молоток — 8 шт.
Перчатки — 15 шт.
Кисть — 0 шт.
Всего позиций: 3

Перейти к следующему набору строк, возвращённому процедурой или составной командой.

$db обозначает соединение, $statement — подготовленную команду и её текущий результат. -> вызывает метод конкретного объекта, :: — статический метод или константу класса. Круглые скобки содержат аргументы; результат справа от = сохраняется в переменной. Это отдельные шаги: выполнить SQL и прочитать полученные строки. Основы: объекты, аргументы и возврат.

true при переходе, false при отсутствии следующего/неудаче (ERRMODE может выбросить исключение). Каждый набор может иметь собственные колонки; заново проверяйте columnCount/метаданные. Это следующий result set, не следующая строка и не следующая страница SQL LIMIT. Поддержка зависит от сервера/драйвера; SQLite не превращает пакет SQL в такой переносимый API.

При неудаче SQL-операции режим ERRMODE_SILENT оставляет false и диагностику, ERRMODE_WARNING добавляет E_WARNING, ERRMODE_EXCEPTION выбрасывает PDOException (стандарт с PHP 8.0). Ошибки аргументов и отдельные ошибки состояния могут возникать независимо от этого режима. В примерах режим задан явно; сообщение драйвера не выводится посетителю.

Как читать этот вариант. Это контекст MySQL и доверенный фиксированный SQL. Локально выполнена только проверка синтаксиса, сервера MySQL нет. Возможность multiple statements задаётся драйвером; не включайте её ради пользовательской склейки SQL.

<?php
$db = new PDO(getenv('MYSQL_DSN'), getenv('MYSQL_USER'), getenv('MYSQL_PASSWORD'), [PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION]);
$statement = $db->query("SELECT 'orders' AS label; SELECT 'totals' AS label");
echo $statement->fetchColumn(), "\n";
if ($statement->nextRowset()) { echo $statement->fetchColumn(), "\n"; }
$statement->closeCursor();

При PDO_MYSQL с разрешёнными multiple statements: orders
totals

Как читать этот вариант. Требуются установленная процедура, pdo_mysql, сервер и согласованная схема; пример только lint. У разных наборов может быть разная форма. Потребление/закрытие всех наборов предотвращает ошибки следующей команды на занятом соединении.

<?php
$db = new PDO(getenv('MYSQL_DSN'), getenv('MYSQL_USER'), getenv('MYSQL_PASSWORD'), [PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION]);
$statement = $db->prepare('CALL report_orders(?)');
$statement->execute([42]);
try {
    do {
        if ($statement->columnCount() > 0) {
            while (($row = $statement->fetch(PDO::FETCH_ASSOC)) !== false) {
                echo json_encode($row, JSON_THROW_ON_ERROR), "\n";
            }
        }
    } while ($statement->nextRowset());
} finally { $statement->closeCursor(); }

Строки каждого набора процедуры report_orders для клиента 42, по JSON на строку.

Рядом: PDOStatement::fetch(), PDOStatement::columnCount(), PDOStatement::closeCursor().

• PHP: PDOStatement::nextRowset

PHP 8.4+; отдельные изменения отмечены · PDO; соответствующий драйвер

Pdo\Pgsql::copyFromArray(string $tableName, array|Traversable $rows, string $separator = "\t", string $nullAs = "\\N", ?string $fields = null): bool

<?php
require __DIR__ . '/catalog.php';
$lines = ['4|Отвёртка|4', '5|Рулетка|6'];
$db->copyFromArray('products', $lines, '|', '\\N', 'id,name,stock');
$statement = $db->query('SELECT name, stock FROM products WHERE id >= 4 ORDER BY id');
foreach ($statement as $row) { echo $row['name'], ' — ', $row['stock'], " шт.\n"; }

Отвёртка — 4 шт.
Рулетка — 6 шт.

Быстро передать пакет записей PostgreSQL через протокол COPY.

$db обозначает соединение, $statement — подготовленную команду и её текущий результат. -> вызывает метод конкретного объекта, :: — статический метод или константу класса. Круглые скобки содержат аргументы; результат справа от = сохраняется в переменной. Это отдельные шаги: выполнить SQL и прочитать полученные строки. Основы: объекты, аргументы и возврат.

true/false; SQL и I/O ошибки подчиняются ERRMODE. COPY text — отдельный формат: строку с табуляцией нельзя безопасно получить обычным implode, а CSV-кавычки не являются его экранированием. Для небольшого импорта параметризованный INSERT проще; при большом объёме COPY сокращает накладные расходы отдельных команд. Валидацию и транзакцию импорта продумывают отдельно.

При неудаче SQL-операции режим ERRMODE_SILENT оставляет false и диагностику, ERRMODE_WARNING добавляет E_WARNING, ERRMODE_EXCEPTION выбрасывает PDOException (стандарт с PHP 8.0). Ошибки аргументов и отдельные ошибки состояния могут возникать независимо от этого режима. В примерах режим задан явно; сообщение драйвера не выводится посетителю.

Как читать этот вариант. Контекстный пример: требуется PostgreSQL, pdo_pgsql и доверенные PG_DSN/PG_USER/PG_PASSWORD. Здесь проверен синтаксис PHP, запрос к серверу не выполнялся. Временная таблица относится к учебному соединению. Поля фиксированные и не содержат спецсимволов COPY; для внешнего текста требуется кодирование обратного слеша, табуляций, переводов строк и NULL по формату COPY.

<?php
$db = new Pdo\Pgsql(getenv('PG_DSN'), getenv('PG_USER'), getenv('PG_PASSWORD'), [PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION]);
$db->exec('CREATE TEMP TABLE import_items (id integer, name text)');
$db->copyFromArray('import_items', ["1\tPen", "2\tBox"]);
echo $db->query('SELECT COUNT(*) FROM import_items')->fetchColumn(), "\n";

2

Как читать этот вариант. Контекстный пример: требуется PostgreSQL, pdo_pgsql и доверенные PG_DSN/PG_USER/PG_PASSWORD. Здесь проверен синтаксис PHP, запрос к серверу не выполнялся. Generator не собирает полный PHP-массив всех строк. Это уменьшает один источник затрат памяти, но не освобождает от ограничений БД и обработки ошибки загрузки. В PHP 8.4 нужен массив, Traversable добавлен в 8.5.

<?php
$db = new Pdo\Pgsql(getenv('PG_DSN'), getenv('PG_USER'), getenv('PG_PASSWORD'), [PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION]);
$db->exec('CREATE TEMP TABLE import_items (id integer, name text)');
function importRows(): Generator {
    yield "1\tPen";
    yield "2\tBox";
}
$db->copyFromArray('import_items', importRows());
echo $db->query('SELECT COUNT(*) FROM import_items')->fetchColumn(), "\n";

2

Рядом: PDO::prepare().

• PHP: Pdo\Pgsql::copyFromArray

PHP 5.1+; старое имя deprecated с PHP 8.5 · PDO; соответствующий драйвер

PDO::pgsqlCopyFromArray(string $tableName, array|Traversable $rows, string $separator = "\t", string $nullAs = "\\N", ?string $fields = null): bool

<?php
require __DIR__ . '/catalog.php';
$lines = ['4|Отвёртка|4', '5|Рулетка|6'];
$db->copyFromArray('products', $lines, '|', '\\N', 'id,name,stock');
$statement = $db->query('SELECT name, stock FROM products WHERE id >= 4 ORDER BY id');
foreach ($statement as $row) { echo $row['name'], ' — ', $row['stock'], " шт.\n"; }

Отвёртка — 4 шт.
Рулетка — 6 шт.

Быстро передать пакет записей PostgreSQL через протокол COPY. Историческое имя.

$db обозначает соединение, $statement — подготовленную команду и её текущий результат. -> вызывает метод конкретного объекта, :: — статический метод или константу класса. Круглые скобки содержат аргументы; результат справа от = сохраняется в переменной. Это отдельные шаги: выполнить SQL и прочитать полученные строки. Основы: объекты, аргументы и возврат.

true/false; SQL и I/O ошибки подчиняются ERRMODE. COPY text — отдельный формат: строку с табуляцией нельзя безопасно получить обычным implode, а CSV-кавычки не являются его экранированием. Для небольшого импорта параметризованный INSERT проще; при большом объёме COPY сокращает накладные расходы отдельных команд. Валидацию и транзакцию импорта продумывают отдельно. С PHP 8.5 старый метод deprecated. Для миграции создайте Pdo\Pgsql (или PDO::connect) и используйте copyFromArray; два примера показывают этот целевой API. Простой new PDO по-прежнему создаёт базовый класс.

При неудаче SQL-операции режим ERRMODE_SILENT оставляет false и диагностику, ERRMODE_WARNING добавляет E_WARNING, ERRMODE_EXCEPTION выбрасывает PDOException (стандарт с PHP 8.0). Ошибки аргументов и отдельные ошибки состояния могут возникать независимо от этого режима. В примерах режим задан явно; сообщение драйвера не выводится посетителю.

Как читать этот вариант. Контекстный пример: требуется PostgreSQL, pdo_pgsql и доверенные PG_DSN/PG_USER/PG_PASSWORD. Здесь проверен синтаксис PHP, запрос к серверу не выполнялся. Временная таблица относится к учебному соединению. Поля фиксированные и не содержат спецсимволов COPY; для внешнего текста требуется кодирование обратного слеша, табуляций, переводов строк и NULL по формату COPY.

<?php
$db = new Pdo\Pgsql(getenv('PG_DSN'), getenv('PG_USER'), getenv('PG_PASSWORD'), [PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION]);
$db->exec('CREATE TEMP TABLE import_items (id integer, name text)');
$db->copyFromArray('import_items', ["1\tPen", "2\tBox"]);
echo $db->query('SELECT COUNT(*) FROM import_items')->fetchColumn(), "\n";

2

Как читать этот вариант. Контекстный пример: требуется PostgreSQL, pdo_pgsql и доверенные PG_DSN/PG_USER/PG_PASSWORD. Здесь проверен синтаксис PHP, запрос к серверу не выполнялся. Generator не собирает полный PHP-массив всех строк. Это уменьшает один источник затрат памяти, но не освобождает от ограничений БД и обработки ошибки загрузки. В PHP 8.4 нужен массив, Traversable добавлен в 8.5.

<?php
$db = new Pdo\Pgsql(getenv('PG_DSN'), getenv('PG_USER'), getenv('PG_PASSWORD'), [PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION]);
$db->exec('CREATE TEMP TABLE import_items (id integer, name text)');
function importRows(): Generator {
    yield "1\tPen";
    yield "2\tBox";
}
$db->copyFromArray('import_items', importRows());
echo $db->query('SELECT COUNT(*) FROM import_items')->fetchColumn(), "\n";

2

Рядом: Pdo\Pgsql::copyFromArray(), PDO::prepare().

• PHP: PDO::pgsqlCopyFromArray

PHP 8.4+; отдельные изменения отмечены · PDO; соответствующий драйвер

Pdo\Pgsql::copyFromFile(string $tableName, string $filename, string $separator = "\t", string $nullAs = "\\N", ?string $fields = null): bool

<?php
require __DIR__ . '/catalog.php';
$file = __DIR__ . '/incoming.txt';
$db->copyFromFile('products', $file, '|', '\\N', 'id,name,stock');
$statement = $db->query('SELECT name, stock FROM products WHERE id >= 4 ORDER BY id');
foreach ($statement as $row) { echo $row['name'], ' — ', $row['stock'], " шт.\n"; }

Отвёртка — 4 шт.
Рулетка — 6 шт.

Загрузить подготовленный локальный файл в таблицу PostgreSQL.

$db обозначает соединение, $statement — подготовленную команду и её текущий результат. -> вызывает метод конкретного объекта, :: — статический метод или константу класса. Круглые скобки содержат аргументы; результат справа от = сохраняется в переменной. Это отдельные шаги: выполнить SQL и прочитать полученные строки. Основы: объекты, аргументы и возврат.

true/false. Недоступный для чтения файл сообщает ошибку через ERRMODE, при EXCEPTION — PDOException. Источник должен уже соответствовать COPY text; CSV/XLSX/JSON сначала преобразуют с правильным кодированием. Имена таблицы/колонок задают доверенно, файл с персональными данными удаляют по политике проекта после обработки.

При неудаче SQL-операции режим ERRMODE_SILENT оставляет false и диагностику, ERRMODE_WARNING добавляет E_WARNING, ERRMODE_EXCEPTION выбрасывает PDOException (стандарт с PHP 8.0). Ошибки аргументов и отдельные ошибки состояния могут возникать независимо от этого режима. В примерах режим задан явно; сообщение драйвера не выводится посетителю.

Как читать этот вариант. Контекстный пример: требуется PostgreSQL, pdo_pgsql и доверенные PG_DSN/PG_USER/PG_PASSWORD. Здесь проверен синтаксис PHP, запрос к серверу не выполнялся. Путь принадлежит процессу приложения. Это не SQL COPY FROM filename, которому требовался бы файл на машине сервера. Для реального импорта выбирайте свой временный каталог и лимит размера файла.

<?php
$db = new Pdo\Pgsql(getenv('PG_DSN'), getenv('PG_USER'), getenv('PG_PASSWORD'), [PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION]);
$db->exec('CREATE TEMP TABLE import_items (id integer, name text)');
$path = __DIR__ . '/import.tsv';
file_put_contents($path, "1\tPen\n2\tBox\n");
$db->copyFromFile('import_items', $path);
echo $db->query('SELECT COUNT(*) FROM import_items')->fetchColumn(), "\n";

2

Как читать этот вариант. Контекстный пример: требуется PostgreSQL, pdo_pgsql и доверенные PG_DSN/PG_USER/PG_PASSWORD. Здесь проверен синтаксис PHP, запрос к серверу не выполнялся. Пример показывает общую границу транзакции. Один счётчик не проверяет содержимое: боевой импорт дополнительно проверяет ключи, типы, связи, дубли и допустимые значения.

<?php
$db = new Pdo\Pgsql(getenv('PG_DSN'), getenv('PG_USER'), getenv('PG_PASSWORD'), [PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION]);
$db->exec('CREATE TEMP TABLE import_items (id integer, name text)');
file_put_contents(__DIR__ . '/batch.tsv', "1\tPen\n");
$db->beginTransaction();
try {
    $db->copyFromFile('import_items', __DIR__ . '/batch.tsv');
    $count = (int) $db->query('SELECT COUNT(*) FROM import_items')->fetchColumn();
    if ($count !== 1) { throw new RuntimeException('Неполный пакет'); }
    $db->commit();
    echo "Пакет принят\n";
} catch (Throwable $error) {
    if ($db->inTransaction()) { $db->rollBack(); }
    throw $error;
}

Пакет принят

Рядом: Pdo\Pgsql::copyFromArray(), Pdo\Pgsql::copyToFile().

• PHP: Pdo\Pgsql::copyFromFile

PHP 5.1+; старое имя deprecated с PHP 8.5 · PDO; соответствующий драйвер

PDO::pgsqlCopyFromFile(string $tableName, string $filename, string $separator = "\t", string $nullAs = "\\N", ?string $fields = null): bool

<?php
require __DIR__ . '/catalog.php';
$file = __DIR__ . '/incoming.txt';
$db->copyFromFile('products', $file, '|', '\\N', 'id,name,stock');
$statement = $db->query('SELECT name, stock FROM products WHERE id >= 4 ORDER BY id');
foreach ($statement as $row) { echo $row['name'], ' — ', $row['stock'], " шт.\n"; }

Отвёртка — 4 шт.
Рулетка — 6 шт.

Загрузить подготовленный локальный файл в таблицу PostgreSQL. Историческое имя.

$db обозначает соединение, $statement — подготовленную команду и её текущий результат. -> вызывает метод конкретного объекта, :: — статический метод или константу класса. Круглые скобки содержат аргументы; результат справа от = сохраняется в переменной. Это отдельные шаги: выполнить SQL и прочитать полученные строки. Основы: объекты, аргументы и возврат.

true/false. Недоступный для чтения файл сообщает ошибку через ERRMODE, при EXCEPTION — PDOException. Источник должен уже соответствовать COPY text; CSV/XLSX/JSON сначала преобразуют с правильным кодированием. Имена таблицы/колонок задают доверенно, файл с персональными данными удаляют по политике проекта после обработки. С PHP 8.5 старый метод deprecated. Для миграции создайте Pdo\Pgsql (или PDO::connect) и используйте copyFromFile; два примера показывают этот целевой API. Простой new PDO по-прежнему создаёт базовый класс.

При неудаче SQL-операции режим ERRMODE_SILENT оставляет false и диагностику, ERRMODE_WARNING добавляет E_WARNING, ERRMODE_EXCEPTION выбрасывает PDOException (стандарт с PHP 8.0). Ошибки аргументов и отдельные ошибки состояния могут возникать независимо от этого режима. В примерах режим задан явно; сообщение драйвера не выводится посетителю.

Как читать этот вариант. Контекстный пример: требуется PostgreSQL, pdo_pgsql и доверенные PG_DSN/PG_USER/PG_PASSWORD. Здесь проверен синтаксис PHP, запрос к серверу не выполнялся. Путь принадлежит процессу приложения. Это не SQL COPY FROM filename, которому требовался бы файл на машине сервера. Для реального импорта выбирайте свой временный каталог и лимит размера файла.

<?php
$db = new Pdo\Pgsql(getenv('PG_DSN'), getenv('PG_USER'), getenv('PG_PASSWORD'), [PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION]);
$db->exec('CREATE TEMP TABLE import_items (id integer, name text)');
$path = __DIR__ . '/import.tsv';
file_put_contents($path, "1\tPen\n2\tBox\n");
$db->copyFromFile('import_items', $path);
echo $db->query('SELECT COUNT(*) FROM import_items')->fetchColumn(), "\n";

2

Как читать этот вариант. Контекстный пример: требуется PostgreSQL, pdo_pgsql и доверенные PG_DSN/PG_USER/PG_PASSWORD. Здесь проверен синтаксис PHP, запрос к серверу не выполнялся. Пример показывает общую границу транзакции. Один счётчик не проверяет содержимое: боевой импорт дополнительно проверяет ключи, типы, связи, дубли и допустимые значения.

<?php
$db = new Pdo\Pgsql(getenv('PG_DSN'), getenv('PG_USER'), getenv('PG_PASSWORD'), [PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION]);
$db->exec('CREATE TEMP TABLE import_items (id integer, name text)');
file_put_contents(__DIR__ . '/batch.tsv', "1\tPen\n");
$db->beginTransaction();
try {
    $db->copyFromFile('import_items', __DIR__ . '/batch.tsv');
    $count = (int) $db->query('SELECT COUNT(*) FROM import_items')->fetchColumn();
    if ($count !== 1) { throw new RuntimeException('Неполный пакет'); }
    $db->commit();
    echo "Пакет принят\n";
} catch (Throwable $error) {
    if ($db->inTransaction()) { $db->rollBack(); }
    throw $error;
}

Пакет принят

Рядом: Pdo\Pgsql::copyFromFile(), Pdo\Pgsql::copyFromArray(), Pdo\Pgsql::copyToFile().

• PHP: PDO::pgsqlCopyFromFile

PHP 8.4+; отдельные изменения отмечены · PDO; соответствующий драйвер

Pdo\Pgsql::copyToArray(string $tableName, string $separator = "\t", string $nullAs = "\\N", ?string $fields = null): array|false

<?php
require __DIR__ . '/catalog.php';
$lines = $db->copyToArray('products', '|', '\\N', 'name,stock');
if ($lines === false) { throw new RuntimeException('Выгрузка не получена'); }
$lines = array_map('rtrim', $lines);
sort($lines, SORT_STRING);
foreach ($lines as $line) { echo $line, "\n"; }

Кисть|0
Молоток|8
Перчатки|15

Выгрузить таблицу как массив строк PostgreSQL COPY text.

$db обозначает соединение, $statement — подготовленную команду и её текущий результат. -> вызывает метод конкретного объекта, :: — статический метод или константу класса. Круглые скобки содержат аргументы; результат справа от = сохраняется в переменной. Это отдельные шаги: выполнить SQL и прочитать полученные строки. Основы: объекты, аргументы и возврат.

Массив строк либо false. Весь экспорт хранится в памяти PHP; для большого объёма copyToFile или последовательное чтение SELECT удобнее. Разделитель и маркер NULL должны совпадать у импортёра; формат не становится CSV от смены разделителя на запятую.

При неудаче SQL-операции режим ERRMODE_SILENT оставляет false и диагностику, ERRMODE_WARNING добавляет E_WARNING, ERRMODE_EXCEPTION выбрасывает PDOException (стандарт с PHP 8.0). Ошибки аргументов и отдельные ошибки состояния могут возникать независимо от этого режима. В примерах режим задан явно; сообщение драйвера не выводится посетителю.

Как читать этот вариант. Контекстный пример: требуется PostgreSQL, pdo_pgsql и доверенные PG_DSN/PG_USER/PG_PASSWORD. Здесь проверен синтаксис PHP, запрос к серверу не выполнялся. Массив содержит строки COPY text, а не [id=>1,name=>Pen]. При декодировании учитывают backslash-экранирование, а не просто explode для произвольных данных.

<?php
$db = new Pdo\Pgsql(getenv('PG_DSN'), getenv('PG_USER'), getenv('PG_PASSWORD'), [PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION]);
$db->exec('CREATE TEMP TABLE export_items (id integer, name text)');
$db->exec("INSERT INTO export_items VALUES (1, 'Pen')");
$rows = $db->copyToArray('export_items');
echo count($rows), "\n";
echo rtrim($rows[0], "\r\n"), "\n";

1
1	Pen

Как читать этот вариант. Контекстный пример: требуется PostgreSQL, pdo_pgsql и доверенные PG_DSN/PG_USER/PG_PASSWORD. Здесь проверен синтаксис PHP, запрос к серверу не выполнялся. fields ограничивает состав экспорта. Это удобнее и безопаснее, чем выгрузить все колонки и надеяться удалить закрытое поле потом. Порядок строк без явного SQL ORDER BY не гарантирован.

<?php
$db = new Pdo\Pgsql(getenv('PG_DSN'), getenv('PG_USER'), getenv('PG_PASSWORD'), [PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION]);
$db->exec('CREATE TEMP TABLE export_items (id integer, name text, internal_note text)');
$db->exec("INSERT INTO export_items VALUES (1, 'Pen', 'private')");
$rows = $db->copyToArray('export_items', "\t", '\N', 'id,name');
echo rtrim($rows[0], "\r\n"), "\n";

1	Pen

Рядом: Pdo\Pgsql::copyToFile(), PDOStatement::fetch().

• PHP: Pdo\Pgsql::copyToArray

PHP 5.1+; старое имя deprecated с PHP 8.5 · PDO; соответствующий драйвер

PDO::pgsqlCopyToArray(string $tableName, string $separator = "\t", string $nullAs = "\\N", ?string $fields = null): array|false

<?php
require __DIR__ . '/catalog.php';
$lines = $db->copyToArray('products', '|', '\\N', 'name,stock');
if ($lines === false) { throw new RuntimeException('Выгрузка не получена'); }
$lines = array_map('rtrim', $lines);
sort($lines, SORT_STRING);
foreach ($lines as $line) { echo $line, "\n"; }

Кисть|0
Молоток|8
Перчатки|15

Выгрузить таблицу как массив строк PostgreSQL COPY text. Историческое имя.

$db обозначает соединение, $statement — подготовленную команду и её текущий результат. -> вызывает метод конкретного объекта, :: — статический метод или константу класса. Круглые скобки содержат аргументы; результат справа от = сохраняется в переменной. Это отдельные шаги: выполнить SQL и прочитать полученные строки. Основы: объекты, аргументы и возврат.

Массив строк либо false. Весь экспорт хранится в памяти PHP; для большого объёма copyToFile или последовательное чтение SELECT удобнее. Разделитель и маркер NULL должны совпадать у импортёра; формат не становится CSV от смены разделителя на запятую. С PHP 8.5 старый метод deprecated. Для миграции создайте Pdo\Pgsql (или PDO::connect) и используйте copyToArray; два примера показывают этот целевой API. Простой new PDO по-прежнему создаёт базовый класс.

При неудаче SQL-операции режим ERRMODE_SILENT оставляет false и диагностику, ERRMODE_WARNING добавляет E_WARNING, ERRMODE_EXCEPTION выбрасывает PDOException (стандарт с PHP 8.0). Ошибки аргументов и отдельные ошибки состояния могут возникать независимо от этого режима. В примерах режим задан явно; сообщение драйвера не выводится посетителю.

Как читать этот вариант. Контекстный пример: требуется PostgreSQL, pdo_pgsql и доверенные PG_DSN/PG_USER/PG_PASSWORD. Здесь проверен синтаксис PHP, запрос к серверу не выполнялся. Массив содержит строки COPY text, а не [id=>1,name=>Pen]. При декодировании учитывают backslash-экранирование, а не просто explode для произвольных данных.

<?php
$db = new Pdo\Pgsql(getenv('PG_DSN'), getenv('PG_USER'), getenv('PG_PASSWORD'), [PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION]);
$db->exec('CREATE TEMP TABLE export_items (id integer, name text)');
$db->exec("INSERT INTO export_items VALUES (1, 'Pen')");
$rows = $db->copyToArray('export_items');
echo count($rows), "\n";
echo rtrim($rows[0], "\r\n"), "\n";

1
1	Pen

Как читать этот вариант. Контекстный пример: требуется PostgreSQL, pdo_pgsql и доверенные PG_DSN/PG_USER/PG_PASSWORD. Здесь проверен синтаксис PHP, запрос к серверу не выполнялся. fields ограничивает состав экспорта. Это удобнее и безопаснее, чем выгрузить все колонки и надеяться удалить закрытое поле потом. Порядок строк без явного SQL ORDER BY не гарантирован.

<?php
$db = new Pdo\Pgsql(getenv('PG_DSN'), getenv('PG_USER'), getenv('PG_PASSWORD'), [PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION]);
$db->exec('CREATE TEMP TABLE export_items (id integer, name text, internal_note text)');
$db->exec("INSERT INTO export_items VALUES (1, 'Pen', 'private')");
$rows = $db->copyToArray('export_items', "\t", '\N', 'id,name');
echo rtrim($rows[0], "\r\n"), "\n";

1	Pen

Рядом: Pdo\Pgsql::copyToArray(), Pdo\Pgsql::copyToFile(), PDOStatement::fetch().

• PHP: PDO::pgsqlCopyToArray

PHP 8.4+; отдельные изменения отмечены · PDO; соответствующий драйвер

Pdo\Pgsql::copyToFile(string $tableName, string $filename, string $separator = "\t", string $nullAs = "\\N", ?string $fields = null): bool

<?php
require __DIR__ . '/catalog.php';
$file = __DIR__ . '/catalog-export.txt';
$db->copyToFile('products', $file, '|', '\\N', 'name,stock');
$lines = file($file, FILE_IGNORE_NEW_LINES);
if ($lines === false) { throw new RuntimeException('Выгрузка не получена'); }
$lines = array_map('rtrim', $lines);
sort($lines, SORT_STRING);
foreach ($lines as $line) { echo $line, "\n"; }

Кисть|0
Молоток|8
Перчатки|15

Экспортировать COPY text в локальный файл без массива всех строк.

$db обозначает соединение, $statement — подготовленную команду и её текущий результат. -> вызывает метод конкретного объекта, :: — статический метод или константу класса. Круглые скобки содержат аргументы; результат справа от = сохраняется в переменной. Это отдельные шаги: выполнить SQL и прочитать полученные строки. Основы: объекты, аргументы и возврат.

true/false. Ошибка открытия/записи файла проходит через ERRMODE. Успешное создание не проверяет чужой последующий импорт. Размер, права, место на диске, закрытые колонки и срок хранения — часть экспортной задачи; при отказе частичный файл не следует считать готовым.

При неудаче SQL-операции режим ERRMODE_SILENT оставляет false и диагностику, ERRMODE_WARNING добавляет E_WARNING, ERRMODE_EXCEPTION выбрасывает PDOException (стандарт с PHP 8.0). Ошибки аргументов и отдельные ошибки состояния могут возникать независимо от этого режима. В примерах режим задан явно; сообщение драйвера не выводится посетителю.

Как читать этот вариант. Контекстный пример: требуется PostgreSQL, pdo_pgsql и доверенные PG_DSN/PG_USER/PG_PASSWORD. Здесь проверен синтаксис PHP, запрос к серверу не выполнялся. Нужны права записи каталога PHP. Создание файла и его выдача пользователю — разные шаги; для веб-выдачи сначала проверяют доступ к выгрузке.

<?php
$db = new Pdo\Pgsql(getenv('PG_DSN'), getenv('PG_USER'), getenv('PG_PASSWORD'), [PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION]);
$db->exec('CREATE TEMP TABLE export_items (id integer, name text)');
$db->exec("INSERT INTO export_items VALUES (1, 'Pen')");
$path = __DIR__ . '/export.tsv';
$db->copyToFile('export_items', $path);
echo rtrim(file_get_contents($path), "\r\n"), "\n";

1	Pen

Как читать этот вариант. Контекстный пример: требуется PostgreSQL, pdo_pgsql и доверенные PG_DSN/PG_USER/PG_PASSWORD. Здесь проверен синтаксис PHP, запрос к серверу не выполнялся. Соседний временный файл помогает не отдавать незавершённый результат под финальным именем. В рабочем каталоге нужны уникальные имена, политика существующего файла и учёт семантики rename ОС/файловой системы.

<?php
$db = new Pdo\Pgsql(getenv('PG_DSN'), getenv('PG_USER'), getenv('PG_PASSWORD'), [PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION]);
$db->exec('CREATE TEMP TABLE export_items (id integer, name text)');
$db->exec("INSERT INTO export_items VALUES (1, 'Pen')");
$temp = __DIR__ . '/export.part';
$ready = __DIR__ . '/export.tsv';
if (!$db->copyToFile('export_items', $temp)) { throw new RuntimeException('Экспорт не завершён'); }
if (!rename($temp, $ready)) { throw new RuntimeException('Не удалось опубликовать файл'); }
echo "Файл готов\n";

Файл готов

Рядом: Pdo\Pgsql::copyToArray(), Pdo\Pgsql::copyFromFile().

• PHP: Pdo\Pgsql::copyToFile

PHP 5.1+; старое имя deprecated с PHP 8.5 · PDO; соответствующий драйвер

PDO::pgsqlCopyToFile(string $tableName, string $filename, string $separator = "\t", string $nullAs = "\\N", ?string $fields = null): bool

<?php
require __DIR__ . '/catalog.php';
$file = __DIR__ . '/catalog-export.txt';
$db->copyToFile('products', $file, '|', '\\N', 'name,stock');
$lines = file($file, FILE_IGNORE_NEW_LINES);
if ($lines === false) { throw new RuntimeException('Выгрузка не получена'); }
$lines = array_map('rtrim', $lines);
sort($lines, SORT_STRING);
foreach ($lines as $line) { echo $line, "\n"; }

Кисть|0
Молоток|8
Перчатки|15

Экспортировать COPY text в локальный файл без массива всех строк. Историческое имя.

$db обозначает соединение, $statement — подготовленную команду и её текущий результат. -> вызывает метод конкретного объекта, :: — статический метод или константу класса. Круглые скобки содержат аргументы; результат справа от = сохраняется в переменной. Это отдельные шаги: выполнить SQL и прочитать полученные строки. Основы: объекты, аргументы и возврат.

true/false. Ошибка открытия/записи файла проходит через ERRMODE. Успешное создание не проверяет чужой последующий импорт. Размер, права, место на диске, закрытые колонки и срок хранения — часть экспортной задачи; при отказе частичный файл не следует считать готовым. С PHP 8.5 старый метод deprecated. Для миграции создайте Pdo\Pgsql (или PDO::connect) и используйте copyToFile; два примера показывают этот целевой API. Простой new PDO по-прежнему создаёт базовый класс.

При неудаче SQL-операции режим ERRMODE_SILENT оставляет false и диагностику, ERRMODE_WARNING добавляет E_WARNING, ERRMODE_EXCEPTION выбрасывает PDOException (стандарт с PHP 8.0). Ошибки аргументов и отдельные ошибки состояния могут возникать независимо от этого режима. В примерах режим задан явно; сообщение драйвера не выводится посетителю.

Как читать этот вариант. Контекстный пример: требуется PostgreSQL, pdo_pgsql и доверенные PG_DSN/PG_USER/PG_PASSWORD. Здесь проверен синтаксис PHP, запрос к серверу не выполнялся. Нужны права записи каталога PHP. Создание файла и его выдача пользователю — разные шаги; для веб-выдачи сначала проверяют доступ к выгрузке.

<?php
$db = new Pdo\Pgsql(getenv('PG_DSN'), getenv('PG_USER'), getenv('PG_PASSWORD'), [PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION]);
$db->exec('CREATE TEMP TABLE export_items (id integer, name text)');
$db->exec("INSERT INTO export_items VALUES (1, 'Pen')");
$path = __DIR__ . '/export.tsv';
$db->copyToFile('export_items', $path);
echo rtrim(file_get_contents($path), "\r\n"), "\n";

1	Pen

Как читать этот вариант. Контекстный пример: требуется PostgreSQL, pdo_pgsql и доверенные PG_DSN/PG_USER/PG_PASSWORD. Здесь проверен синтаксис PHP, запрос к серверу не выполнялся. Соседний временный файл помогает не отдавать незавершённый результат под финальным именем. В рабочем каталоге нужны уникальные имена, политика существующего файла и учёт семантики rename ОС/файловой системы.

<?php
$db = new Pdo\Pgsql(getenv('PG_DSN'), getenv('PG_USER'), getenv('PG_PASSWORD'), [PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION]);
$db->exec('CREATE TEMP TABLE export_items (id integer, name text)');
$db->exec("INSERT INTO export_items VALUES (1, 'Pen')");
$temp = __DIR__ . '/export.part';
$ready = __DIR__ . '/export.tsv';
if (!$db->copyToFile('export_items', $temp)) { throw new RuntimeException('Экспорт не завершён'); }
if (!rename($temp, $ready)) { throw new RuntimeException('Не удалось опубликовать файл'); }
echo "Файл готов\n";

Файл готов

Рядом: Pdo\Pgsql::copyToFile(), Pdo\Pgsql::copyToArray(), Pdo\Pgsql::copyFromFile().

• PHP: PDO::pgsqlCopyToFile

PHP 8.4+; отдельные изменения отмечены · PDO; соответствующий драйвер

Pdo\Pgsql::escapeIdentifier(string $input): string

<?php
require __DIR__ . '/catalog.php';
$column = 'name';
if (!in_array($column, ['name', 'stock'], true)) { throw new InvalidArgumentException('Неизвестная колонка'); }
$quoted = $db->escapeIdentifier($column);
$statement = $db->query('SELECT ' . $quoted . ' FROM products WHERE id = 1');
echo $statement->fetchColumn(), "\n";

Молоток

Записать PostgreSQL-идентификатор с правильными кавычками и регистром.

$db обозначает соединение, $statement — подготовленную команду и её текущий результат. -> вызывает метод конкретного объекта, :: — статический метод или константу класса. Круглые скобки содержат аргументы; результат справа от = сохраняется в переменной. Это отдельные шаги: выполнить SQL и прочитать полученные строки. Основы: объекты, аргументы и возврат.

Возвращает цитированную строку. Это не проверка существования/разрешения объекта; список допустимых имён остаётся у приложения. Для строковых значений нужны параметры, не этот метод. Внутренние кавычки экранируются по синтаксису PostgreSQL.

При неудаче SQL-операции режим ERRMODE_SILENT оставляет false и диагностику, ERRMODE_WARNING добавляет E_WARNING, ERRMODE_EXCEPTION выбрасывает PDOException (стандарт с PHP 8.0). Ошибки аргументов и отдельные ошибки состояния могут возникать независимо от этого режима. В примерах режим задан явно; сообщение драйвера не выводится посетителю.

Как читать этот вариант. Контекстный пример: требуется PostgreSQL, pdo_pgsql и доверенные PG_DSN/PG_USER/PG_PASSWORD. Здесь проверен синтаксис PHP, запрос к серверу не выполнялся. Allowlist определяет, какую колонку разрешено выбирать; escapeIdentifier обеспечивает SQL-запись имени. Эти задачи дополняют друг друга. Маркер :column не подставляет идентификатор.

<?php
$db = new Pdo\Pgsql(getenv('PG_DSN'), getenv('PG_USER'), getenv('PG_PASSWORD'), [PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION]);
$allowed = ['name', 'price'];
$column = 'name';
if (!in_array($column, $allowed, true)) { throw new InvalidArgumentException('Неизвестная колонка'); }
echo $db->escapeIdentifier($column), "\n";

"name"

Как читать этот вариант. Контекстный пример: требуется PostgreSQL, pdo_pgsql и доверенные PG_DSN/PG_USER/PG_PASSWORD. Здесь проверен синтаксис PHP, запрос к серверу не выполнялся. Цитирование reports.Order Export целиком создало бы одно имя с точкой внутри. Структуру квалифицированного идентификатора строит программа, отдельные части цитируются отдельно.

<?php
$db = new Pdo\Pgsql(getenv('PG_DSN'), getenv('PG_USER'), getenv('PG_PASSWORD'), [PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION]);
$schema = $db->escapeIdentifier('reports');
$table = $db->escapeIdentifier('Order Export');
echo $schema . '.' . $table, "\n";

"reports"."Order Export"

Рядом: PDO::prepare(), PDO::quote().

• PHP: Pdo\Pgsql::escapeIdentifier

PHP 8.4+; отдельные изменения отмечены · PDO; соответствующий драйвер

Pdo\Pgsql::getNotify(int $fetchMode = PDO::FETCH_DEFAULT, int $timeoutMilliseconds = 0): array|false

<?php
require __DIR__ . '/catalog.php';
$db->exec('LISTEN catalog_changed');
$statement = $db->prepare("SELECT pg_notify('catalog_changed', :payload)");
$statement->execute(['payload'=>'1']);
$statement->closeCursor();
$notice = $db->getNotify(PDO::FETCH_ASSOC, 1000);
if ($notice === false) { throw new RuntimeException('За время ожидания сигнал не пришёл'); }
echo 'Изменился товар #', $notice['payload'], "\n";
$statement = $db->prepare('SELECT name, stock FROM products WHERE id = :id');
$statement->execute(['id'=>$notice['payload']]);
$row = $statement->fetch(PDO::FETCH_ASSOC);
echo $row['name'], ' — ', $row['stock'], " шт.\n";
$db->exec('UNLISTEN catalog_changed');

Изменился товар #1
Молоток — 8 шт.

Получить ожидающее асинхронное уведомление PostgreSQL.

$db обозначает соединение, $statement — подготовленную команду и её текущий результат. -> вызывает метод конкретного объекта, :: — статический метод или константу класса. Круглые скобки содержат аргументы; результат справа от = сохраняется в переменной. Это отдельные шаги: выполнить SQL и прочитать полученные строки. Основы: объекты, аргументы и возврат.

Массив одной нотификации либо false, когда нет. ASSOC содержит message (имя канала), pid отправляющего серверного процесса, payload при непустой нагрузке; NUM использует 0/1/2. Проверяйте ?? для необязательного payload. Долгое ожидание лучше отдельному worker, а не каждому HTTP-ответу.

При неудаче SQL-операции режим ERRMODE_SILENT оставляет false и диагностику, ERRMODE_WARNING добавляет E_WARNING, ERRMODE_EXCEPTION выбрасывает PDOException (стандарт с PHP 8.0). Ошибки аргументов и отдельные ошибки состояния могут возникать независимо от этого режима. В примерах режим задан явно; сообщение драйвера не выводится посетителю.

Как читать этот вариант. Контекстный пример: требуется PostgreSQL, pdo_pgsql и доверенные PG_DSN/PG_USER/PG_PASSWORD. Здесь проверен синтаксис PHP, запрос к серверу не выполнялся. LISTEN регистрирует соединение на канале. timeout 0 не заставляет веб-запрос ждать. Уведомление не появляется только потому, что изменилась таблица: другая сторона должна выполнить NOTIFY/pg_notify.

<?php
$db = new Pdo\Pgsql(getenv('PG_DSN'), getenv('PG_USER'), getenv('PG_PASSWORD'), [PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION]);
$db->exec('LISTEN order_events');
$notice = $db->getNotify(PDO::FETCH_ASSOC, 0);
echo $notice === false ? "Пока нет события\n" : $notice['message'] . "\n";

При отсутствии новых уведомлений: Пока нет события

Как читать этот вариант. Контекстный пример: требуется PostgreSQL, pdo_pgsql и доверенные PG_DSN/PG_USER/PG_PASSWORD. Здесь проверен синтаксис PHP, запрос к серверу не выполнялся. Учебное соединение уведомляет собственный канал. У транзакционных LISTEN/NOTIFY момент доставки связан с commit; для рабочих событий сигнал используют как повод перечитать данные. LISTEN/NOTIFY не заменяет надёжную очередь с подтверждением и хранением.

<?php
$db = new Pdo\Pgsql(getenv('PG_DSN'), getenv('PG_USER'), getenv('PG_PASSWORD'), [PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION]);
$db->exec('LISTEN order_events');
$db->query("SELECT pg_notify('order_events', '42')")->closeCursor();
$notice = $db->getNotify(PDO::FETCH_ASSOC, 1000);
if ($notice !== false) { echo $notice['message'], ':', ($notice['payload'] ?? ''), "\n"; }

order_events:42

Рядом: Pdo\Pgsql::getPid().

• PHP: Pdo\Pgsql::getNotify

PHP 5.1+; старое имя deprecated с PHP 8.5 · PDO; соответствующий драйвер

PDO::pgsqlGetNotify(int $fetchMode = PDO::FETCH_DEFAULT, int $timeoutMilliseconds = 0): array|false

<?php
require __DIR__ . '/catalog.php';
$db->exec('LISTEN catalog_changed');
$statement = $db->prepare("SELECT pg_notify('catalog_changed', :payload)");
$statement->execute(['payload'=>'1']);
$statement->closeCursor();
$notice = $db->getNotify(PDO::FETCH_ASSOC, 1000);
if ($notice === false) { throw new RuntimeException('За время ожидания сигнал не пришёл'); }
echo 'Изменился товар #', $notice['payload'], "\n";
$statement = $db->prepare('SELECT name, stock FROM products WHERE id = :id');
$statement->execute(['id'=>$notice['payload']]);
$row = $statement->fetch(PDO::FETCH_ASSOC);
echo $row['name'], ' — ', $row['stock'], " шт.\n";
$db->exec('UNLISTEN catalog_changed');

Изменился товар #1
Молоток — 8 шт.

Получить ожидающее асинхронное уведомление PostgreSQL. Историческое имя.

$db обозначает соединение, $statement — подготовленную команду и её текущий результат. -> вызывает метод конкретного объекта, :: — статический метод или константу класса. Круглые скобки содержат аргументы; результат справа от = сохраняется в переменной. Это отдельные шаги: выполнить SQL и прочитать полученные строки. Основы: объекты, аргументы и возврат.

Массив одной нотификации либо false, когда нет. ASSOC содержит message (имя канала), pid отправляющего серверного процесса, payload при непустой нагрузке; NUM использует 0/1/2. Проверяйте ?? для необязательного payload. Долгое ожидание лучше отдельному worker, а не каждому HTTP-ответу. С PHP 8.5 старый метод deprecated. Для миграции создайте Pdo\Pgsql (или PDO::connect) и используйте getNotify; два примера показывают этот целевой API. Простой new PDO по-прежнему создаёт базовый класс.

При неудаче SQL-операции режим ERRMODE_SILENT оставляет false и диагностику, ERRMODE_WARNING добавляет E_WARNING, ERRMODE_EXCEPTION выбрасывает PDOException (стандарт с PHP 8.0). Ошибки аргументов и отдельные ошибки состояния могут возникать независимо от этого режима. В примерах режим задан явно; сообщение драйвера не выводится посетителю.

Как читать этот вариант. Контекстный пример: требуется PostgreSQL, pdo_pgsql и доверенные PG_DSN/PG_USER/PG_PASSWORD. Здесь проверен синтаксис PHP, запрос к серверу не выполнялся. LISTEN регистрирует соединение на канале. timeout 0 не заставляет веб-запрос ждать. Уведомление не появляется только потому, что изменилась таблица: другая сторона должна выполнить NOTIFY/pg_notify.

<?php
$db = new Pdo\Pgsql(getenv('PG_DSN'), getenv('PG_USER'), getenv('PG_PASSWORD'), [PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION]);
$db->exec('LISTEN order_events');
$notice = $db->getNotify(PDO::FETCH_ASSOC, 0);
echo $notice === false ? "Пока нет события\n" : $notice['message'] . "\n";

При отсутствии новых уведомлений: Пока нет события

Как читать этот вариант. Контекстный пример: требуется PostgreSQL, pdo_pgsql и доверенные PG_DSN/PG_USER/PG_PASSWORD. Здесь проверен синтаксис PHP, запрос к серверу не выполнялся. Учебное соединение уведомляет собственный канал. У транзакционных LISTEN/NOTIFY момент доставки связан с commit; для рабочих событий сигнал используют как повод перечитать данные. LISTEN/NOTIFY не заменяет надёжную очередь с подтверждением и хранением.

<?php
$db = new Pdo\Pgsql(getenv('PG_DSN'), getenv('PG_USER'), getenv('PG_PASSWORD'), [PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION]);
$db->exec('LISTEN order_events');
$db->query("SELECT pg_notify('order_events', '42')")->closeCursor();
$notice = $db->getNotify(PDO::FETCH_ASSOC, 1000);
if ($notice !== false) { echo $notice['message'], ':', ($notice['payload'] ?? ''), "\n"; }

order_events:42

Рядом: Pdo\Pgsql::getNotify(), Pdo\Pgsql::getPid().

• PHP: PDO::pgsqlGetNotify

PHP 8.4+; отдельные изменения отмечены · PDO; соответствующий драйвер

Pdo\Pgsql::getPid(): int

<?php
require __DIR__ . '/catalog.php';
$pid = $db->getPid();
$reported = (int) $db->query('SELECT pg_backend_pid()')->fetchColumn();
if ($pid !== $reported) { throw new RuntimeException('Неверная связь диагностического соединения'); }
echo "Диагностика относится к текущему соединению каталога\n";
$row = $db->query('SELECT name, stock FROM products WHERE id = 1')->fetch(PDO::FETCH_ASSOC);
echo $row['name'], ' — ', $row['stock'], " шт.\n";

Диагностика относится к текущему соединению каталога
Молоток — 8 шт.

Узнать PID серверного процесса, обслуживающего соединение PostgreSQL.

$db обозначает соединение, $statement — подготовленную команду и её текущий результат. -> вызывает метод конкретного объекта, :: — статический метод или константу класса. Круглые скобки содержат аргументы; результат справа от = сохраняется в переменной. Это отдельные шаги: выполнить SQL и прочитать полученные строки. Основы: объекты, аргументы и возврат.

Целое число PID на машине сервера. Это диагностическая привязка текущего соединения, не PID PHP и не разрешение завершать процесс. Для журнала дополняют временем/идентификатором запроса.

При неудаче SQL-операции режим ERRMODE_SILENT оставляет false и диагностику, ERRMODE_WARNING добавляет E_WARNING, ERRMODE_EXCEPTION выбрасывает PDOException (стандарт с PHP 8.0). Ошибки аргументов и отдельные ошибки состояния могут возникать независимо от этого режима. В примерах режим задан явно; сообщение драйвера не выводится посетителю.

Как читать этот вариант. Контекстный пример: требуется PostgreSQL, pdo_pgsql и доверенные PG_DSN/PG_USER/PG_PASSWORD. Здесь проверен синтаксис PHP, запрос к серверу не выполнялся. PID относится к серверу PostgreSQL, не к PHP-процессу. Он помогает DBA найти сессию в pg_stat_activity при диагностике блокировок.

<?php
$db = new Pdo\Pgsql(getenv('PG_DSN'), getenv('PG_USER'), getenv('PG_PASSWORD'), [PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION]);
$pid = $db->getPid();
echo 'backend=', $pid, "\n";

backend=<целочисленный PID процесса PostgreSQL>

Как читать этот вариант. Контекстный пример: требуется PostgreSQL, pdo_pgsql и доверенные PG_DSN/PG_USER/PG_PASSWORD. Здесь проверен синтаксис PHP, запрос к серверу не выполнялся. Оба пути показывают backend одного соединения. Не считайте PID вечным идентификатором задачи: после переподключения он может измениться и позднее переиспользоваться.

<?php
$db = new Pdo\Pgsql(getenv('PG_DSN'), getenv('PG_USER'), getenv('PG_PASSWORD'), [PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION]);
var_dump($db->getPid() === (int) $db->query('SELECT pg_backend_pid()')->fetchColumn());

bool(true)

Рядом: Pdo\Pgsql::getNotify().

• PHP: Pdo\Pgsql::getPid

PHP 5.1+; старое имя deprecated с PHP 8.5 · PDO; соответствующий драйвер

PDO::pgsqlGetPid(): int

<?php
require __DIR__ . '/catalog.php';
$pid = $db->getPid();
$reported = (int) $db->query('SELECT pg_backend_pid()')->fetchColumn();
if ($pid !== $reported) { throw new RuntimeException('Неверная связь диагностического соединения'); }
echo "Диагностика относится к текущему соединению каталога\n";
$row = $db->query('SELECT name, stock FROM products WHERE id = 1')->fetch(PDO::FETCH_ASSOC);
echo $row['name'], ' — ', $row['stock'], " шт.\n";

Диагностика относится к текущему соединению каталога
Молоток — 8 шт.

Узнать PID серверного процесса, обслуживающего соединение PostgreSQL. Историческое имя.

$db обозначает соединение, $statement — подготовленную команду и её текущий результат. -> вызывает метод конкретного объекта, :: — статический метод или константу класса. Круглые скобки содержат аргументы; результат справа от = сохраняется в переменной. Это отдельные шаги: выполнить SQL и прочитать полученные строки. Основы: объекты, аргументы и возврат.

Целое число PID на машине сервера. Это диагностическая привязка текущего соединения, не PID PHP и не разрешение завершать процесс. Для журнала дополняют временем/идентификатором запроса. С PHP 8.5 старый метод deprecated. Для миграции создайте Pdo\Pgsql (или PDO::connect) и используйте getPid; два примера показывают этот целевой API. Простой new PDO по-прежнему создаёт базовый класс.

При неудаче SQL-операции режим ERRMODE_SILENT оставляет false и диагностику, ERRMODE_WARNING добавляет E_WARNING, ERRMODE_EXCEPTION выбрасывает PDOException (стандарт с PHP 8.0). Ошибки аргументов и отдельные ошибки состояния могут возникать независимо от этого режима. В примерах режим задан явно; сообщение драйвера не выводится посетителю.

Как читать этот вариант. Контекстный пример: требуется PostgreSQL, pdo_pgsql и доверенные PG_DSN/PG_USER/PG_PASSWORD. Здесь проверен синтаксис PHP, запрос к серверу не выполнялся. PID относится к серверу PostgreSQL, не к PHP-процессу. Он помогает DBA найти сессию в pg_stat_activity при диагностике блокировок.

<?php
$db = new Pdo\Pgsql(getenv('PG_DSN'), getenv('PG_USER'), getenv('PG_PASSWORD'), [PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION]);
$pid = $db->getPid();
echo 'backend=', $pid, "\n";

backend=<целочисленный PID процесса PostgreSQL>

Как читать этот вариант. Контекстный пример: требуется PostgreSQL, pdo_pgsql и доверенные PG_DSN/PG_USER/PG_PASSWORD. Здесь проверен синтаксис PHP, запрос к серверу не выполнялся. Оба пути показывают backend одного соединения. Не считайте PID вечным идентификатором задачи: после переподключения он может измениться и позднее переиспользоваться.

<?php
$db = new Pdo\Pgsql(getenv('PG_DSN'), getenv('PG_USER'), getenv('PG_PASSWORD'), [PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION]);
var_dump($db->getPid() === (int) $db->query('SELECT pg_backend_pid()')->fetchColumn());

bool(true)

Рядом: Pdo\Pgsql::getPid(), Pdo\Pgsql::getNotify().

• PHP: PDO::pgsqlGetPid

PHP 8.4+; отдельные изменения отмечены · PDO; соответствующий драйвер

Pdo\Pgsql::lobCreate(): string|false

<?php
require __DIR__ . '/catalog.php';
$db->beginTransaction();
try {
    $oid = $db->lobCreate();
    $stream = $db->lobOpen($oid, 'w');
    if ($stream === false) { throw new RuntimeException('Вложение не открыто'); }
    fwrite($stream, "Квитанция заказа #1\n");
    fclose($stream);
    $stream = $db->lobOpen($oid, 'r');
    if ($stream === false) { throw new RuntimeException('Вложение не прочитано'); }
    echo stream_get_contents($stream);
    fclose($stream);
    if (!$db->lobUnlink($oid)) { throw new RuntimeException('Учебное вложение не удалено'); }
    $db->commit();
} catch (Throwable $error) {
    if ($db->inTransaction()) { $db->rollBack(); }
    throw $error;
}

Квитанция заказа #1

Создать PostgreSQL large object и получить его OID.

$db обозначает соединение, $statement — подготовленную команду и её текущий результат. -> вызывает метод конкретного объекта, :: — статический метод или константу класса. Круглые скобки содержат аргументы; результат справа от = сохраняется в переменной. Это отдельные шаги: выполнить SQL и прочитать полученные строки. Основы: объекты, аргументы и возврат.

Строка OID либо false. Все операции large object требуют транзакции. Объект живёт отдельно от ссылающихся строк до lobUnlink; удаление последней ссылки без очистки оставляет мусор. В современной PostgreSQL есть владелец и ACL large objects; старую фразу PHP-страницы «no access controls» нельзя применять к текущему серверу. bytea часто проще: хранит значение в строке и обслуживает его жизненный цикл.

При неудаче SQL-операции режим ERRMODE_SILENT оставляет false и диагностику, ERRMODE_WARNING добавляет E_WARNING, ERRMODE_EXCEPTION выбрасывает PDOException (стандарт с PHP 8.0). Ошибки аргументов и отдельные ошибки состояния могут возникать независимо от этого режима. В примерах режим задан явно; сообщение драйвера не выводится посетителю.

Как читать этот вариант. Контекстный пример: требуется PostgreSQL, pdo_pgsql и доверенные PG_DSN/PG_USER/PG_PASSWORD. Здесь проверен синтаксис PHP, запрос к серверу не выполнялся. Создание, поточные операции и удаление находятся внутри транзакции. Учебный объект удаляется, чтобы пример не оставлял потерянные OID. В приложении OID сохраняют как ссылку, а жизненным циклом управляют явно.

<?php
$db = new Pdo\Pgsql(getenv('PG_DSN'), getenv('PG_USER'), getenv('PG_PASSWORD'), [PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION]);
$db->beginTransaction();
try {
    $oid = $db->lobCreate();
    if ($oid === false) { throw new RuntimeException('LOB не создан'); }
    $stream = $db->lobOpen($oid, 'w');
    if ($stream === false) { throw new RuntimeException('LOB не открыт'); }
    fwrite($stream, 'Receipt 42');
    fclose($stream);
    $db->lobUnlink($oid);
    $db->commit();
    echo "Учебный LOB обработан и удалён\n";
} catch (Throwable $error) { if ($db->inTransaction()) { $db->rollBack(); } throw $error; }

Учебный LOB обработан и удалён

Как читать этот вариант. Контекстный пример: требуется PostgreSQL, pdo_pgsql и доверенные PG_DSN/PG_USER/PG_PASSWORD. Здесь проверен синтаксис PHP, запрос к серверу не выполнялся. Rollback отменяет создание в этой транзакции. Удаление строки со ссылкой на ранее подтверждённый OID само по себе не удаляет большой объект.

<?php
$db = new Pdo\Pgsql(getenv('PG_DSN'), getenv('PG_USER'), getenv('PG_PASSWORD'), [PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION]);
$db->beginTransaction();
$oid = $db->lobCreate();
if ($oid === false) { throw new RuntimeException('Не создано'); }
$db->rollBack();
echo "Создание отменено\n";

Создание отменено

Рядом: Pdo\Pgsql::lobOpen(), Pdo\Pgsql::lobUnlink().

• PHP: Pdo\Pgsql::lobCreate

PHP 5.1+; старое имя deprecated с PHP 8.5 · PDO; соответствующий драйвер

PDO::pgsqlLOBCreate(): string|false

<?php
require __DIR__ . '/catalog.php';
$db->beginTransaction();
try {
    $oid = $db->lobCreate();
    $stream = $db->lobOpen($oid, 'w');
    if ($stream === false) { throw new RuntimeException('Вложение не открыто'); }
    fwrite($stream, "Квитанция заказа #1\n");
    fclose($stream);
    $stream = $db->lobOpen($oid, 'r');
    if ($stream === false) { throw new RuntimeException('Вложение не прочитано'); }
    echo stream_get_contents($stream);
    fclose($stream);
    if (!$db->lobUnlink($oid)) { throw new RuntimeException('Учебное вложение не удалено'); }
    $db->commit();
} catch (Throwable $error) {
    if ($db->inTransaction()) { $db->rollBack(); }
    throw $error;
}

Квитанция заказа #1

Создать PostgreSQL large object и получить его OID. Историческое имя.

$db обозначает соединение, $statement — подготовленную команду и её текущий результат. -> вызывает метод конкретного объекта, :: — статический метод или константу класса. Круглые скобки содержат аргументы; результат справа от = сохраняется в переменной. Это отдельные шаги: выполнить SQL и прочитать полученные строки. Основы: объекты, аргументы и возврат.

Строка OID либо false. Все операции large object требуют транзакции. Объект живёт отдельно от ссылающихся строк до lobUnlink; удаление последней ссылки без очистки оставляет мусор. В современной PostgreSQL есть владелец и ACL large objects; старую фразу PHP-страницы «no access controls» нельзя применять к текущему серверу. bytea часто проще: хранит значение в строке и обслуживает его жизненный цикл. С PHP 8.5 старый метод deprecated. Для миграции создайте Pdo\Pgsql (или PDO::connect) и используйте lobCreate; два примера показывают этот целевой API. Простой new PDO по-прежнему создаёт базовый класс.

При неудаче SQL-операции режим ERRMODE_SILENT оставляет false и диагностику, ERRMODE_WARNING добавляет E_WARNING, ERRMODE_EXCEPTION выбрасывает PDOException (стандарт с PHP 8.0). Ошибки аргументов и отдельные ошибки состояния могут возникать независимо от этого режима. В примерах режим задан явно; сообщение драйвера не выводится посетителю.

Как читать этот вариант. Контекстный пример: требуется PostgreSQL, pdo_pgsql и доверенные PG_DSN/PG_USER/PG_PASSWORD. Здесь проверен синтаксис PHP, запрос к серверу не выполнялся. Создание, поточные операции и удаление находятся внутри транзакции. Учебный объект удаляется, чтобы пример не оставлял потерянные OID. В приложении OID сохраняют как ссылку, а жизненным циклом управляют явно.

<?php
$db = new Pdo\Pgsql(getenv('PG_DSN'), getenv('PG_USER'), getenv('PG_PASSWORD'), [PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION]);
$db->beginTransaction();
try {
    $oid = $db->lobCreate();
    if ($oid === false) { throw new RuntimeException('LOB не создан'); }
    $stream = $db->lobOpen($oid, 'w');
    if ($stream === false) { throw new RuntimeException('LOB не открыт'); }
    fwrite($stream, 'Receipt 42');
    fclose($stream);
    $db->lobUnlink($oid);
    $db->commit();
    echo "Учебный LOB обработан и удалён\n";
} catch (Throwable $error) { if ($db->inTransaction()) { $db->rollBack(); } throw $error; }

Учебный LOB обработан и удалён

Как читать этот вариант. Контекстный пример: требуется PostgreSQL, pdo_pgsql и доверенные PG_DSN/PG_USER/PG_PASSWORD. Здесь проверен синтаксис PHP, запрос к серверу не выполнялся. Rollback отменяет создание в этой транзакции. Удаление строки со ссылкой на ранее подтверждённый OID само по себе не удаляет большой объект.

<?php
$db = new Pdo\Pgsql(getenv('PG_DSN'), getenv('PG_USER'), getenv('PG_PASSWORD'), [PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION]);
$db->beginTransaction();
$oid = $db->lobCreate();
if ($oid === false) { throw new RuntimeException('Не создано'); }
$db->rollBack();
echo "Создание отменено\n";

Создание отменено

Рядом: Pdo\Pgsql::lobCreate(), Pdo\Pgsql::lobOpen(), Pdo\Pgsql::lobUnlink().

• PHP: PDO::pgsqlLOBCreate

PHP 8.4+; отдельные изменения отмечены · PDO; соответствующий драйвер

Pdo\Pgsql::lobOpen(string $oid, string $mode = "rb"): resource|false

<?php
require __DIR__ . '/catalog.php';
$db->beginTransaction();
try {
    $oid = $db->lobCreate();
    $stream = $db->lobOpen($oid, 'w');
    if ($stream === false) { throw new RuntimeException('Вложение не открыто'); }
    fwrite($stream, "Квитанция заказа #1\n");
    fclose($stream);
    $stream = $db->lobOpen($oid, 'r');
    if ($stream === false) { throw new RuntimeException('Вложение не прочитано'); }
    echo stream_get_contents($stream);
    fclose($stream);
    if (!$db->lobUnlink($oid)) { throw new RuntimeException('Учебное вложение не удалено'); }
    $db->commit();
} catch (Throwable $error) {
    if ($db->inTransaction()) { $db->rollBack(); }
    throw $error;
}

Квитанция заказа #1

Открыть поток к существующему large object PostgreSQL.

$db обозначает соединение, $statement — подготовленную команду и её текущий результат. -> вызывает метод конкретного объекта, :: — статический метод или константу класса. Круглые скобки содержат аргументы; результат справа от = сохраняется в переменной. Это отдельные шаги: выполнить SQL и прочитать полученные строки. Основы: объекты, аргументы и возврат.

Resource потока или false. Открытие и все операции только внутри транзакции; fclose до её завершения. Это иной механизм, чем bytea: столбцы bytea PDO_PGSQL тоже может отдавать потоками, но они не являются отдельными OID large objects. Проверяйте доступ и каждую запись/чтение в производственном импорте.

При неудаче SQL-операции режим ERRMODE_SILENT оставляет false и диагностику, ERRMODE_WARNING добавляет E_WARNING, ERRMODE_EXCEPTION выбрасывает PDOException (стандарт с PHP 8.0). Ошибки аргументов и отдельные ошибки состояния могут возникать независимо от этого режима. В примерах режим задан явно; сообщение драйвера не выводится посетителю.

Как читать этот вариант. Контекстный пример: требуется PostgreSQL, pdo_pgsql и доверенные PG_DSN/PG_USER/PG_PASSWORD. Здесь проверен синтаксис PHP, запрос к серверу не выполнялся. rb открывает чтение; stream-функции работают с объектом на сервере, а не локальным файлом. Поток закрывают внутри транзакции, которая дала ему действительность.

<?php
$db = new Pdo\Pgsql(getenv('PG_DSN'), getenv('PG_USER'), getenv('PG_PASSWORD'), [PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION]);
$db->beginTransaction();
$oid = $db->lobCreate();
$write = $db->lobOpen($oid, 'w');
fwrite($write, 'Receipt 42');
fclose($write);
$read = $db->lobOpen($oid, 'rb');
echo fread($read, 7), "\n";
fclose($read);
$db->lobUnlink($oid);
$db->commit();

Receipt

Как читать этот вариант. Контекстный пример: требуется PostgreSQL, pdo_pgsql и доверенные PG_DSN/PG_USER/PG_PASSWORD. Здесь проверен синтаксис PHP, запрос к серверу не выполнялся. Режим с w или + у PDO_PGSQL означает чтение и запись; это не обещание обычной файловой truncate-семантики. Позиция измеряется байтами. Для текста UTF-8 произвольное смещение может попасть внутрь символа.

<?php
$db = new Pdo\Pgsql(getenv('PG_DSN'), getenv('PG_USER'), getenv('PG_PASSWORD'), [PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION]);
$db->beginTransaction();
$oid = $db->lobCreate();
$stream = $db->lobOpen($oid, 'w+');
fwrite($stream, 'ABCDE');
fseek($stream, 2);
echo fread($stream, 2), "\n";
fclose($stream);
$db->lobUnlink($oid);
$db->commit();

CD

Рядом: Pdo\Pgsql::lobCreate(), Pdo\Pgsql::lobUnlink().

• PHP: Pdo\Pgsql::lobOpen

PHP 5.1+; старое имя deprecated с PHP 8.5 · PDO; соответствующий драйвер

PDO::pgsqlLOBOpen(string $oid, string $mode = "rb"): resource|false

<?php
require __DIR__ . '/catalog.php';
$db->beginTransaction();
try {
    $oid = $db->lobCreate();
    $stream = $db->lobOpen($oid, 'w');
    if ($stream === false) { throw new RuntimeException('Вложение не открыто'); }
    fwrite($stream, "Квитанция заказа #1\n");
    fclose($stream);
    $stream = $db->lobOpen($oid, 'r');
    if ($stream === false) { throw new RuntimeException('Вложение не прочитано'); }
    echo stream_get_contents($stream);
    fclose($stream);
    if (!$db->lobUnlink($oid)) { throw new RuntimeException('Учебное вложение не удалено'); }
    $db->commit();
} catch (Throwable $error) {
    if ($db->inTransaction()) { $db->rollBack(); }
    throw $error;
}

Квитанция заказа #1