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

<?php
declare(strict_types=1);

require __DIR__ . '/uodbc-bootstrap.php';

$connection = @odbc_connect(
    uodbcEnv('UODBC_DSN'),
    uodbcEnv('UODBC_USER'),
    uodbcEnv('UODBC_PASSWORD'),
    SQL_CUR_USE_DRIVER,
);
if ($connection === false) {
    throw new RuntimeException(odbc_error().' '.odbc_errormsg());
}
$result = uodbcExec($connection, 'SELECT 42 AS answer');
echo get_debug_type($connection), "\n";
echo odbc_result($result, 'answer'), "\n";
odbc_close($connection);

Odbc\Connection
42

Соединение успешно только после возврата объекта. Проверочный SELECT показывает, что доступен не просто Driver Manager, а сама база. Пример выполнен через PHP 8.5.11/ext/odbc и psqlODBC 18.00 на отдельной локальной учебной базе PostgreSQL 18.6. Реквизиты передаются переменными окружения; рабочие пароли и данные в пример не входят. Таблицы с префиксом phpman_ создаются только для этого запуска и удаляются в finally.

<?php
declare(strict_types=1);

require __DIR__ . '/uodbc-bootstrap.php';

$connection = @odbc_connect('MISSING_DSN_404', null, null);
if ($connection === false) {
    echo odbc_error(), "\n";
}

IM002

SQLSTATE IM002 означает, что Driver Manager не нашёл источник/драйвер. Имя намеренно короче 32 символов: слишком длинный DSN в Windows даёт другой SQLSTATE S1090 (invalid string or buffer length). Пользователю не показывают полную строку подключения и пароль. Пример выполнен через PHP 8.5.11/ext/odbc и psqlODBC 18.00 на отдельной локальной учебной базе PostgreSQL 18.6. Реквизиты передаются переменными окружения; рабочие пароли и данные в пример не входят. Таблицы с префиксом phpman_ создаются только для этого запуска и удаляются в finally.

<?php
declare(strict_types=1);

require __DIR__ . '/uodbc-bootstrap.php';

$connection = @odbc_pconnect(
    uodbcEnv('UODBC_DSN'),
    uodbcEnv('UODBC_USER'),
    uodbcEnv('UODBC_PASSWORD'),
);
if ($connection === false) {
    throw new RuntimeException(odbc_error().' '.odbc_errormsg());
}
$result = uodbcExec($connection, "SELECT 'ready' AS state");
echo odbc_result($result, 'state'), "\n";

ready

Постоянство относится к рабочему процессу PHP и следующим запросам этого процесса, а не делает объект общим между всеми серверами. Пример выполнен через PHP 8.5.11/ext/odbc и psqlODBC 18.00 на отдельной локальной учебной базе PostgreSQL 18.6. Реквизиты передаются переменными окружения; рабочие пароли и данные в пример не входят. Таблицы с префиксом phpman_ создаются только для этого запуска и удаляются в finally.

<?php
declare(strict_types=1);

require __DIR__ . '/uodbc-bootstrap.php';

$first = @odbc_pconnect(uodbcEnv('UODBC_DSN'), uodbcEnv('UODBC_USER'), uodbcEnv('UODBC_PASSWORD'));
$second = @odbc_pconnect(uodbcEnv('UODBC_DSN'), uodbcEnv('UODBC_USER'), uodbcEnv('UODBC_PASSWORD'));
if ($first === false || $second === false) {
    throw new RuntimeException(odbc_error().' '.odbc_errormsg());
}
$a = uodbcExec($first, 'SELECT pg_backend_pid() AS pid');
$b = uodbcExec($second, 'SELECT pg_backend_pid() AS pid');
echo odbc_result($a, 'pid') === odbc_result($b, 'pid') ? "same-session\n" : "different-session\n";

same-session

Одинаковые DSN/пользователь/пароль в одном CLI-процессе повторно используют persistent-сессию psqlODBC. В FPM состояние может жить дольше одного HTTP-запроса, поэтому настройки сессии надо возвращать в ожидаемое состояние. Пример выполнен через PHP 8.5.11/ext/odbc и psqlODBC 18.00 на отдельной локальной учебной базе PostgreSQL 18.6. Реквизиты передаются переменными окружения; рабочие пароли и данные в пример не входят. Таблицы с префиксом phpman_ создаются только для этого запуска и удаляются в finally.

<?php
declare(strict_types=1);

require __DIR__ . '/uodbc-bootstrap.php';

$connection = uodbcConnect();
$result = uodbcExec($connection, 'SELECT COUNT(*) AS total FROM pg_catalog.pg_class');
echo ((int) odbc_result($result, 'total') > 0) ? "report-ready\n" : "empty\n";
odbc_close($connection);
try {
    odbc_exec($connection, 'SELECT 1');
} catch (Error) {
    echo "connection-closed\n";
}

report-ready
connection-closed

После закрытия тот же объект больше нельзя передавать ODBC-функциям. Результат читают до закрытия соединения. Пример выполнен через PHP 8.5.11/ext/odbc и psqlODBC 18.00 на отдельной локальной учебной базе PostgreSQL 18.6. Реквизиты передаются переменными окружения; рабочие пароли и данные в пример не входят. Таблицы с префиксом phpman_ создаются только для этого запуска и удаляются в finally.

<?php
declare(strict_types=1);

require __DIR__ . '/uodbc-bootstrap.php';

$connection = uodbcConnect();
uodbcDrop($connection, 'phpman_close_tx');
uodbcExec($connection, 'CREATE TABLE phpman_close_tx (id INTEGER PRIMARY KEY)');
odbc_autocommit($connection, false);
uodbcExec($connection, 'INSERT INTO phpman_close_tx VALUES (1)');
@odbc_close($connection);
$state = 'open';
try {
    odbc_exec($connection, 'SELECT 1');
    odbc_rollback($connection);
    odbc_autocommit($connection, true);
    odbc_close($connection);
} catch (Error) {
    $state = 'closed';
}
$cleanup = uodbcConnect();
$check = uodbcExec($cleanup, 'SELECT COUNT(*) AS total FROM phpman_close_tx');
echo "connection={$state}\n";
echo "rows-after-close=", odbc_result($check, 'total'), "\n";
uodbcDrop($cleanup, 'phpman_close_tx');
odbc_close($cleanup);

connection=closed
rows-after-close=0

Официальный manual обещает, что odbc_close() при открытой транзакции завершится неудачей и оставит соединение открытым. Проверенный PHP 8.5.11 + psqlODBC 18.00 фактически закрыл handle и сервер откатил INSERT. В php-src 8.5.11 safe_odbc_disconnect() после ошибки SQLDisconnect вызывает SQL_ROLLBACK, повторяет disconnect и освобождает handle. Это важное расхождение runtime: приложение обязано вызвать commit/rollback до close и не использовать close как transaction control. Пример выполнен через PHP 8.5.11/ext/odbc и psqlODBC 18.00 на отдельной локальной учебной базе PostgreSQL 18.6. Реквизиты передаются переменными окружения; рабочие пароли и данные в пример не входят. Таблицы с префиксом phpman_ создаются только для этого запуска и удаляются в finally.

<?php
declare(strict_types=1);

require __DIR__ . '/uodbc-bootstrap.php';

$first = uodbcConnect();
$second = uodbcConnect();
odbc_close_all();
$closed = 0;
foreach ([$first, $second] as $connection) {
    try { odbc_exec($connection, 'SELECT 1'); } catch (Error) { $closed++; }
}
echo "closed={$closed}\n";

closed=2

Функция действует на соединения процесса, поэтому её редко вызывают в библиотеке: она может закрыть ресурс чужого компонента. Пример выполнен через PHP 8.5.11/ext/odbc и psqlODBC 18.00 на отдельной локальной учебной базе PostgreSQL 18.6. Реквизиты передаются переменными окружения; рабочие пароли и данные в пример не входят. Таблицы с префиксом phpman_ создаются только для этого запуска и удаляются в finally.

<?php
declare(strict_types=1);

require __DIR__ . '/uodbc-bootstrap.php';

$first = uodbcConnect();
$second = uodbcConnect();
uodbcDrop($second, 'phpman_close_all_tx');
uodbcExec($second, 'CREATE TABLE phpman_close_all_tx (id INTEGER PRIMARY KEY)');
odbc_autocommit($second, false);
uodbcExec($second, 'INSERT INTO phpman_close_all_tx VALUES (1)');
odbc_close_all();
$states = [];
foreach (['first' => $first, 'transactional' => $second] as $name => $connection) {
    try {
        odbc_exec($connection, 'SELECT 1');
        $states[$name] = 'open';
        if ($name === 'transactional') { odbc_rollback($connection); }
        odbc_close($connection);
    } catch (Error) {
        $states[$name] = 'closed';
    }
}
$cleanup = uodbcConnect();
$check = uodbcExec($cleanup, 'SELECT COUNT(*) AS total FROM phpman_close_all_tx');
echo "first={$states['first']}\n";
echo "transactional={$states['transactional']}\n";
echo "rows-after-close=", odbc_result($check, 'total'), "\n";
uodbcDrop($cleanup, 'phpman_close_all_tx');
odbc_close($cleanup);

first=closed
transactional=closed
rows-after-close=0

Manual обещает оставить транзакционное соединение открытым. На проверенной связке close_all закрыл оба handles и PostgreSQL откатил незавершённый INSERT; это соответствует ветке rollback/retry/free в safe_odbc_disconnect() php-src 8.5.11. Поэтому глобальное закрытие не заменяет явный rollback/commit и требует проверки на каждом драйвере. Пример выполнен через PHP 8.5.11/ext/odbc и psqlODBC 18.00 на отдельной локальной учебной базе PostgreSQL 18.6. Реквизиты передаются переменными окружения; рабочие пароли и данные в пример не входят. Таблицы с префиксом phpman_ создаются только для этого запуска и удаляются в finally.

<?php
declare(strict_types=1);

require __DIR__ . '/uodbc-bootstrap.php';

$connection = uodbcConnect();
$result = uodbcExec($connection, 'SELECT 10 AS id');
$cursor = odbc_cursor($result);
echo is_string($cursor) && $cursor !== '' ? "cursor=yes\n" : "cursor=no\n";
odbc_close($connection);

cursor=yes

Само имя генерирует драйвер, поэтому приложение проверяет договор string|false, а не ожидает конкретную случайную строку. Пример выполнен через PHP 8.5.11/ext/odbc и psqlODBC 18.00 на отдельной локальной учебной базе PostgreSQL 18.6. Реквизиты передаются переменными окружения; рабочие пароли и данные в пример не входят. Таблицы с префиксом phpman_ создаются только для этого запуска и удаляются в finally.

<?php
declare(strict_types=1);

require __DIR__ . '/uodbc-bootstrap.php';

$connection = uodbcConnect();
$statement = odbc_prepare($connection, 'SELECT CAST(? AS INTEGER) AS id');
if ($statement === false || !odbc_execute($statement, [7])) {
    throw new RuntimeException(odbc_error($connection).' '.odbc_errormsg($connection));
}
echo odbc_cursor($statement) === false ? "no-cursor\n" : "prepared-cursor\n";
odbc_close($connection);

prepared-cursor

Prepared statement после execute также представлен Odbc\Result и имеет курсор, если драйвер его предоставляет. Пример выполнен через PHP 8.5.11/ext/odbc и psqlODBC 18.00 на отдельной локальной учебной базе PostgreSQL 18.6. Реквизиты передаются переменными окружения; рабочие пароли и данные в пример не входят. Таблицы с префиксом phpman_ создаются только для этого запуска и удаляются в finally.

<?php
declare(strict_types=1);

require __DIR__ . '/uodbc-bootstrap.php';

$connection = uodbcConnect();
$item = odbc_data_source($connection, SQL_FETCH_FIRST);
echo is_array($item) ? "enumeration=available\n" : "enumeration=empty\n";
$result = uodbcExec($connection, 'SELECT 1 AS alive');
echo "connection=", odbc_result($result, 'alive') == 1 ? "usable\n" : "failed\n";
odbc_close($connection);

enumeration=empty
connection=usable

Перечисление начинается SQL_FETCH_FIRST. В проверенной Windows/portable psqlODBC связке рабочий user DSN успешно подключается, но SQLDataSources не перечисляет ни одной записи. Это отдельная capability Driver Manager/драйвера: пустой список не доказывает, что DSN не работает. Пример выполнен через PHP 8.5.11/ext/odbc и psqlODBC 18.00 на отдельной локальной учебной базе PostgreSQL 18.6. Реквизиты передаются переменными окружения; рабочие пароли и данные в пример не входят. Таблицы с префиксом phpman_ создаются только для этого запуска и удаляются в finally.

<?php
declare(strict_types=1);

require __DIR__ . '/uodbc-bootstrap.php';

$connection = uodbcConnect();
$item = odbc_data_source($connection, SQL_FETCH_FIRST);
while (is_array($item)) {
    $item = odbc_data_source($connection, SQL_FETCH_NEXT);
}
echo $item === null ? "end=null\n" : "error=false\n";
odbc_close($connection);

end=null

В PHP 8.4 конец списка — null, а false оставлен для ошибки. Проверка while ($item) смешивает эти два исхода. Пример выполнен через PHP 8.5.11/ext/odbc и psqlODBC 18.00 на отдельной локальной учебной базе PostgreSQL 18.6. Реквизиты передаются переменными окружения; рабочие пароли и данные в пример не входят. Таблицы с префиксом phpman_ создаются только для этого запуска и удаляются в finally.

<?php
declare(strict_types=1);

foreach (['{plain}', '{a}}b}', 'plain', '{broken}tail'] as $value) {
    echo $value, ':', odbc_connection_string_is_quoted($value) ? 'yes' : 'no', "\n";
}

{plain}:yes
{a}}b}:yes
plain:no
{broken}tail:no

ODBC использует внешние фигурные скобки, а закрывающую скобку внутри удваивает. Пример выполнен в PHP 8.5.11 с изолированно загруженным ext/odbc; подключение к базе ему не требуется.

<?php
declare(strict_types=1);

$input = '{North;Warehouse}';
$safe = odbc_connection_string_is_quoted($input)
    ? $input
    : odbc_connection_string_quote($input);
echo $safe, "\n";

{North;Warehouse}

Сначала проверяем готовую форму; quote() сама не распознаёт уже заключённое значение. Пример выполнен в PHP 8.5.11 с изолированно загруженным ext/odbc; подключение к базе ему не требуется.

<?php
declare(strict_types=1);

foreach (['warehouse', 'North;Warehouse', ' leading', 'brace}'] as $value) {
    echo json_encode($value), ':', odbc_connection_string_should_quote($value) ? 'quote' : 'plain', "\n";
}

"warehouse":plain
"North;Warehouse":quote
" leading":quote
"brace}":quote

Точка с запятой, крайний пробел и фигурная скобка меняют разбор connection string и требуют quote(). Пример выполнен в PHP 8.5.11 с изолированно загруженным ext/odbc; подключение к базе ему не требуется.

<?php
declare(strict_types=1);

$value = '{North;Warehouse}';
echo odbc_connection_string_should_quote($value) ? "has-specials\n" : "plain\n";
echo odbc_connection_string_is_quoted($value) ? "already-quoted\n" : "needs-quote\n";

has-specials
already-quoted

should_quote() видит специальные скобки и потому возвращает true даже для готовой формы; нужен отдельный is_quoted(). Пример выполнен в PHP 8.5.11 с изолированно загруженным ext/odbc; подключение к базе ему не требуется.

<?php
declare(strict_types=1);

$value = 'North;Rack}2';
echo 'Warehouse=', odbc_connection_string_quote($value), "\n";

Warehouse={North;Rack}}2}

Внешние скобки удерживают точку с запятой внутри значения, внутренняя } удваивается. Пример выполнен в PHP 8.5.11 с изолированно загруженным ext/odbc; подключение к базе ему не требуется.

<?php
declare(strict_types=1);

$server = 'db01.internal;ApplicationIntent=ReadOnly';
$database = 'orders}archive';
$fragment = 'Server='.odbc_connection_string_quote($server)
    .';Database='.odbc_connection_string_quote($database).';';
echo $fragment, "\n";

Server={db01.internal;ApplicationIntent=ReadOnly};Database={orders}}archive};

Инъекционный разделитель остаётся частью Server, а не новым ключом. Сам набор ключей Server/Database задаёт программа. Пример выполнен в PHP 8.5.11 с изолированно загруженным ext/odbc; подключение к базе ему не требуется.

<?php
declare(strict_types=1);

require __DIR__ . '/uodbc-bootstrap.php';

$connection = uodbcConnect();
uodbcDrop($connection, 'phpman_exec_product');
try {
    uodbcExec($connection, 'CREATE TABLE phpman_exec_product (id INTEGER PRIMARY KEY, name VARCHAR(50))');
    uodbcExec($connection, "INSERT INTO phpman_exec_product VALUES (1, 'Notebook')");
    $result = odbc_exec($connection, 'SELECT name FROM phpman_exec_product WHERE id=1');
    if ($result === false) { throw new RuntimeException(odbc_errormsg($connection)); }
    echo odbc_result($result, 'name'), "\n";
} finally {
    uodbcDrop($connection, 'phpman_exec_product');
    odbc_close($connection);
}

Notebook

odbc_exec подходит SQL, полностью заданному программой. Значение посетителя сюда не склеивается. Пример выполнен через PHP 8.5.11/ext/odbc и psqlODBC 18.00 на отдельной локальной учебной базе PostgreSQL 18.6. Реквизиты передаются переменными окружения; рабочие пароли и данные в пример не входят. Таблицы с префиксом phpman_ создаются только для этого запуска и удаляются в finally.

<?php
declare(strict_types=1);

require __DIR__ . '/uodbc-bootstrap.php';

$connection = uodbcConnect();
uodbcDrop($connection, 'phpman_exec_sort');
try {
    uodbcExec($connection, 'CREATE TABLE phpman_exec_sort (id INTEGER PRIMARY KEY, price INTEGER)');
    uodbcExec($connection, 'INSERT INTO phpman_exec_sort VALUES (1, 300), (2, 100)');
    $requested = 'price';
    $allowed = ['id' => 'id', 'price' => 'price'];
    $column = $allowed[$requested] ?? 'id';
    $result = odbc_exec($connection, "SELECT id FROM phpman_exec_sort ORDER BY {$column}, id");
    if ($result === false) { throw new RuntimeException(odbc_errormsg($connection)); }
    while ($row = odbc_fetch_array($result)) { echo $row['id'], "\n"; }
} finally {
    uodbcDrop($connection, 'phpman_exec_sort');
    odbc_close($connection);
}

2
1

Placeholder не подставляет имя столбца. Структуру SQL выбирают по allowlist, а пользовательские значения передают prepare/execute. Пример выполнен через PHP 8.5.11/ext/odbc и psqlODBC 18.00 на отдельной локальной учебной базе PostgreSQL 18.6. Реквизиты передаются переменными окружения; рабочие пароли и данные в пример не входят. Таблицы с префиксом phpman_ создаются только для этого запуска и удаляются в finally.

<?php
declare(strict_types=1);

require __DIR__ . '/uodbc-bootstrap.php';

$connection = uodbcConnect();
$result = odbc_do($connection, "SELECT 'legacy-alias' AS label");
if ($result === false) { throw new RuntimeException(odbc_errormsg($connection)); }
echo odbc_result($result, 'label'), "\n";
odbc_close($connection);

legacy-alias

odbc_do — настоящий alias odbc_exec, а не отдельный способ выполнения. Пример выполнен через PHP 8.5.11/ext/odbc и psqlODBC 18.00 на отдельной локальной учебной базе PostgreSQL 18.6. Реквизиты передаются переменными окружения; рабочие пароли и данные в пример не входят. Таблицы с префиксом phpman_ создаются только для этого запуска и удаляются в finally.

<?php
declare(strict_types=1);

require __DIR__ . '/uodbc-bootstrap.php';

$connection = uodbcConnect();
uodbcDrop($connection, 'phpman_do_status');
try {
    uodbcExec($connection, 'CREATE TABLE phpman_do_status (id INTEGER PRIMARY KEY, state VARCHAR(20))');
    uodbcExec($connection, "INSERT INTO phpman_do_status VALUES (1, 'new')");
    $result = odbc_do($connection, "UPDATE phpman_do_status SET state='sent' WHERE id=1");
    if ($result === false) { throw new RuntimeException(odbc_errormsg($connection)); }
    echo "changed=", odbc_num_rows($result), "\n";
} finally {
    uodbcDrop($connection, 'phpman_do_status');
    odbc_close($connection);
}

changed=1

Пример помогает читать legacy-код; в новом коде одно название odbc_exec уменьшает лишние варианты. Пример выполнен через PHP 8.5.11/ext/odbc и psqlODBC 18.00 на отдельной локальной учебной базе PostgreSQL 18.6. Реквизиты передаются переменными окружения; рабочие пароли и данные в пример не входят. Таблицы с префиксом phpman_ создаются только для этого запуска и удаляются в finally.

<?php
declare(strict_types=1);

require __DIR__ . '/uodbc-bootstrap.php';

$connection = uodbcConnect();
uodbcDrop($connection, 'phpman_prepare_product');
try {
    uodbcExec($connection, 'CREATE TABLE phpman_prepare_product (id INTEGER PRIMARY KEY, name VARCHAR(50))');
    uodbcExec($connection, "INSERT INTO phpman_prepare_product VALUES (1, 'Pen'), (2, 'Book')");
    $statement = odbc_prepare($connection, 'SELECT name FROM phpman_prepare_product WHERE id=CAST(? AS INTEGER)');
    if ($statement === false) { throw new RuntimeException(odbc_errormsg($connection)); }
    odbc_execute($statement, [2]);
    $row = odbc_fetch_array($statement);
    echo $row['name'], "\n";
} finally {
    uodbcDrop($connection, 'phpman_prepare_product');
    odbc_close($connection);
}

Book

SQL-компоновка и значение id разделены. CAST делает ожидаемый тип placeholder явным для разных драйверов. Пример выполнен через PHP 8.5.11/ext/odbc и psqlODBC 18.00 на отдельной локальной учебной базе PostgreSQL 18.6. Реквизиты передаются переменными окружения; рабочие пароли и данные в пример не входят. Таблицы с префиксом phpman_ создаются только для этого запуска и удаляются в finally.

<?php
declare(strict_types=1);

require __DIR__ . '/uodbc-bootstrap.php';

$connection = uodbcConnect();
$statement = odbc_prepare($connection, 'SELECT CAST(? AS INTEGER) * 2 AS doubled');
if ($statement === false) { throw new RuntimeException(odbc_errormsg($connection)); }
foreach ([3, 8] as $value) {
    if (!odbc_execute($statement, [$value])) { throw new RuntimeException(odbc_errormsg($connection)); }
    $row = odbc_fetch_array($statement);
    echo $row['doubled'], "\n";
}
odbc_close($connection);

6
16

Повторное execute меняет данные, а SQL-контракт остаётся одним. Выигрыш зависит от драйвера и числа повторов; измеряйте. Пример выполнен через PHP 8.5.11/ext/odbc и psqlODBC 18.00 на отдельной локальной учебной базе PostgreSQL 18.6. Реквизиты передаются переменными окружения; рабочие пароли и данные в пример не входят. Таблицы с префиксом phpman_ создаются только для этого запуска и удаляются в finally.

<?php
declare(strict_types=1);

require __DIR__ . '/uodbc-bootstrap.php';

$connection = uodbcConnect();
uodbcDrop($connection, 'phpman_execute_item');
try {
    uodbcExec($connection, 'CREATE TABLE phpman_execute_item (id INTEGER PRIMARY KEY, name VARCHAR(50))');
    $statement = odbc_prepare($connection, 'INSERT INTO phpman_execute_item (id, name) VALUES (CAST(? AS INTEGER), ?)');
    if ($statement === false) { throw new RuntimeException(odbc_errormsg($connection)); }
    foreach ([[1, 'Pen'], [2, 'Notebook']] as $params) {
        if (!@odbc_execute($statement, $params)) { throw new RuntimeException(odbc_errormsg($connection)); }
    }
    $result = uodbcExec($connection, 'SELECT COUNT(*) AS total FROM phpman_execute_item');
    echo "rows=", odbc_result($result, 'total'), "\n";
} finally {
    uodbcDrop($connection, 'phpman_execute_item');
    odbc_close($connection);
}

rows=2

Массив params идёт строго слева направо. Значения не получают SQL-кавычки в PHP. psqlODBC может дополнительно выдать SQLSTATE класса 01 (warning, например 01S02 о смене cursor updatability) при успешном true; production-код пишет такую диагностику отдельно, не превращая её автоматически в отказ. Пример выполнен через PHP 8.5.11/ext/odbc и psqlODBC 18.00 на отдельной локальной учебной базе PostgreSQL 18.6. Реквизиты передаются переменными окружения; рабочие пароли и данные в пример не входят. Таблицы с префиксом phpman_ создаются только для этого запуска и удаляются в finally.

<?php
declare(strict_types=1);

require __DIR__ . '/uodbc-bootstrap.php';

$connection = uodbcConnect();
uodbcDrop($connection, 'phpman_execute_customer');
try {
    uodbcExec($connection, 'CREATE TABLE phpman_execute_customer (id INTEGER PRIMARY KEY, name VARCHAR(50))');
    $statement = odbc_prepare($connection, 'INSERT INTO phpman_execute_customer VALUES (1, ?)');
    if ($statement === false || !@odbc_execute($statement, ["O'Reilly"])) {
        throw new RuntimeException(odbc_errormsg($connection));
    }
    $row = uodbcExec($connection, 'SELECT name FROM phpman_execute_customer WHERE id=1');
    echo odbc_result($row, 'name'), "\n";
} finally {
    uodbcDrop($connection, 'phpman_execute_customer');
    odbc_close($connection);
}

O'Reilly

Апостроф внутри обычной строки — данные. Особая legacy-граница ext/odbc: строка, которая целиком начинается и заканчивается одинарной кавычкой, трактуется как имя файла; такие значения надо отдельно запрещать/нормализовать и не передавать из недоверенного ввода. Пример выполнен через PHP 8.5.11/ext/odbc и psqlODBC 18.00 на отдельной локальной учебной базе PostgreSQL 18.6. Реквизиты передаются переменными окружения; рабочие пароли и данные в пример не входят. Таблицы с префиксом phpman_ создаются только для этого запуска и удаляются в finally.

<?php
declare(strict_types=1);

require __DIR__ . '/uodbc-bootstrap.php';

$connection = uodbcConnect();
$result = uodbcExec($connection, 'SELECT 1 AS step; SELECT 2 AS step');
do {
    $row = odbc_fetch_array($result);
    echo "step=", $row['step'], "\n";
} while (odbc_next_result($result));
odbc_close($connection);

step=1
step=2

После полного чтения текущего результата next_result переводит тот же объект на следующий набор. Пример выполнен через PHP 8.5.11/ext/odbc и psqlODBC 18.00 на отдельной локальной учебной базе PostgreSQL 18.6. Реквизиты передаются переменными окружения; рабочие пароли и данные в пример не входят. Таблицы с префиксом phpman_ создаются только для этого запуска и удаляются в finally.

<?php
declare(strict_types=1);

require __DIR__ . '/uodbc-bootstrap.php';

$connection = uodbcConnect();
$result = uodbcExec($connection, 'SELECT 7 AS value');
$row = odbc_fetch_array($result);
echo "value=", $row['value'], "\n";
echo odbc_next_result($result) ? "more\n" : "done\n";
odbc_close($connection);

value=7
done

false здесь означает, что следующего result set нет. Ошибку отличают по SQLSTATE/сообщению и контексту вызова. Пример выполнен через PHP 8.5.11/ext/odbc и psqlODBC 18.00 на отдельной локальной учебной базе PostgreSQL 18.6. Реквизиты передаются переменными окружения; рабочие пароли и данные в пример не входят. Таблицы с префиксом phpman_ создаются только для этого запуска и удаляются в finally.

<?php
declare(strict_types=1);

require __DIR__ . '/uodbc-bootstrap.php';

$connection = uodbcConnect();
$result = uodbcExec($connection, "SELECT * FROM (VALUES (1, 'Pen'), (2, 'Book')) AS products(id, name) ORDER BY id");
while ($row = odbc_fetch_array($result)) {
    echo $row['id'], ':', $row['name'], "\n";
}
odbc_close($connection);

1:Pen
2:Book

Каждый fetch возвращает новую строку как массив «имя столбца => значение»; false завершает цикл. Пример выполнен через PHP 8.5.11/ext/odbc и psqlODBC 18.00 на отдельной локальной учебной базе PostgreSQL 18.6. Реквизиты передаются переменными окружения; рабочие пароли и данные в пример не входят. Таблицы с префиксом phpman_ создаются только для этого запуска и удаляются в finally.

<?php
declare(strict_types=1);

require __DIR__ . '/uodbc-bootstrap.php';

$connection = uodbcConnect();
$result = uodbcExec($connection, "SELECT * FROM (VALUES (10, 'A'), (20, 'B'), (30, 'C')) AS items(id, code) ORDER BY id");
$row = odbc_fetch_array($result, 3);
echo $row['id'], ':', $row['code'], "\n";
odbc_close($connection);

30:C

ODBC row_number начинается с 1. Произвольное позиционирование зависит от курсора/драйвера; последовательный цикл переносимее. Пример выполнен через PHP 8.5.11/ext/odbc и psqlODBC 18.00 на отдельной локальной учебной базе PostgreSQL 18.6. Реквизиты передаются переменными окружения; рабочие пароли и данные в пример не входят. Таблицы с префиксом phpman_ создаются только для этого запуска и удаляются в finally.

<?php
declare(strict_types=1);

require __DIR__ . '/uodbc-bootstrap.php';

$connection = uodbcConnect();
$result = uodbcExec($connection, "SELECT 5 AS id, 'Cable' AS name");
$row = odbc_fetch_object($result);
if ($row === false) { throw new RuntimeException('Строка не найдена'); }
echo $row->id, ':', $row->name, "\n";
odbc_close($connection);

5:Cable

Возвращается stdClass, а не объект предметной модели: в нём нет валидации и методов товара. Пример выполнен через PHP 8.5.11/ext/odbc и psqlODBC 18.00 на отдельной локальной учебной базе PostgreSQL 18.6. Реквизиты передаются переменными окружения; рабочие пароли и данные в пример не входят. Таблицы с префиксом phpman_ создаются только для этого запуска и удаляются в finally.

<?php
declare(strict_types=1);

require __DIR__ . '/uodbc-bootstrap.php';

$connection = uodbcConnect();
$result = uodbcExec($connection, "SELECT 'INV-7' AS number, CAST(1250 AS INTEGER) AS total");
$row = odbc_fetch_object($result);
$payload = $row === false ? null : ['number' => $row->number, 'total' => (int) $row->total];
echo json_encode($payload, JSON_UNESCAPED_UNICODE), "\n";
odbc_close($connection);

{"number":"INV-7","total":1250}

Явное преобразование фиксирует внешнюю схему и тип total; не отдавайте произвольный row object напрямую как публичный API. Пример выполнен через PHP 8.5.11/ext/odbc и psqlODBC 18.00 на отдельной локальной учебной базе PostgreSQL 18.6. Реквизиты передаются переменными окружения; рабочие пароли и данные в пример не входят. Таблицы с префиксом phpman_ создаются только для этого запуска и удаляются в finally.

<?php
declare(strict_types=1);

require __DIR__ . '/uodbc-bootstrap.php';

$connection = uodbcConnect();
$result = uodbcExec($connection, "SELECT 4 AS id, 'Box' AS name");
$values = [];
$count = odbc_fetch_into($result, $values);
echo "fields={$count}\n";
echo $values[0], ':', $values[1], "\n";
odbc_close($connection);

fields=2
4:Box

Функция изменяет второй аргумент по ссылке и возвращает число полей; индексы массива начинаются с 0. Пример выполнен через PHP 8.5.11/ext/odbc и psqlODBC 18.00 на отдельной локальной учебной базе PostgreSQL 18.6. Реквизиты передаются переменными окружения; рабочие пароли и данные в пример не входят. Таблицы с префиксом phpman_ создаются только для этого запуска и удаляются в finally.

<?php
declare(strict_types=1);

require __DIR__ . '/uodbc-bootstrap.php';

$connection = uodbcConnect();
$result = uodbcExec($connection, "SELECT * FROM (VALUES (1, 100), (2, 250)) AS lines(id, amount) ORDER BY id");
$values = [];
$sum = 0;
while (odbc_fetch_into($result, $values) !== false) {
    $sum += (int) $values[1];
}
echo "sum={$sum}\n";
odbc_close($connection);

sum=350

На каждой итерации массив получает текущую строку; это не загружает весь result в один PHP-массив. Пример выполнен через PHP 8.5.11/ext/odbc и psqlODBC 18.00 на отдельной локальной учебной базе PostgreSQL 18.6. Реквизиты передаются переменными окружения; рабочие пароли и данные в пример не входят. Таблицы с префиксом phpman_ создаются только для этого запуска и удаляются в finally.

<?php
declare(strict_types=1);

require __DIR__ . '/uodbc-bootstrap.php';

$connection = uodbcConnect();
$result = uodbcExec($connection, "SELECT * FROM (VALUES (1, 'new'), (2, 'paid')) AS orders(id, state) ORDER BY id");
while (odbc_fetch_row($result)) {
    echo odbc_result($result, 'id'), ':', odbc_result($result, 'state'), "\n";
}
odbc_close($connection);

1:new
2:paid

fetch_row только позиционирует курсор; каждое поле затем извлекается odbc_result(). Пример выполнен через PHP 8.5.11/ext/odbc и psqlODBC 18.00 на отдельной локальной учебной базе PostgreSQL 18.6. Реквизиты передаются переменными окружения; рабочие пароли и данные в пример не входят. Таблицы с префиксом phpman_ создаются только для этого запуска и удаляются в finally.

<?php
declare(strict_types=1);

require __DIR__ . '/uodbc-bootstrap.php';

$connection = uodbcConnect();
$result = uodbcExec($connection, "SELECT * FROM (VALUES (10), (20), (30)) AS valueset(value) ORDER BY value");
if (!odbc_fetch_row($result, 2)) { throw new RuntimeException('Нет строки 2'); }
echo odbc_result($result, 1), "\n";
odbc_close($connection);

20

Номер строки начинается с 1. Некоторые драйверы/forward-only курсоры произвольный переход не поддерживают. Пример выполнен через PHP 8.5.11/ext/odbc и psqlODBC 18.00 на отдельной локальной учебной базе PostgreSQL 18.6. Реквизиты передаются переменными окружения; рабочие пароли и данные в пример не входят. Таблицы с префиксом phpman_ создаются только для этого запуска и удаляются в finally.

<?php
declare(strict_types=1);

require __DIR__ . '/uodbc-bootstrap.php';

$connection = uodbcConnect();
$result = uodbcExec($connection, "SELECT 12 AS id, 'Ready' AS state");
odbc_fetch_row($result);
echo odbc_result($result, 'id'), "\n";
echo odbc_result($result, 2), "\n";
odbc_close($connection);

12
Ready

Имя устойчивее порядка SELECT; числовая позиция ODBC начинается с 1. Пример выполнен через PHP 8.5.11/ext/odbc и psqlODBC 18.00 на отдельной локальной учебной базе PostgreSQL 18.6. Реквизиты передаются переменными окружения; рабочие пароли и данные в пример не входят. Таблицы с префиксом phpman_ создаются только для этого запуска и удаляются в finally.

<?php
declare(strict_types=1);

require __DIR__ . '/uodbc-bootstrap.php';

$connection = uodbcConnect();
$result = uodbcExec($connection, "SELECT CAST(NULL AS VARCHAR(20)) AS note, CAST('' AS VARCHAR(20)) AS empty_text");
odbc_fetch_row($result);
echo odbc_result($result, 'note') === null ? "note=NULL\n" : "note=value\n";
echo odbc_result($result, 'empty_text') === '' ? "empty=string\n" : "empty=other\n";
odbc_close($connection);

note=NULL
empty=string

SQL NULL приходит как null, пустая строка остаётся строкой: проверки должны быть строгими. Пример выполнен через PHP 8.5.11/ext/odbc и psqlODBC 18.00 на отдельной локальной учебной базе PostgreSQL 18.6. Реквизиты передаются переменными окружения; рабочие пароли и данные в пример не входят. Таблицы с префиксом phpman_ создаются только для этого запуска и удаляются в finally.

<?php
declare(strict_types=1);

require __DIR__ . '/uodbc-bootstrap.php';

$connection = uodbcConnect();
$result = uodbcExec($connection, "SELECT * FROM (VALUES (1, 'Pen'), (2, 'Book')) AS products(id, name) ORDER BY id");
ob_start();
$rows = @odbc_result_all($result);
$html = (string) ob_get_clean();
echo "rows={$rows}\n";
echo str_contains($html, '<table') && str_contains($html, 'Pen') ? "html=yes\n" : "html=no\n";
odbc_close($connection);

rows=2
html=yes

Функция печатает HTML сама; output buffering лишь позволяет увидеть это поведение. Для нового интерфейса лучше собственный шаблон с htmlspecialchars(). Пример выполнен через PHP 8.5.11/ext/odbc и psqlODBC 18.00 на отдельной локальной учебной базе PostgreSQL 18.6. Реквизиты передаются переменными окружения; рабочие пароли и данные в пример не входят. Таблицы с префиксом phpman_ создаются только для этого запуска и удаляются в finally.

<?php
declare(strict_types=1);

require __DIR__ . '/uodbc-bootstrap.php';

$connection = uodbcConnect();
$result = uodbcExec($connection, "SELECT 'safe' AS value");
ob_start();
$rows = @odbc_result_all($result, 'class="report"');
$html = (string) ob_get_clean();
echo "rows={$rows}\n";
echo str_contains($html, 'class="report"') ? "class=yes\n" : "class=no\n";
odbc_close($connection);

rows=1
class=yes

format попадает в HTML-атрибуты без современного шаблонного контракта; недоверенный ввод сюда передавать нельзя. Пример выполнен через PHP 8.5.11/ext/odbc и psqlODBC 18.00 на отдельной локальной учебной базе PostgreSQL 18.6. Реквизиты передаются переменными окружения; рабочие пароли и данные в пример не входят. Таблицы с префиксом phpman_ создаются только для этого запуска и удаляются в finally.

<?php
declare(strict_types=1);

require __DIR__ . '/uodbc-bootstrap.php';

$connection = uodbcConnect();
$result = uodbcExec($connection, 'SELECT 1 AS id');
$row = odbc_fetch_array($result);
echo $row['id'], "\n";
echo odbc_free_result($result) ? "freed\n" : "not-freed\n";
try { odbc_fetch_array($result); } catch (Error) { echo "unusable\n"; }
odbc_close($connection);

1
freed
unusable

После free тот же Odbc\Result закрыт и больше не читается. Пример выполнен через PHP 8.5.11/ext/odbc и psqlODBC 18.00 на отдельной локальной учебной базе PostgreSQL 18.6. Реквизиты передаются переменными окружения; рабочие пароли и данные в пример не входят. Таблицы с префиксом phpman_ создаются только для этого запуска и удаляются в finally.

<?php
declare(strict_types=1);

require __DIR__ . '/uodbc-bootstrap.php';

$connection = uodbcConnect();
$result = uodbcExec($connection, 'SELECT generate_series(1, 100) AS id');
odbc_fetch_row($result);
echo "first=", odbc_result($result, 1), "\n";
odbc_free_result($result);
echo "released-early\n";
odbc_close($connection);

first=1
released-early

Если остальные строки не нужны, явное освобождение снижает время владения клиентским курсором/буфером. Пример выполнен через PHP 8.5.11/ext/odbc и psqlODBC 18.00 на отдельной локальной учебной базе PostgreSQL 18.6. Реквизиты передаются переменными окружения; рабочие пароли и данные в пример не входят. Таблицы с префиксом phpman_ создаются только для этого запуска и удаляются в finally.

<?php
declare(strict_types=1);

require __DIR__ . '/uodbc-bootstrap.php';

$connection = uodbcConnect();
uodbcDrop($connection, 'phpman_num_rows');
try {
    uodbcExec($connection, 'CREATE TABLE phpman_num_rows (id INTEGER PRIMARY KEY, state VARCHAR(20))');
    uodbcExec($connection, "INSERT INTO phpman_num_rows VALUES (1, 'new'), (2, 'new')");
    $result = uodbcExec($connection, "UPDATE phpman_num_rows SET state='sent' WHERE id=2");
    echo "changed=", odbc_num_rows($result), "\n";
} finally {
    uodbcDrop($connection, 'phpman_num_rows');
    odbc_close($connection);
}

changed=1

Для DML число затронутых строк помогает проверить ожидаемый эффект. Пример выполнен через PHP 8.5.11/ext/odbc и psqlODBC 18.00 на отдельной локальной учебной базе PostgreSQL 18.6. Реквизиты передаются переменными окружения; рабочие пароли и данные в пример не входят. Таблицы с префиксом phpman_ создаются только для этого запуска и удаляются в finally.

<?php
declare(strict_types=1);

require __DIR__ . '/uodbc-bootstrap.php';

$connection = uodbcConnect();
uodbcDrop($connection, 'phpman_num_rows_delete');
try {
    uodbcExec($connection, 'CREATE TABLE phpman_num_rows_delete (id INTEGER PRIMARY KEY)');
    uodbcExec($connection, 'INSERT INTO phpman_num_rows_delete VALUES (1)');
    $result = uodbcExec($connection, 'DELETE FROM phpman_num_rows_delete WHERE id=99');
    echo "deleted=", odbc_num_rows($result), "\n";
} finally {
    uodbcDrop($connection, 'phpman_num_rows_delete');
    odbc_close($connection);
}

deleted=0

Ноль — корректный результат «строка не найдена», а не автоматически ошибка. Пример выполнен через PHP 8.5.11/ext/odbc и psqlODBC 18.00 на отдельной локальной учебной базе PostgreSQL 18.6. Реквизиты передаются переменными окружения; рабочие пароли и данные в пример не входят. Таблицы с префиксом phpman_ создаются только для этого запуска и удаляются в finally.

<?php
declare(strict_types=1);

require __DIR__ . '/uodbc-bootstrap.php';

$connection = uodbcConnect();
$result = uodbcExec($connection, "SELECT 1 AS id, 'Pen' AS name, 120 AS price");
echo "fields=", odbc_num_fields($result), "\n";
odbc_close($connection);

fields=3

Число колонок доступно до чтения строк и помогает построить диагностический экспорт. Пример выполнен через PHP 8.5.11/ext/odbc и psqlODBC 18.00 на отдельной локальной учебной базе PostgreSQL 18.6. Реквизиты передаются переменными окружения; рабочие пароли и данные в пример не входят. Таблицы с префиксом phpman_ создаются только для этого запуска и удаляются в finally.

<?php
declare(strict_types=1);

require __DIR__ . '/uodbc-bootstrap.php';

$connection = uodbcConnect();
$result = uodbcExec($connection, 'SELECT COUNT(*) AS total FROM pg_catalog.pg_class');
echo odbc_num_fields($result), "\n";
odbc_close($connection);

1

Количество исходных строк не связано с числом колонок агрегатного result. Пример выполнен через PHP 8.5.11/ext/odbc и psqlODBC 18.00 на отдельной локальной учебной базе PostgreSQL 18.6. Реквизиты передаются переменными окружения; рабочие пароли и данные в пример не входят. Таблицы с префиксом phpman_ создаются только для этого запуска и удаляются в finally.

<?php
declare(strict_types=1);

require __DIR__ . '/uodbc-bootstrap.php';

$connection = uodbcConnect();
$result = uodbcExec($connection, "SELECT 1 AS product_id, 'Pen' AS product_name");
for ($field = 1; $field <= odbc_num_fields($result); $field++) {
    echo $field, ':', odbc_field_name($result, $field), "\n";
}
odbc_close($connection);

1:product_id
2:product_name

SQL aliases становятся понятными заголовками результата. Пример выполнен через PHP 8.5.11/ext/odbc и psqlODBC 18.00 на отдельной локальной учебной базе PostgreSQL 18.6. Реквизиты передаются переменными окружения; рабочие пароли и данные в пример не входят. Таблицы с префиксом phpman_ создаются только для этого запуска и удаляются в finally.

<?php
declare(strict_types=1);

require __DIR__ . '/uodbc-bootstrap.php';

$connection = uodbcConnect();
$result = uodbcExec($connection, "SELECT 'INV-1' AS invoice_number, 500 AS total_kopecks");
$headers = [];
for ($field = 1; $field <= odbc_num_fields($result); $field++) {
    $headers[] = odbc_field_name($result, $field);
}
echo implode(',', $headers), "\n";
odbc_close($connection);

invoice_number,total_kopecks

Техническое имя не всегда подходит человеку: публичные подписи лучше брать из собственной карты перевода. Пример выполнен через PHP 8.5.11/ext/odbc и psqlODBC 18.00 на отдельной локальной учебной базе PostgreSQL 18.6. Реквизиты передаются переменными окружения; рабочие пароли и данные в пример не входят. Таблицы с префиксом phpman_ создаются только для этого запуска и удаляются в finally.

<?php
declare(strict_types=1);

require __DIR__ . '/uodbc-bootstrap.php';

$connection = uodbcConnect();
$result = uodbcExec($connection, "SELECT CAST(12 AS INTEGER) AS id, CAST('abc' AS VARCHAR(20)) AS label, CAST(12.34 AS NUMERIC(8,2)) AS amount");
for ($field = 1; $field <= 3; $field++) { echo odbc_field_type($result, $field), "\n"; }
odbc_close($connection);

int4
varchar
numeric

Имена int4/varchar/numeric — представление psqlODBC; другой драйвер может назвать тип иначе. Пример выполнен через PHP 8.5.11/ext/odbc и psqlODBC 18.00 на отдельной локальной учебной базе PostgreSQL 18.6. Реквизиты передаются переменными окружения; рабочие пароли и данные в пример не входят. Таблицы с префиксом phpman_ создаются только для этого запуска и удаляются в finally.

<?php
declare(strict_types=1);

require __DIR__ . '/uodbc-bootstrap.php';

$connection = uodbcConnect();
$result = uodbcExec($connection, "SELECT CAST(12.34 AS NUMERIC(8,2)) AS amount");
$type = strtolower((string) odbc_field_type($result, 1));
$kind = str_contains($type, 'numeric') || str_contains($type, 'decimal') ? 'number' : 'text';
echo "kind={$kind}\n";
odbc_close($connection);

kind=number

Для кросс-драйверного кода нужна карта семейств и fallback, а не один жёсткий vendor-name. Пример выполнен через PHP 8.5.11/ext/odbc и psqlODBC 18.00 на отдельной локальной учебной базе PostgreSQL 18.6. Реквизиты передаются переменными окружения; рабочие пароли и данные в пример не входят. Таблицы с префиксом phpman_ создаются только для этого запуска и удаляются в finally.

<?php
declare(strict_types=1);

require __DIR__ . '/uodbc-bootstrap.php';

$connection = uodbcConnect();
$result = uodbcExec($connection, "SELECT CAST(7 AS INTEGER) AS id, CAST('abc' AS VARCHAR(20)) AS label");
echo "id=", odbc_field_len($result, 1), "\n";
echo "label=", odbc_field_len($result, 2), "\n";
odbc_close($connection);

id=10
label=20

Для psqlODBC INTEGER сообщает display/precision 10, VARCHAR(20) — 20. Это descriptor, не strlen текущего значения. Пример выполнен через PHP 8.5.11/ext/odbc и psqlODBC 18.00 на отдельной локальной учебной базе PostgreSQL 18.6. Реквизиты передаются переменными окружения; рабочие пароли и данные в пример не входят. Таблицы с префиксом phpman_ создаются только для этого запуска и удаляются в finally.

<?php
declare(strict_types=1);

require __DIR__ . '/uodbc-bootstrap.php';

$connection = uodbcConnect();
$result = uodbcExec($connection, "SELECT CAST('abc' AS VARCHAR(20)) AS label");
$row = odbc_fetch_array($result);
echo "declared=", odbc_field_len($result, 1), " actual=", strlen($row['label']), "\n";
odbc_close($connection);

declared=20 actual=3

Поле допускает до 20 единиц по договору драйвера, но конкретное значение содержит три байта. Пример выполнен через PHP 8.5.11/ext/odbc и psqlODBC 18.00 на отдельной локальной учебной базе PostgreSQL 18.6. Реквизиты передаются переменными окружения; рабочие пароли и данные в пример не входят. Таблицы с префиксом phpman_ создаются только для этого запуска и удаляются в finally.

<?php
declare(strict_types=1);

require __DIR__ . '/uodbc-bootstrap.php';

$connection = uodbcConnect();
$result = uodbcExec($connection, 'SELECT CAST(1234.56 AS NUMERIC(8,2)) AS amount');
echo "precision=", odbc_field_precision($result, 1), "\n";
odbc_close($connection);

precision=8

Precision 8 — общее число десятичных цифр, не число знаков после точки. Пример выполнен через PHP 8.5.11/ext/odbc и psqlODBC 18.00 на отдельной локальной учебной базе PostgreSQL 18.6. Реквизиты передаются переменными окружения; рабочие пароли и данные в пример не входят. Таблицы с префиксом phpman_ создаются только для этого запуска и удаляются в finally.

<?php
declare(strict_types=1);

require __DIR__ . '/uodbc-bootstrap.php';

$connection = uodbcConnect();
$result = uodbcExec($connection, "SELECT CAST('abc' AS VARCHAR(20)) AS label");
$a = odbc_field_precision($result, 1);
$b = odbc_field_len($result, 1);
echo $a === $b ? "same=20\n" : "different\n";
odbc_close($connection);

same=20

В php-src odbc_field_precision — alias odbc_field_len; имя precision не делает отдельного вычисления. Пример выполнен через PHP 8.5.11/ext/odbc и psqlODBC 18.00 на отдельной локальной учебной базе PostgreSQL 18.6. Реквизиты передаются переменными окружения; рабочие пароли и данные в пример не входят. Таблицы с префиксом phpman_ создаются только для этого запуска и удаляются в finally.

<?php
declare(strict_types=1);

require __DIR__ . '/uodbc-bootstrap.php';

$connection = uodbcConnect();
$result = uodbcExec($connection, 'SELECT CAST(12.34 AS NUMERIC(8,2)) AS amount');
echo "scale=", odbc_field_scale($result, 1), "\n";
odbc_close($connection);

scale=2

NUMERIC(8,2) разрешает две десятичные цифры справа от разделителя. Пример выполнен через PHP 8.5.11/ext/odbc и psqlODBC 18.00 на отдельной локальной учебной базе PostgreSQL 18.6. Реквизиты передаются переменными окружения; рабочие пароли и данные в пример не входят. Таблицы с префиксом phpman_ создаются только для этого запуска и удаляются в finally.

<?php
declare(strict_types=1);

require __DIR__ . '/uodbc-bootstrap.php';

$connection = uodbcConnect();
$result = uodbcExec($connection, 'SELECT CAST(7 AS INTEGER) AS qty, CAST(7.50 AS NUMERIC(8,2)) AS price');
echo odbc_field_scale($result, 1), ':', odbc_field_scale($result, 2), "\n";
odbc_close($connection);

0:2

Ноль у INTEGER — нормальный scale, не ошибка. Пример выполнен через PHP 8.5.11/ext/odbc и psqlODBC 18.00 на отдельной локальной учебной базе PostgreSQL 18.6. Реквизиты передаются переменными окружения; рабочие пароли и данные в пример не входят. Таблицы с префиксом phpman_ создаются только для этого запуска и удаляются в finally.

<?php
declare(strict_types=1);

require __DIR__ . '/uodbc-bootstrap.php';

$connection = uodbcConnect();
$result = uodbcExec($connection, "SELECT 1 AS id, 'Pen' AS name, 100 AS price");
echo "name-field=", odbc_field_num($result, 'name'), "\n";
odbc_close($connection);

name-field=2

Позиция ODBC начинается с 1. Пример выполнен через PHP 8.5.11/ext/odbc и psqlODBC 18.00 на отдельной локальной учебной базе PostgreSQL 18.6. Реквизиты передаются переменными окружения; рабочие пароли и данные в пример не входят. Таблицы с префиксом phpman_ создаются только для этого запуска и удаляются в finally.

<?php
declare(strict_types=1);

require __DIR__ . '/uodbc-bootstrap.php';

$connection = uodbcConnect();
$result = uodbcExec($connection, 'SELECT 1 AS id');
$position = odbc_field_num($result, 'external_code');
echo $position === false ? "column-missing\n" : "column={$position}\n";
odbc_close($connection);

column-missing

false — сигнал несовпадения ожидаемой схемы; не подменяйте его позицией 0, которой в ODBC field API нет. Пример выполнен через PHP 8.5.11/ext/odbc и psqlODBC 18.00 на отдельной локальной учебной базе PostgreSQL 18.6. Реквизиты передаются переменными окружения; рабочие пароли и данные в пример не входят. Таблицы с префиксом phpman_ создаются только для этого запуска и удаляются в finally.

<?php
declare(strict_types=1);

require __DIR__ . '/uodbc-bootstrap.php';

$connection = uodbcConnect();
echo "before=", odbc_autocommit($connection) ? 'on' : 'off', "\n";
odbc_autocommit($connection, false);
echo "inside=", odbc_autocommit($connection) ? 'on' : 'off', "\n";
odbc_rollback($connection);
odbc_autocommit($connection, true);
echo "after=", odbc_autocommit($connection) ? 'on' : 'off', "\n";
odbc_close($connection);

before=on
inside=off
after=on

null/отсутствующий enable читает состояние; false начинает явную транзакцию; после rollback режим возвращён для следующего кода. Пример выполнен через PHP 8.5.11/ext/odbc и psqlODBC 18.00 на отдельной локальной учебной базе PostgreSQL 18.6. Реквизиты передаются переменными окружения; рабочие пароли и данные в пример не входят. Таблицы с префиксом phpman_ создаются только для этого запуска и удаляются в finally.

<?php
declare(strict_types=1);

require __DIR__ . '/uodbc-bootstrap.php';

$connection = uodbcConnect();
uodbcDrop($connection, 'phpman_autocommit_order');
uodbcExec($connection, 'CREATE TABLE phpman_autocommit_order (id INTEGER PRIMARY KEY, state VARCHAR(20))');
odbc_autocommit($connection, false);
try {
    uodbcExec($connection, "INSERT INTO phpman_autocommit_order VALUES (1, 'new')");
    uodbcExec($connection, "UPDATE phpman_autocommit_order SET state='paid' WHERE id=1");
    odbc_commit($connection);
    $row = uodbcExec($connection, 'SELECT state FROM phpman_autocommit_order WHERE id=1');
    echo odbc_result($row, 'state'), "\n";
} finally {
    if (!odbc_autocommit($connection)) { odbc_rollback($connection); }
    odbc_autocommit($connection, true);
    uodbcDrop($connection, 'phpman_autocommit_order');
    odbc_close($connection);
}

paid

Отключение autocommit объединяет INSERT и UPDATE. finally возвращает состояние соединения и удаляет только учебную таблицу. Пример выполнен через PHP 8.5.11/ext/odbc и psqlODBC 18.00 на отдельной локальной учебной базе PostgreSQL 18.6. Реквизиты передаются переменными окружения; рабочие пароли и данные в пример не входят. Таблицы с префиксом phpman_ создаются только для этого запуска и удаляются в finally.

<?php
declare(strict_types=1);

require __DIR__ . '/uodbc-bootstrap.php';

$connection = uodbcConnect();
uodbcDrop($connection, 'phpman_commit_order');
uodbcExec($connection, 'CREATE TABLE phpman_commit_order (id INTEGER PRIMARY KEY, total INTEGER)');
odbc_autocommit($connection, false);
try {
    uodbcExec($connection, 'INSERT INTO phpman_commit_order VALUES (10, 2500)');
    echo odbc_commit($connection) ? "committed\n" : "commit-failed\n";
    $row = uodbcExec($connection, 'SELECT total FROM phpman_commit_order WHERE id=10');
    echo "total=", odbc_result($row, 'total'), "\n";
} finally {
    odbc_autocommit($connection, true);
    uodbcDrop($connection, 'phpman_commit_order');
    odbc_close($connection);
}

committed
total=2500

Возврат true фиксирует pending-изменения текущего соединения; контрольный SELECT показывает сохранённое состояние. Пример выполнен через PHP 8.5.11/ext/odbc и psqlODBC 18.00 на отдельной локальной учебной базе PostgreSQL 18.6. Реквизиты передаются переменными окружения; рабочие пароли и данные в пример не входят. Таблицы с префиксом phpman_ создаются только для этого запуска и удаляются в finally.

<?php
declare(strict_types=1);

require __DIR__ . '/uodbc-bootstrap.php';

$connection = uodbcConnect();
uodbcDrop($connection, 'phpman_commit_event');
uodbcDrop($connection, 'phpman_commit_invoice');
uodbcExec($connection, 'CREATE TABLE phpman_commit_invoice (id INTEGER PRIMARY KEY)');
uodbcExec($connection, 'CREATE TABLE phpman_commit_event (invoice_id INTEGER, message VARCHAR(30))');
odbc_autocommit($connection, false);
try {
    uodbcExec($connection, 'INSERT INTO phpman_commit_invoice VALUES (7)');
    uodbcExec($connection, "INSERT INTO phpman_commit_event VALUES (7, 'created')");
    if (!odbc_commit($connection)) { throw new RuntimeException(odbc_errormsg($connection)); }
    $row = uodbcExec($connection, 'SELECT (SELECT COUNT(*) FROM phpman_commit_invoice) + (SELECT COUNT(*) FROM phpman_commit_event) AS total');
    echo "rows=", odbc_result($row, 'total'), "\n";
} finally {
    odbc_autocommit($connection, true);
    uodbcDrop($connection, 'phpman_commit_event');
    uodbcDrop($connection, 'phpman_commit_invoice');
    odbc_close($connection);
}

rows=2

Две таблицы меняются одной транзакцией; commit расположен только после успешного выполнения обоих шагов. Пример выполнен через PHP 8.5.11/ext/odbc и psqlODBC 18.00 на отдельной локальной учебной базе PostgreSQL 18.6. Реквизиты передаются переменными окружения; рабочие пароли и данные в пример не входят. Таблицы с префиксом phpman_ создаются только для этого запуска и удаляются в finally.

<?php
declare(strict_types=1);

require __DIR__ . '/uodbc-bootstrap.php';

$connection = uodbcConnect();
uodbcDrop($connection, 'phpman_rollback_order');
uodbcExec($connection, 'CREATE TABLE phpman_rollback_order (id INTEGER PRIMARY KEY)');
odbc_autocommit($connection, false);
try {
    uodbcExec($connection, 'INSERT INTO phpman_rollback_order VALUES (1)');
    echo odbc_rollback($connection) ? "rolled-back\n" : "rollback-failed\n";
    $row = uodbcExec($connection, 'SELECT COUNT(*) AS total FROM phpman_rollback_order');
    echo "rows=", odbc_result($row, 'total'), "\n";
} finally {
    odbc_autocommit($connection, true);
    uodbcDrop($connection, 'phpman_rollback_order');
    odbc_close($connection);
}

rolled-back
rows=0

Проверка числа строк подтверждает, что INSERT не вышел за границу транзакции. Пример выполнен через PHP 8.5.11/ext/odbc и psqlODBC 18.00 на отдельной локальной учебной базе PostgreSQL 18.6. Реквизиты передаются переменными окружения; рабочие пароли и данные в пример не входят. Таблицы с префиксом phpman_ создаются только для этого запуска и удаляются в finally.

<?php
declare(strict_types=1);

require __DIR__ . '/uodbc-bootstrap.php';

$connection = uodbcConnect();
uodbcDrop($connection, 'phpman_rollback_stock');
uodbcExec($connection, 'CREATE TABLE phpman_rollback_stock (id INTEGER PRIMARY KEY, qty INTEGER)');
uodbcExec($connection, 'INSERT INTO phpman_rollback_stock VALUES (1, 5)');
odbc_autocommit($connection, false);
try {
    uodbcExec($connection, 'UPDATE phpman_rollback_stock SET qty=qty-2 WHERE id=1');
    odbc_rollback($connection);
    $row = uodbcExec($connection, 'SELECT qty FROM phpman_rollback_stock WHERE id=1');
    echo "qty=", odbc_result($row, 'qty'), "\n";
} finally {
    odbc_autocommit($connection, true);
    uodbcDrop($connection, 'phpman_rollback_stock');
    odbc_close($connection);
}

qty=5

Rollback возвращает состояние до начала транзакции, если СУБД и таблица поддерживают транзакции. Пример выполнен через PHP 8.5.11/ext/odbc и psqlODBC 18.00 на отдельной локальной учебной базе PostgreSQL 18.6. Реквизиты передаются переменными окружения; рабочие пароли и данные в пример не входят. Таблицы с префиксом phpman_ создаются только для этого запуска и удаляются в finally.

<?php
declare(strict_types=1);

require __DIR__ . '/uodbc-bootstrap.php';

$connection = uodbcConnect();
$result = @odbc_exec($connection, 'SELECT * FROM phpman_missing_table');
if ($result === false) {
    echo odbc_error($connection), "\n";
}
odbc_close($connection);

42P01

42P01 — PostgreSQL SQLSTATE undefined_table. Другой драйвер может вернуть другой конкретный код, но класс 42 относится к синтаксису/доступу к объектам. Пример выполнен через PHP 8.5.11/ext/odbc и psqlODBC 18.00 на отдельной локальной учебной базе PostgreSQL 18.6. Реквизиты передаются переменными окружения; рабочие пароли и данные в пример не входят. Таблицы с префиксом phpman_ создаются только для этого запуска и удаляются в finally.

<?php
declare(strict_types=1);

require __DIR__ . '/uodbc-bootstrap.php';

$connection = uodbcConnect();
echo odbc_error($connection) === '' ? "no-error\n" : "has-error\n";
$ok = uodbcExec($connection, 'SELECT 1 AS ok');
echo odbc_result($ok, 'ok'), "\n";
odbc_close($connection);

no-error
1

Диагностика meaningful сразу после failed ODBC-call; на свежем соединении строка пуста. Пример выполнен через PHP 8.5.11/ext/odbc и psqlODBC 18.00 на отдельной локальной учебной базе PostgreSQL 18.6. Реквизиты передаются переменными окружения; рабочие пароли и данные в пример не входят. Таблицы с префиксом phpman_ создаются только для этого запуска и удаляются в finally.

<?php
declare(strict_types=1);

require __DIR__ . '/uodbc-bootstrap.php';

$connection = uodbcConnect();
$result = @odbc_exec($connection, 'SELECT * FROM phpman_missing_message_table');
if ($result === false) {
    $message = odbc_errormsg($connection);
    echo str_contains($message, 'phpman_missing_message_table') ? "message-has-object\n" : "message-received\n";
}
odbc_close($connection);

message-has-object

Сообщение полезно разработчику и может содержать имя объекта/SQL; его пишут в закрытый лог, а не отдают посетителю целиком. Пример выполнен через PHP 8.5.11/ext/odbc и psqlODBC 18.00 на отдельной локальной учебной базе PostgreSQL 18.6. Реквизиты передаются переменными окружения; рабочие пароли и данные в пример не входят. Таблицы с префиксом phpman_ создаются только для этого запуска и удаляются в finally.

<?php
declare(strict_types=1);

require __DIR__ . '/uodbc-bootstrap.php';

$connection = uodbcConnect();
echo odbc_errormsg($connection) === '' ? "empty\n" : "unexpected\n";
odbc_close($connection);

empty

На новом соединении без failed-вызова сообщение пусто; это не самостоятельная проверка доступности базы. Пример выполнен через PHP 8.5.11/ext/odbc и psqlODBC 18.00 на отдельной локальной учебной базе PostgreSQL 18.6. Реквизиты передаются переменными окружения; рабочие пароли и данные в пример не входят. Таблицы с префиксом phpman_ создаются только для этого запуска и удаляются в finally.

<?php
declare(strict_types=1);

require __DIR__ . '/uodbc-bootstrap.php';

$connection = uodbcConnect();
if (!odbc_setoption($connection, 1, 102, 0)) {
    throw new RuntimeException(odbc_errormsg($connection));
}
echo odbc_autocommit($connection) ? "on\n" : "off\n";
odbc_rollback($connection);
odbc_setoption($connection, 1, 102, 1);
echo odbc_autocommit($connection) ? "on\n" : "off\n";
odbc_close($connection);

off
on

which=1 вызывает SQLSetConnectOption; option 102 — SQL_AUTOCOMMIT. Для обычного кода понятнее odbc_autocommit(). Пример выполнен через PHP 8.5.11/ext/odbc и psqlODBC 18.00 на отдельной локальной учебной базе PostgreSQL 18.6. Реквизиты передаются переменными окружения; рабочие пароли и данные в пример не входят. Таблицы с префиксом phpman_ создаются только для этого запуска и удаляются в finally.

<?php
declare(strict_types=1);

require __DIR__ . '/uodbc-bootstrap.php';

$connection = uodbcConnect();
$statement = odbc_prepare($connection, 'SELECT CAST(? AS INTEGER) AS id');
if ($statement === false) { throw new RuntimeException(odbc_errormsg($connection)); }
echo odbc_setoption($statement, 2, 0, 30) ? "timeout-set\n" : "timeout-unsupported\n";
if (!odbc_execute($statement, [9])) { throw new RuntimeException(odbc_errormsg($connection)); }
$row = odbc_fetch_array($statement);
echo "id=", $row['id'], "\n";
odbc_close($connection);

timeout-set
id=9

which=2 вызывает SQLSetStmtOption; option 0 задаёт SQL_QUERY_TIMEOUT в секундах, если драйвер поддерживает его для уже созданного statement. Пример выполнен через PHP 8.5.11/ext/odbc и psqlODBC 18.00 на отдельной локальной учебной базе PostgreSQL 18.6. Реквизиты передаются переменными окружения; рабочие пароли и данные в пример не входят. Таблицы с префиксом phpman_ создаются только для этого запуска и удаляются в finally.

<?php
declare(strict_types=1);

require __DIR__ . '/uodbc-bootstrap.php';

$connection = uodbcConnect();
foreach ([ODBC_BINMODE_RETURN, ODBC_BINMODE_CONVERT] as $mode) {
    $result = uodbcExec($connection, "SELECT decode('0001ff', 'hex') AS payload");
    odbc_longreadlen($result, 100);
    odbc_binmode($result, $mode);
    $row = odbc_fetch_array($result);
    echo $mode === ODBC_BINMODE_RETURN ? 'raw=' : 'hex-text=';
    echo bin2hex((string) $row['payload']), "\n";
}
odbc_close($connection);

raw=0001ff
hex-text=303030316666

RETURN отдаёт три исходных байта; CONVERT отдаёт шесть ASCII-символов 0001ff, поэтому bin2hex этой строки показывает их коды. Пример выполнен через PHP 8.5.11/ext/odbc и psqlODBC 18.00 на отдельной локальной учебной базе PostgreSQL 18.6. Реквизиты передаются переменными окружения; рабочие пароли и данные в пример не входят. Таблицы с префиксом phpman_ создаются только для этого запуска и удаляются в finally.

<?php
declare(strict_types=1);

require __DIR__ . '/uodbc-bootstrap.php';

$connection = uodbcConnect();
$result = uodbcExec($connection, "SELECT decode('4142', 'hex') AS payload");
odbc_longreadlen($result, 10);
odbc_binmode($result, ODBC_BINMODE_PASSTHRU);
$row = odbc_fetch_array($result);
echo "array-value-length=", strlen((string) $row['payload']), "\n";
odbc_close($connection);

array-value-length=0

Для fetch_into/fetch_array официальный контракт passthru означает пустую строку; при odbc_result() данные отправились бы прямо в output, что опасно для JSON/HTML-ответа. Пример выполнен через PHP 8.5.11/ext/odbc и psqlODBC 18.00 на отдельной локальной учебной базе PostgreSQL 18.6. Реквизиты передаются переменными окружения; рабочие пароли и данные в пример не входят. Таблицы с префиксом phpman_ создаются только для этого запуска и удаляются в finally.

<?php
declare(strict_types=1);

require __DIR__ . '/uodbc-bootstrap.php';

$connection = uodbcConnect();
$result = uodbcExec($connection, "SELECT CAST(repeat('A', 10) AS text) AS body");
odbc_longreadlen($result, 4);
$row = odbc_fetch_array($result);
echo strlen($row['body']), ':', $row['body'], "\n";
odbc_close($connection);

4:AAAA

Предел измеряется байтами. Для UTF-8 он может оборвать последовательность посередине, поэтому размер выбирают по договору данных, а не по числу букв. Пример выполнен через PHP 8.5.11/ext/odbc и psqlODBC 18.00 на отдельной локальной учебной базе PostgreSQL 18.6. Реквизиты передаются переменными окружения; рабочие пароли и данные в пример не входят. Таблицы с префиксом phpman_ создаются только для этого запуска и удаляются в finally.

<?php
declare(strict_types=1);

require __DIR__ . '/uodbc-bootstrap.php';

$connection = uodbcConnect();
$result = uodbcExec($connection, "SELECT CAST(repeat('B', 10) AS text) AS body");
odbc_longreadlen($result, 20);
$row = odbc_fetch_array($result);
echo strlen($row['body']), ':', $row['body'], "\n";
odbc_close($connection);

10:BBBBBBBBBB

Лимит 20 больше результата, поэтому пришли все десять байт. Для реального неизвестного размера это всё равно буферная граница, а не потоковая гарантия. Пример выполнен через PHP 8.5.11/ext/odbc и psqlODBC 18.00 на отдельной локальной учебной базе PostgreSQL 18.6. Реквизиты передаются переменными окружения; рабочие пароли и данные в пример не входят. Таблицы с префиксом phpman_ создаются только для этого запуска и удаляются в finally.

<?php
declare(strict_types=1);

require __DIR__ . '/uodbc-bootstrap.php';

$connection = uodbcConnect();
uodbcDrop($connection, 'phpman_tables_product');
try {
    uodbcExec($connection, 'CREATE TABLE phpman_tables_product (id INTEGER PRIMARY KEY)');
    $result = odbc_tables($connection, null, 'public', 'phpman_tables_product', 'TABLE');
    if ($result === false) { throw new RuntimeException(odbc_errormsg($connection)); }
    $found = false;
    while ($row = odbc_fetch_array($result)) {
        $row = array_change_key_case($row, CASE_LOWER);
        $found = $found || ($row['table_name'] ?? '') === 'phpman_tables_product';
    }
    echo $found ? "table-found\n" : "table-missing\n";
} finally {
    uodbcDrop($connection, 'phpman_tables_product');
    odbc_close($connection);
}

table-found

Catalog API переносимее запроса к pg_catalog/information_schema, но шаблоны и регистр всё равно зависят от драйвера. Пример выполнен через PHP 8.5.11/ext/odbc и psqlODBC 18.00 на отдельной локальной учебной базе PostgreSQL 18.6. Реквизиты передаются переменными окружения; рабочие пароли и данные в пример не входят. Таблицы с префиксом phpman_ создаются только для этого запуска и удаляются в finally.

<?php
declare(strict_types=1);

require __DIR__ . '/uodbc-bootstrap.php';

$connection = uodbcConnect();
@odbc_exec($connection, 'DROP VIEW IF EXISTS phpman_tables_view');
try {
    uodbcExec($connection, 'CREATE VIEW phpman_tables_view AS SELECT 1 AS id');
    $result = odbc_tables($connection, null, 'public', 'phpman_tables_view', 'VIEW');
    $row = $result === false ? false : odbc_fetch_array($result);
    $row = is_array($row) ? array_change_key_case($row, CASE_LOWER) : [];
    echo strtoupper((string) ($row['table_type'] ?? 'missing')), "\n";
} finally {
    @odbc_exec($connection, 'DROP VIEW IF EXISTS phpman_tables_view');
    odbc_close($connection);
}

VIEW

Тип объекта нельзя выводить только из имени; metadata возвращает TABLE_TYPE. Пример выполнен через PHP 8.5.11/ext/odbc и psqlODBC 18.00 на отдельной локальной учебной базе PostgreSQL 18.6. Реквизиты передаются переменными окружения; рабочие пароли и данные в пример не входят. Таблицы с префиксом phpman_ создаются только для этого запуска и удаляются в finally.

<?php
declare(strict_types=1);

require __DIR__ . '/uodbc-bootstrap.php';

$connection = uodbcConnect();
uodbcDrop($connection, 'phpman_columns_product');
try {
    uodbcExec($connection, 'CREATE TABLE phpman_columns_product (id INTEGER PRIMARY KEY, name VARCHAR(40), price NUMERIC(8,2))');
    $result = odbc_columns($connection, null, 'public', 'phpman_columns_product', '%');
    $names = [];
    while ($row = odbc_fetch_array($result)) {
        $row = array_change_key_case($row, CASE_LOWER);
        $names[] = $row['column_name'];
    }
    echo implode(',', $names), "\n";
} finally {
    uodbcDrop($connection, 'phpman_columns_product');
    odbc_close($connection);
}

id,name,price

Порядок следует ORDINAL_POSITION драйвера; мастер импорта может сопоставить входные заголовки. Пример выполнен через PHP 8.5.11/ext/odbc и psqlODBC 18.00 на отдельной локальной учебной базе PostgreSQL 18.6. Реквизиты передаются переменными окружения; рабочие пароли и данные в пример не входят. Таблицы с префиксом phpman_ создаются только для этого запуска и удаляются в finally.

<?php
declare(strict_types=1);

require __DIR__ . '/uodbc-bootstrap.php';

$connection = uodbcConnect();
uodbcDrop($connection, 'phpman_columns_contract');
try {
    uodbcExec($connection, 'CREATE TABLE phpman_columns_contract (external_id VARCHAR(30) NOT NULL, note VARCHAR(100))');
    $result = odbc_columns($connection, null, 'public', 'phpman_columns_contract', 'external_id');
    $row = odbc_fetch_array($result);
    $row = array_change_key_case($row, CASE_LOWER);
    echo strtolower($row['type_name']), ':nullable=', $row['nullable'], "\n";
} finally {
    uodbcDrop($connection, 'phpman_columns_contract');
    odbc_close($connection);
}

varchar:nullable=0

NOT NULL отражается nullable=0; это описание БД, но входные данные всё равно проверяет приложение до запроса. Пример выполнен через PHP 8.5.11/ext/odbc и psqlODBC 18.00 на отдельной локальной учебной базе PostgreSQL 18.6. Реквизиты передаются переменными окружения; рабочие пароли и данные в пример не входят. Таблицы с префиксом phpman_ создаются только для этого запуска и удаляются в finally.

<?php
declare(strict_types=1);

require __DIR__ . '/uodbc-bootstrap.php';

$connection = uodbcConnect();
$result = odbc_gettypeinfo($connection, SQL_INTEGER);
if ($result === false) { throw new RuntimeException(odbc_errormsg($connection)); }
$row = odbc_fetch_array($result);
$row = array_change_key_case($row, CASE_LOWER);
echo "type=", strtolower($row['type_name']), " data=", $row['data_type'], "\n";
odbc_close($connection);

type=int4 data=4

SQL_INTEGER имеет код 4; psqlODBC показывает нативное имя int4. Пример выполнен через PHP 8.5.11/ext/odbc и psqlODBC 18.00 на отдельной локальной учебной базе PostgreSQL 18.6. Реквизиты передаются переменными окружения; рабочие пароли и данные в пример не входят. Таблицы с префиксом phpman_ создаются только для этого запуска и удаляются в finally.

<?php
declare(strict_types=1);

require __DIR__ . '/uodbc-bootstrap.php';

$connection = uodbcConnect();
$result = odbc_gettypeinfo($connection, SQL_VARCHAR);
$row = $result === false ? false : odbc_fetch_array($result);
$row = is_array($row) ? array_change_key_case($row, CASE_LOWER) : [];
echo "type=", strtolower($row['type_name'] ?? 'missing'), "\n";
echo "data=", $row['data_type'] ?? 'missing', "\n";
echo "precision=", $row['precision'] ?? 'missing', "\n";
odbc_close($connection);

type=varchar
data=12
precision=255

Универсальный генератор схемы может проверить возможность типа, но реальный лимит и синтаксис CREATE TABLE остаются драйверно-зависимыми. psqlODBC возвращает ODBC2-совместимое имя поля PRECISION вместо COLUMN_SIZE — поэтому потребитель сначала изучает фактические ключи metadata своего драйвера. Пример выполнен через PHP 8.5.11/ext/odbc и psqlODBC 18.00 на отдельной локальной учебной базе PostgreSQL 18.6. Реквизиты передаются переменными окружения; рабочие пароли и данные в пример не входят. Таблицы с префиксом phpman_ создаются только для этого запуска и удаляются в finally.

<?php
declare(strict_types=1);

require __DIR__ . '/uodbc-bootstrap.php';

$connection = uodbcConnect();
uodbcDrop($connection, 'phpman_pk_product');
try {
    uodbcExec($connection, 'CREATE TABLE phpman_pk_product (id INTEGER PRIMARY KEY, name VARCHAR(40))');
    $result = odbc_primarykeys($connection, null, 'public', 'phpman_pk_product');
    $row = odbc_fetch_array($result);
    $row = array_change_key_case($row, CASE_LOWER);
    echo $row['column_name'], ':seq=', $row['key_seq'], "\n";
} finally {
    uodbcDrop($connection, 'phpman_pk_product');
    odbc_close($connection);
}

id:seq=1

COLUMN_NAME и KEY_SEQ дают состав ключа; имя ограничения тоже доступно в PK_NAME. Пример выполнен через PHP 8.5.11/ext/odbc и psqlODBC 18.00 на отдельной локальной учебной базе PostgreSQL 18.6. Реквизиты передаются переменными окружения; рабочие пароли и данные в пример не входят. Таблицы с префиксом phpman_ создаются только для этого запуска и удаляются в finally.

<?php
declare(strict_types=1);

require __DIR__ . '/uodbc-bootstrap.php';

$connection = uodbcConnect();
uodbcDrop($connection, 'phpman_pk_line');
try {
    uodbcExec($connection, 'CREATE TABLE phpman_pk_line (order_id INTEGER, line_no INTEGER, PRIMARY KEY (order_id, line_no))');
    $result = odbc_primarykeys($connection, null, 'public', 'phpman_pk_line');
    $columns = [];
    while ($row = odbc_fetch_array($result)) {
        $row = array_change_key_case($row, CASE_LOWER);
        $columns[(int) $row['key_seq']] = $row['column_name'];
    }
    ksort($columns);
    echo implode(',', $columns), "\n";
} finally {
    uodbcDrop($connection, 'phpman_pk_line');
    odbc_close($connection);
}

order_id,line_no

Составной ключ — несколько metadata-строк; KEY_SEQ нельзя терять при генерации mapping. Пример выполнен через PHP 8.5.11/ext/odbc и psqlODBC 18.00 на отдельной локальной учебной базе PostgreSQL 18.6. Реквизиты передаются переменными окружения; рабочие пароли и данные в пример не входят. Таблицы с префиксом phpman_ создаются только для этого запуска и удаляются в finally.

<?php
declare(strict_types=1);

require __DIR__ . '/uodbc-bootstrap.php';

$connection = uodbcConnect();
uodbcDrop($connection, 'phpman_fk_line');
uodbcDrop($connection, 'phpman_fk_order');
try {
    uodbcExec($connection, 'CREATE TABLE phpman_fk_order (id INTEGER PRIMARY KEY)');
    uodbcExec($connection, 'CREATE TABLE phpman_fk_line (id INTEGER PRIMARY KEY, order_id INTEGER REFERENCES phpman_fk_order(id))');
    $result = odbc_foreignkeys($connection, null, 'public', 'phpman_fk_order', '', 'public', 'phpman_fk_line');
    $row = odbc_fetch_array($result);
    $row = array_change_key_case($row, CASE_LOWER);
    echo $row['fkcolumn_name'], '->', $row['pkcolumn_name'], "\n";
} finally {
    uodbcDrop($connection, 'phpman_fk_line');
    uodbcDrop($connection, 'phpman_fk_order');
    odbc_close($connection);
}

order_id->id

Metadata показывает направление FK→PK, а не загружает связанные данные. Пример выполнен через PHP 8.5.11/ext/odbc и psqlODBC 18.00 на отдельной локальной учебной базе PostgreSQL 18.6. Реквизиты передаются переменными окружения; рабочие пароли и данные в пример не входят. Таблицы с префиксом phpman_ создаются только для этого запуска и удаляются в finally.

<?php
declare(strict_types=1);

require __DIR__ . '/uodbc-bootstrap.php';

$connection = uodbcConnect();
uodbcDrop($connection, 'phpman_fk_child');
uodbcDrop($connection, 'phpman_fk_parent');
try {
    uodbcExec($connection, 'CREATE TABLE phpman_fk_parent (id INTEGER PRIMARY KEY)');
    uodbcExec($connection, 'CREATE TABLE phpman_fk_child (id INTEGER PRIMARY KEY, parent_id INTEGER REFERENCES phpman_fk_parent(id) ON DELETE CASCADE)');
    $result = odbc_foreignkeys($connection, null, 'public', 'phpman_fk_parent', '', 'public', 'phpman_fk_child');
    $row = array_change_key_case(odbc_fetch_array($result), CASE_LOWER);
    echo "delete-rule=", $row['delete_rule'], "\n";
} finally {
    uodbcDrop($connection, 'phpman_fk_child');
    uodbcDrop($connection, 'phpman_fk_parent');
    odbc_close($connection);
}

delete-rule=0

ODBC SQL_CASCADE имеет код 0. В UI лучше переводить числовой код через явную карту, не показывать как самодостаточный смысл. Пример выполнен через PHP 8.5.11/ext/odbc и psqlODBC 18.00 на отдельной локальной учебной базе PostgreSQL 18.6. Реквизиты передаются переменными окружения; рабочие пароли и данные в пример не входят. Таблицы с префиксом phpman_ создаются только для этого запуска и удаляются в finally.

<?php
declare(strict_types=1);

require __DIR__ . '/uodbc-bootstrap.php';

$connection = uodbcConnect();
@odbc_exec($connection, 'DROP FUNCTION IF EXISTS phpman_proc_add(integer)');
try {
    uodbcExec($connection, 'CREATE FUNCTION phpman_proc_add(integer) RETURNS integer LANGUAGE sql IMMUTABLE AS $$ SELECT $1 + 1 $$');
    $result = odbc_procedures($connection, null, 'public', 'phpman_proc_add');
    $found = false;
    while ($row = odbc_fetch_array($result)) {
        $row = array_change_key_case($row, CASE_LOWER);
        $found = $found || str_contains((string) ($row['procedure_name'] ?? ''), 'phpman_proc_add');
    }
    echo $found ? "procedure-found\n" : "procedure-missing\n";
} finally {
    @odbc_exec($connection, 'DROP FUNCTION IF EXISTS phpman_proc_add(integer)');
    odbc_close($connection);
}

procedure-found

ODBC называет catalog entry procedure даже там, где PostgreSQL различает function/procedure. Пример выполнен через PHP 8.5.11/ext/odbc и psqlODBC 18.00 на отдельной локальной учебной базе PostgreSQL 18.6. Реквизиты передаются переменными окружения; рабочие пароли и данные в пример не входят. Таблицы с префиксом phpman_ создаются только для этого запуска и удаляются в finally.

<?php
declare(strict_types=1);

require __DIR__ . '/uodbc-bootstrap.php';

$connection = uodbcConnect();
$result = odbc_procedures($connection, null, 'public', 'phpman_proc_does_not_exist');
$count = 0;
while ($result !== false && odbc_fetch_array($result)) { $count++; }
echo "matches={$count}\n";
odbc_close($connection);

matches=0

Пустой catalog result — нормальный исход поиска, не false-ошибка. Пример выполнен через PHP 8.5.11/ext/odbc и psqlODBC 18.00 на отдельной локальной учебной базе PostgreSQL 18.6. Реквизиты передаются переменными окружения; рабочие пароли и данные в пример не входят. Таблицы с префиксом phpman_ создаются только для этого запуска и удаляются в finally.

<?php
declare(strict_types=1);

require __DIR__ . '/uodbc-bootstrap.php';

$connection = uodbcConnect();
@odbc_exec($connection, 'DROP FUNCTION IF EXISTS phpman_proc_param(integer)');
try {
    uodbcExec($connection, 'CREATE FUNCTION phpman_proc_param(value integer) RETURNS integer LANGUAGE sql IMMUTABLE AS $$ SELECT value * 2 $$');
    $result = odbc_procedurecolumns($connection, null, 'public', 'phpman_proc_param', '%');
    $count = 0;
    while (odbc_fetch_array($result)) { $count++; }
    echo "parameter-rows={$count}\n";
    echo $count > 0 ? "source=odbc-catalog\n" : "source=explicit-contract\n";
} finally {
    @odbc_exec($connection, 'DROP FUNCTION IF EXISTS phpman_proc_param(integer)');
    odbc_close($connection);
}

parameter-rows=0
source=explicit-contract

psqlODBC 18.00 видит созданную функцию через odbc_procedures(), но не выдаёт строки SQLProcedureColumns. Пустой result — проверенная capability-граница, поэтому adapter хранит явный контракт параметров либо читает нативный каталог PostgreSQL. Пример выполнен через PHP 8.5.11/ext/odbc и psqlODBC 18.00 на отдельной локальной учебной базе PostgreSQL 18.6. Реквизиты передаются переменными окружения; рабочие пароли и данные в пример не входят. Таблицы с префиксом phpman_ создаются только для этого запуска и удаляются в finally.

<?php
declare(strict_types=1);

require __DIR__ . '/uodbc-bootstrap.php';

$connection = uodbcConnect();
@odbc_exec($connection, 'DROP FUNCTION IF EXISTS phpman_proc_pair(integer, integer)');
try {
    uodbcExec($connection, 'CREATE FUNCTION phpman_proc_pair(left_value integer, right_value integer) RETURNS integer LANGUAGE sql IMMUTABLE AS $$ SELECT left_value + right_value $$');
    $procedures = odbc_procedures($connection, null, 'public', 'phpman_proc_pair');
    $procedureFound = false;
    while ($procedures !== false && odbc_fetch_array($procedures)) { $procedureFound = true; }
    $columns = odbc_procedurecolumns($connection, null, 'public', 'phpman_proc_pair', '%');
    $count = 0;
    while ($columns !== false && odbc_fetch_array($columns)) { $count++; }
    echo "procedure=", $procedureFound ? "yes\n" : "no\n";
    echo "parameter-rows={$count}\n";
} finally {
    @odbc_exec($connection, 'DROP FUNCTION IF EXISTS phpman_proc_pair(integer, integer)');
    odbc_close($connection);
}

procedure=yes
parameter-rows=0

Callable присутствует в SQLProcedures, однако SQLProcedureColumns остаётся пустым. Такое сравнение отличает «объекта нет» от «драйвер не раскрывает параметры»; при поддержке код дополнительно читает COLUMN_TYPE и ORDINAL_POSITION, а не только count. Пример выполнен через PHP 8.5.11/ext/odbc и psqlODBC 18.00 на отдельной локальной учебной базе PostgreSQL 18.6. Реквизиты передаются переменными окружения; рабочие пароли и данные в пример не входят. Таблицы с префиксом phpman_ создаются только для этого запуска и удаляются в finally.

<?php
declare(strict_types=1);

require __DIR__ . '/uodbc-bootstrap.php';

$connection = uodbcConnect();
uodbcDrop($connection, 'phpman_special_product');
try {
    uodbcExec($connection, 'CREATE TABLE phpman_special_product (id INTEGER PRIMARY KEY, name VARCHAR(20))');
    $result = odbc_specialcolumns($connection, SQL_BEST_ROWID, null, 'public', 'phpman_special_product', SQL_SCOPE_SESSION, SQL_NO_NULLS);
    if ($result === false) { throw new RuntimeException(odbc_errormsg($connection)); }
    $found = false;
    while ($row = odbc_fetch_array($result)) {
        $row = array_change_key_case($row, CASE_LOWER);
        $found = $found || ($row['column_name'] ?? '') === 'id';
    }
    echo $found ? "best=id\n" : "best-not-reported\n";
} finally {
    uodbcDrop($connection, 'phpman_special_product');
    odbc_close($connection);
}

best=id

SQL_BEST_ROWID просит ODBC определить набор колонок, уникально идентифицирующий строку в заданном scope. Пример выполнен через PHP 8.5.11/ext/odbc и psqlODBC 18.00 на отдельной локальной учебной базе PostgreSQL 18.6. Реквизиты передаются переменными окружения; рабочие пароли и данные в пример не входят. Таблицы с префиксом phpman_ создаются только для этого запуска и удаляются в finally.

<?php
declare(strict_types=1);

require __DIR__ . '/uodbc-bootstrap.php';

$connection = uodbcConnect();
uodbcDrop($connection, 'phpman_special_version');
try {
    uodbcExec($connection, 'CREATE TABLE phpman_special_version (id INTEGER PRIMARY KEY, changed_at TIMESTAMP)');
    $result = odbc_specialcolumns($connection, SQL_ROWVER, null, 'public', 'phpman_special_version', SQL_SCOPE_SESSION, SQL_NULLABLE);
    $row = $result === false ? false : odbc_fetch_array($result);
    $row = is_array($row) ? array_change_key_case($row, CASE_LOWER) : [];
    echo "rowver=", $row['column_name'] ?? 'none', "\n";
    echo "pseudo=", $row['pseudo_column'] ?? 'none', "\n";
} finally {
    uodbcDrop($connection, 'phpman_special_version');
    odbc_close($connection);
}

rowver=xmin
pseudo=2

Обычный changed_at не становится rowversion. psqlODBC сообщает системную pseudo-column xmin (PSEUDO_COLUMN=2). Это backend-specific идентификатор версии строки: его используют только после изучения семантики PostgreSQL и не выдают за переносимый timestamp. Пример выполнен через PHP 8.5.11/ext/odbc и psqlODBC 18.00 на отдельной локальной учебной базе PostgreSQL 18.6. Реквизиты передаются переменными окружения; рабочие пароли и данные в пример не входят. Таблицы с префиксом phpman_ создаются только для этого запуска и удаляются в finally.

<?php
declare(strict_types=1);

require __DIR__ . '/uodbc-bootstrap.php';

$connection = uodbcConnect();
uodbcDrop($connection, 'phpman_stats_product');
try {
    uodbcExec($connection, 'CREATE TABLE phpman_stats_product (id INTEGER PRIMARY KEY, name VARCHAR(20))');
    $result = odbc_statistics($connection, null, 'public', 'phpman_stats_product', SQL_INDEX_ALL, SQL_ENSURE);
    $found = false;
    while ($row = odbc_fetch_array($result)) {
        $row = array_change_key_case($row, CASE_LOWER);
        $found = $found || ($row['column_name'] ?? '') === 'id';
    }
    echo $found ? "id-indexed\n" : "id-not-indexed\n";
} finally {
    uodbcDrop($connection, 'phpman_stats_product');
    odbc_close($connection);
}

id-indexed

Metadata показывает наличие индексной записи, но не доказывает, что конкретный запрос выберет этот индекс. Пример выполнен через PHP 8.5.11/ext/odbc и psqlODBC 18.00 на отдельной локальной учебной базе PostgreSQL 18.6. Реквизиты передаются переменными окружения; рабочие пароли и данные в пример не входят. Таблицы с префиксом phpman_ создаются только для этого запуска и удаляются в finally.

<?php
declare(strict_types=1);

require __DIR__ . '/uodbc-bootstrap.php';

$connection = uodbcConnect();
uodbcDrop($connection, 'phpman_stats_customer');
try {
    uodbcExec($connection, 'CREATE TABLE phpman_stats_customer (id INTEGER PRIMARY KEY, email VARCHAR(80) UNIQUE)');
    $result = odbc_statistics($connection, null, 'public', 'phpman_stats_customer', SQL_INDEX_UNIQUE, SQL_QUICK);
    $columns = [];
    while ($row = odbc_fetch_array($result)) {
        $row = array_change_key_case($row, CASE_LOWER);
        if (($row['column_name'] ?? '') !== '') { $columns[] = $row['column_name']; }
    }
    sort($columns);
    echo implode(',', array_unique($columns)), "\n";
} finally {
    uodbcDrop($connection, 'phpman_stats_customer');
    odbc_close($connection);
}

email,id

UNIQUE email и PRIMARY KEY id оба попадают в фильтр уникальных индексов. Пример выполнен через PHP 8.5.11/ext/odbc и psqlODBC 18.00 на отдельной локальной учебной базе PostgreSQL 18.6. Реквизиты передаются переменными окружения; рабочие пароли и данные в пример не входят. Таблицы с префиксом phpman_ создаются только для этого запуска и удаляются в finally.

<?php
declare(strict_types=1);

require __DIR__ . '/uodbc-bootstrap.php';

$connection = uodbcConnect();
uodbcDrop($connection, 'phpman_priv_table');
try {
    uodbcExec($connection, 'CREATE TABLE phpman_priv_table (id INTEGER PRIMARY KEY)');
    $result = odbc_tableprivileges($connection, null, 'public', 'phpman_priv_table');
    $found = false;
    while ($row = odbc_fetch_array($result)) {
        $row = array_change_key_case($row, CASE_LOWER);
        $found = $found || strtoupper((string) ($row['privilege'] ?? '')) === 'SELECT';
    }
    echo $found ? "select=yes\n" : "select=no\n";
} finally {
    uodbcDrop($connection, 'phpman_priv_table');
    odbc_close($connection);
}

select=yes

Catalog отражает grants, видимые драйверу. Приложение всё равно проверяет свою авторизацию пользователя отдельно. Пример выполнен через PHP 8.5.11/ext/odbc и psqlODBC 18.00 на отдельной локальной учебной базе PostgreSQL 18.6. Реквизиты передаются переменными окружения; рабочие пароли и данные в пример не входят. Таблицы с префиксом phpman_ создаются только для этого запуска и удаляются в finally.

<?php
declare(strict_types=1);

require __DIR__ . '/uodbc-bootstrap.php';

$connection = uodbcConnect();
uodbcDrop($connection, 'phpman_priv_grant');
try {
    uodbcExec($connection, 'CREATE TABLE phpman_priv_grant (id INTEGER PRIMARY KEY)');
    $result = odbc_tableprivileges($connection, null, 'public', 'phpman_priv_grant');
    $rows = 0;
    $hasField = false;
    while ($row = odbc_fetch_array($result)) {
        $row = array_change_key_case($row, CASE_LOWER);
        $rows++;
        $hasField = $hasField || array_key_exists('is_grantable', $row);
    }
    echo $rows > 0 && $hasField ? "grant-metadata=yes\n" : "grant-metadata=no\n";
} finally {
    uodbcDrop($connection, 'phpman_priv_grant');
    odbc_close($connection);
}

grant-metadata=yes

IS_GRANTABLE — metadata администратора, не кнопка для автоматической выдачи прав из веб-интерфейса. Пример выполнен через PHP 8.5.11/ext/odbc и psqlODBC 18.00 на отдельной локальной учебной базе PostgreSQL 18.6. Реквизиты передаются переменными окружения; рабочие пароли и данные в пример не входят. Таблицы с префиксом phpman_ создаются только для этого запуска и удаляются в finally.

<?php
declare(strict_types=1);

require __DIR__ . '/uodbc-bootstrap.php';

$connection = uodbcConnect();
uodbcDrop($connection, 'phpman_column_priv');
try {
    uodbcExec($connection, 'CREATE TABLE phpman_column_priv (id INTEGER PRIMARY KEY, secret VARCHAR(20))');
    $result = odbc_columnprivileges($connection, null, 'public', 'phpman_column_priv', 'secret');
    $found = false;
    while ($row = odbc_fetch_array($result)) {
        $row = array_change_key_case($row, CASE_LOWER);
        $found = $found || ($row['column_name'] ?? '') === 'secret';
    }
    echo $found ? "secret-metadata=yes\n" : "secret-metadata=no\n";
} finally {
    uodbcDrop($connection, 'phpman_column_priv');
    odbc_close($connection);
}

secret-metadata=yes

Даже если роль БД может SELECT колонку, приложение не обязано включать её в API-ответ. Пример выполнен через PHP 8.5.11/ext/odbc и psqlODBC 18.00 на отдельной локальной учебной базе PostgreSQL 18.6. Реквизиты передаются переменными окружения; рабочие пароли и данные в пример не входят. Таблицы с префиксом phpman_ создаются только для этого запуска и удаляются в finally.

<?php
declare(strict_types=1);

require __DIR__ . '/uodbc-bootstrap.php';

$connection = uodbcConnect();
uodbcDrop($connection, 'phpman_column_priv_missing');
try {
    uodbcExec($connection, 'CREATE TABLE phpman_column_priv_missing (id INTEGER PRIMARY KEY)');
    $result = odbc_columnprivileges($connection, null, 'public', 'phpman_column_priv_missing', 'unknown_column');
    $count = 0;
    while ($result !== false && odbc_fetch_array($result)) { $count++; }
    echo "matches={$count}\n";
} finally {
    uodbcDrop($connection, 'phpman_column_priv_missing');
    odbc_close($connection);
}

matches=0

Пустой набор — нормальный результат фильтра, а false означал бы отказ API. Пример выполнен через PHP 8.5.11/ext/odbc и psqlODBC 18.00 на отдельной локальной учебной базе PostgreSQL 18.6. Реквизиты передаются переменными окружения; рабочие пароли и данные в пример не входят. Таблицы с префиксом phpman_ создаются только для этого запуска и удаляются в finally.