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

От программы PHP до прочитанного товара

Вам нужен сайт или фоновый импорт, который читает Firebird. Сначала соберём совместимую цепочку: PHP выполняет код; расширение interbase добавляет функции ibase_*; клиентская библиотека передаёт обращения; движок Firebird открывает базу и исполняет SQL. Доступность каждого следующего звена проверяется отдельно. В конце этой главы вы увидите товар Cable с остатком 3, сравните запуск с модулем и без него и получите две формы одной даты доставки.

Аналогия — рабочее место, переходник и нужный прибор: наличие переходника не доказывает, что вы подключились к правильному прибору. Здесь она объясняет границы проверки, а не внутреннее устройство протокола или памяти базы. Для сетевого подключения сервер может находиться на другом компьютере; в нашей лаборатории движок embedded работает локально. Это два способа размещения, а не два разных SQL-языка.

Проверенный комплект этой главы: PHP 8.2.35 NTS x64, FirebirdSQL interbase 3.0.1, Firebird 5.0.4 embedded SuperClassic. Это закреплённые версии для воспроизведения, не перечень последних выпусков. До PHP 7.4 расширение входило в исходный PHP; с PHP 7.4 его вынесли из основной поставки в PECL. Поддерживаемый исходник находится у FirebirdSQL. Поэтому старая строка «PHP 5 / PHP 7» на странице функции не означает, что современный PHP загрузит её без отдельного модуля.

Для первого знакомства с переменными и вызовом функций откройте переменные и функции. Непосредственно соединение и SELECT разобраны в первых запросах Firebird. Здесь мы объясняем, как сделать эти функции доступными и как прочитать действующие настройки, а не требуем угадывать их по ошибке.

Установка: версии, зависимости, Windows и Unix

Начните с того PHP, который будет выполнять задачу. В Windows могут одновременно существовать PHP из веб-сборки, отдельная консоль и путь планировщика. Вызов php по PATH может выбрать другой файл. В лаборатории README задаёт абсолютный $phpExe и отдельную папку компонентов, не меняя глобальную конфигурацию компьютера.

"C:\Tools\php82-firebird\php.exe" -v
"C:\Tools\php82-firebird\php.exe" --ini
"C:\Tools\php82-firebird\php.exe" -m

Это шаблоны команд для командной строки Windows: замените путь своим. -v показывает версию PHP, --ini — выбранные файлы конфигурации, -m — модули именно этого запуска. В PowerShell для пути в кавычках используйте оператор вызова &: & $phpExe --ini. Эти команды не создают базу. Для сайта проверяют тот же набор сведений внутри закрытого диагностического обработчика его SAPI, после чего обработчик удаляют; не оставляют phpinfo открытым посетителям.

Исторический способ сборки встроенного расширения: configure с --with-interbase[=DIR], при отсутствии DIR использовался /usr. Для отдельного поддерживаемого исходника выполняют phpize, ./configure с нужным --with-php-config и --with-interbase, затем make и установку модуля. Точные пути и пакеты разработки зависят от дистрибутива. Команды из старой заметки для PHP 7.4 нельзя механически переносить на любой PHP 8.x. Актуальная общая страница PHP об установке расширений указывает переход экосистемы от PECL к PIE; наличие архивного PECL-пакета 3.0.1 здесь — способ воспроизведения, не обещание поддержки любого нового установщика для этого модуля.

В нашей лаборатории fbclient и embedded-движок берутся из отдельного Firebird 5.0.4; Providers=Engine13 и ServerMode=SuperClassic относятся только к нему. База создаётся из приложенного синтетического backup под новым именем fb159_*. Настройка сервера пользователя, security database и служба Windows не меняются. Для реального сетевого сервера потребуются его адрес, согласованный charset, права и учётная запись; пустой пароль локальной embedded-лаборатории не является образцом сетевой авторизации.

Если модуль не загрузился, сначала изучают startup stderr и выбранный ini, затем зависимости/совместимость. Если ibase_connect уже существует, но сервер отклоняет кодировку или пароль, загрузка функции состоялась: это другой этап. Подробная пара реальных запусков находится в диагностике без расширения и с расширением.

Все десять настроек interbase и их область действия

php.ini — файл исходных настроек процесса; действующее значение может отличаться от записи в другом файле или от значения после ini_set. INI_SYSTEM означает настройку на системном/серверном уровне, а не изменение произвольным ini_set в скрипте. INI_ALL допускает изменение во время выполнения, если оно не запрещено конфигурацией более высокого уровня. Точные используемые файлы показывают php_ini_loaded_file и php_ini_scanned_files: false означает отсутствие соответствующего файла, а не ошибку SQL.

NULL в таблице означает отсутствие заданного значения по умолчанию, а не строку "NULL" для пароля или имени файла. Явные аргументы соединения удобны, когда приложению важно однозначно выбрать базу и charset. Не выводите весь ini_get_all без отбора: default_password и служебные пути не предназначены для общего доступа.

$settings = ini_get_all("interbase");
if (!is_array($settings)) { throw new RuntimeException("Настройки расширения недоступны"); }
$format = $settings["ibase.dateformat"];
echo $format["global_value"], " → ", $format["local_value"];

global_value — исходное значение этого процесса, local_value — действующее в текущем выполнении; access описывает разрешённый уровень изменения. Не сравнивайте их с настройками другого SAPI. Практический отчёт доставки сохраняет предыдущие значения, проверяет возврат ini_set и восстанавливает всё через finally.

Для max_persistent есть важное отличие намерения документации от исходника именно 3.0.1: выражение присваивания при проверке ограничения получает логический результат сравнения с -1. Поэтому нельзя обучать эту сборку как безошибочную реализацию любого заданного числового лимита. Числовые лимиты не испытывались в данном пакете. Подробности границ, ключа повторного использования и жизненного цикла находятся в главе постоянных соединений. Ограничение не превращает множество workers в один общий пул.

Три форматирующие директивы используют шаблоны C strftime. На возврате DATE/TIME/TIMESTAMP это подтверждено работающим примером. В исходнике входные строки имеют разные ветви при наличии HAVE_STRPTIME; без неё драйвер может передать строку на разбор Firebird. Поэтому оформление для человека и контракт ввода в SQL нужно разделять. Не подставляйте отформатированную дату конкатенацией в запрос.

Как запустить самостоятельные примеры

В каждом ZIP есть example.php, lab.php, README и синтетический шаблон базы с исходным seed.sql. Один запуск создаёт одну собственную базу, сохраняет result.html/result.json, закрывает подключения и удаляет только зарегистрированные учебные файлы. В шаблоне Cable/3 и Clamp/0. f159* — открытый вспомогательный код лаборатории: создание базы, немедленная диагностика, ограниченное чтение и проверяемое завершение. Он не является частью расширения PHP.

Для сравнения расширений добавлены process-lab.php и capability-child.php; перед запуском укажите PHPMAN_FIREBIRD_EXTENSION из README. Эти два процесса не соединяются с базой. Все программы рассчитаны на закреплённый изолированный комплект, не на ваши рабочие базы. Короткие фрагменты показывают один шаг; самостоятельный полный файл содержит все проверки и освобождение ресурсов.

Паспорт приложения: какой PHP действительно прочитал товар

После переноса сайта появляется ошибка подключения. Сначала выясним, какой именно PHP запустил программу, какое расширение он загрузил и какой движок ответил. Затем прочитаем название Cable и остаток 3: наличие модуля само по себе ещё не доказывает, что SQL работает.

Минимальный шаг

echo PHP_VERSION, "\n";
echo PHP_SAPI, "\n";
echo extension_loaded("interbase") ? "interbase загружен" : "interbase отсутствует";

PHP_VERSION — строка версии выполняющегося интерпретатора. PHP_SAPI показывает его интерфейс: здесь cli, на сайте возможны другие значения. extension_loaded проверяет модуль, а phpversion("interbase") — его версию. Это разные вопросы. Полная программа создаёт из шаблона две синтетические строки, передаёт ID параметром и получает только нужные TITLE/QTY.

Видимый результат

<?php
declare(strict_types=1);
require __DIR__.'/lab.php';
$owned=[];$removed=[];$db=$service=null;
try {
    $config=f159Config();$service=f159Service();$runtime=f159Runtime($service);

    $database=f159CreateDatabase($service,$owned,'passport');
    $db=f159Connect($database);
    $product=f159Read($db,'SELECT TITLE AS "title",QTY AS "qty" FROM LAB_ITEMS WHERE ID=?',[1])[0];
    $phpInfo=['php'=>PHP_VERSION,'sapi'=>PHP_SAPI,'bits'=>PHP_INT_SIZE*8,
        'thread_safe'=>(bool)PHP_ZTS,'extension'=>phpversion('interbase'),
        'function_exists'=>function_exists('ibase_connect')];
    f159Close($db);
    $rows=[['Версия PHP',$phpInfo['php']],['Способ запуска',$phpInfo['sapi']],['Разрядность PHP',$phpInfo['bits']],
        ['Thread Safe',$phpInfo['thread_safe']],['Версия расширения',$phpInfo['extension']],
        ['Версия подключённого движка',$runtime['server_version']],['Название товара',$product['title']],['Остаток',$product['qty']]];
    $checks=['php_profile'=>$phpInfo['php']==='8.2.35' && $phpInfo['sapi']==='cli' && $phpInfo['bits']===64 && $phpInfo['thread_safe']===false,
        'extension_loaded'=>$phpInfo['extension']==='3.0.1' && $phpInfo['function_exists'],
        'server_observed'=>str_contains($runtime['server_version'],'V5.0.4.'),
        'actual_query'=>$product===['title'=>'Cable','qty'=>3],'closed'=>$db===null];
    $observations=['php'=>$phpInfo,'server'=>$runtime['server_version'],'selected'=>$product,
        'query'=>'SELECT TITLE,QTY FROM LAB_ITEMS WHERE ID=?','parameter'=>1,
        'client_library_version_not_inferred_from_php_extension'=>true,'web_sapi_not_tested_by_cli'=>true];

} finally {
    if(is_resource($db)){f159Close($db);}
    if(is_resource($service)){f159Detach($service);}
    $removed=f159Cleanup($owned);
}

f159Report('fb159-runtime-passport','Паспорт приложения: какой PHP действительно прочитал товар',$rows,$checks,$observations,$runtime,$owned,$removed);

Версия PHP — 8.2.35
Способ запуска — cli
Разрядность PHP — 64
Thread Safe — нет
Версия расширения — 3.0.1
Версия подключённого движка — WI-V5.0.4.1812 Firebird 5.0
Название товара — Cable
Остаток — 3

HTML-результат · JSON с наблюдениями.

Ошибки и границы применения

Версии PHP, расширения interbase, клиентской библиотеки fbclient и движка Firebird нельзя подменять друг другом. Номер ODS относится к формату файла базы. Строка server_version в этой лаборатории — ответ локального embedded-движка; на удалённом сервере это будет версия выбранного сервера. PHP_INT_SIZE*8 характеризует целые числа данного PHP и в этом профиле соответствует 64-битной сборке. CLI-проверка не подтверждает настройку Apache/FPM. Не публикуйте полный phpinfo с путями и окружением.

После перехода на PHP 7.4 прежние вызовы ibase_connect/ibase_query исчезли, хотя код приложения сохранился. Реальный вопрос на Stack Overflow. Наш разбор разделяет версию PHP, отдельно устанавливаемое расширение и версию движка. Неподтверждённые утверждения из ответов о жёстком соответствии версии PHP и ODS не перенесены в руководство.

Попробуйте изменить условие

Планировщик показывает cli с interbase 3.0.1, а страница сайта сообщает undefined function ibase_connect. Какой слой нужно проверить следующим?

Одна программа PHP: сравнить запуск без расширения и с расширением

В планировщике скрипт не находит ibase_connect, хотя в другой консоли всё работает. Проверим одну и ту же программу PHP дважды: -n исключает настройки ini, а во втором запуске -d явно подключает нужный модуль. Получится наглядная разница «функции нет → функция есть» без намеренного фатального вызова отсутствующей функции.

Минимальный шаг

if (!function_exists("ibase_connect")) {
    echo "Этот PHP не загрузил interbase";
} else {
    echo "Функция подключения доступна";
}

function_exists проверяет наличие функции до её вызова. Полный пример не меняет php.ini и не устанавливает DLL: proc_open запускает уже настроенный комплект с разными параметрами. Дочерние процессы только сообщают возможности PHP; SQL выполняется родителем отдельно. Полные команды и пути сохраняются в локальных proof-файлах, в публичном отчёте — только результаты сравнения.

Видимый результат

<?php
declare(strict_types=1);
require __DIR__.'/lab.php';
$owned=[];$removed=[];$db=$service=null;
try {
    $config=f159Config();$service=f159Service();$runtime=f159Runtime($service);

    require __DIR__.'/process-lab.php';
    $without=f159Capability(false);
    $with=f159Capability(true);
    $database=f159CreateDatabase($service,$owned,'extension');
    $db=f159Connect($database);
    $product=f159Read($db,'SELECT TITLE AS "title",QTY AS "qty" FROM LAB_ITEMS WHERE ID=?',[1])[0];
    f159Close($db);
    $sameBinary=$without['binary_sha256']===$with['binary_sha256'];
    $rows=[['Один и тот же php.exe',$sameBinary],['Без расширения: ibase_connect доступна',$without['connect_available']],
        ['С расширением: ibase_connect доступна',$with['connect_available']],['Версия подключённого расширения',$with['extension_version']],
        ['Оба запуска исключили php.ini',!$without['ini_loaded'] && !$with['ini_loaded']],
        ['SQL родительского процесса прочитал',$product['title']],['Остаток',$product['qty']]];
    $checks=['same_php_binary'=>$sameBinary && $without['php']===$with['php'],
        'missing_extension_explained'=>$without['extension_loaded']===false && $without['connect_available']===false && $without['extension_version']===null,
        'explicit_extension_loaded'=>$with['extension_loaded']===true && $with['connect_available']===true && $with['extension_version']==='3.0.1',
        'ini_isolated'=>!$without['ini_loaded'] && !$with['ini_loaded'] && !$without['ini_scanned'] && !$with['ini_scanned'],
        'two_distinct_processes'=>$without['pid']!==$with['pid'],
        'parent_query_works'=>$product===['title'=>'Cable','qty'=>3],'parent_closed'=>$db===null];
    $observations=['capability_children'=>[$without,$with],'child_database_connections'=>0,
        'selected'=>$product,'actual_php_binary_same'=>$sameBinary,
        'private_process_proofs'=>['capability-without-process.json','capability-with-process.json']];

} finally {
    if(is_resource($db)){f159Close($db);}
    if(is_resource($service)){f159Detach($service);}
    $removed=f159Cleanup($owned);
}

f159Report('fb159-extension-diagnosis','Одна программа PHP: сравнить запуск без расширения и с расширением',$rows,$checks,$observations,$runtime,$owned,$removed);

Один и тот же php.exe — да
Без расширения: ibase_connect доступна — нет
С расширением: ibase_connect доступна — да
Версия подключённого расширения — 3.0.1
Оба запуска исключили php.ini — да
SQL родительского процесса прочитал — Cable
Остаток — 3

HTML-результат · JSON с наблюдениями.

Ошибки и границы применения

Для загрузки DLL нужны совпадающие PHP minor, ABI, разрядность, TS/NTS и доступные зависимости fbclient. Передайте PHPMAN_FIREBIRD_EXTENSION, как описано в README. Восемь секунд — технический предел маленькой проверки, а не таймаут SQL. Ошибку загрузчика надо читать в stderr; отсутствие функции нельзя исправить паролем БД. CLI с -n не читает php.ini и дополнительный ini-каталог, но наследует обычное окружение процесса. Эти два запуска не имитируют Apache или FPM.

Фоновая задача перестала видеть ibase_connect; изменение некоторого php.ini не объяснило, что читает PHP планировщика. Реальный вопрос на Stack Overflow. Оригинальный пример запускает один бинарный PHP в двух явно различающихся конфигурациях и показывает возможности каждого. Затем отдельный реальный SELECT проверяет следующий слой.

Попробуйте изменить условие

Оба запуска используют один SHA256 php.exe, но только второй видит ibase_connect. Следует ли переустанавливать базу?

Формат даты доставки: увидеть изменение и вернуть исходные настройки

Для накладной нужна дата 29.02.2024, а другой потребитель ожидает 2024-02-29. На одной строке товара покажем, как настройки расширения меняют строковое представление SQL DATE, TIME и TIMESTAMP. Сохранение и восстановление настроек отделяет временное оформление отчёта от поведения остальной программы.

Минимальный шаг

$before = ini_get("ibase.dateformat");
$old = ini_set("ibase.dateformat", "%d.%m.%Y");
if ($old === false) { throw new RuntimeException("Формат недоступен для изменения"); }
try {
    echo ini_get("ibase.dateformat"); // %d.%m.%Y
} finally {
    ini_set("ibase.dateformat", $before);
}

ini_get читает действующее значение. ini_set возвращает предыдущую строку либо false, поэтому нужна строгая проверка === false: пустая предыдущая строка допустима. %d означает день, %m месяц, %Y четырёхзначный год, %H часы, %M минуты, %S секунды. Это шаблоны нативного strftime, а не форматы PHP date() с d.m.Y. В полном примере SQL CAST создаёт значения трёх разных типов; таблица показывает их фактическое преобразование расширением.

Видимый результат

<?php
declare(strict_types=1);
require __DIR__.'/lab.php';
$owned=[];$removed=[];$db=$service=null;
try {
    $config=f159Config();$service=f159Service();$runtime=f159Runtime($service);

    $database=f159CreateDatabase($service,$owned,'formats');
    $db=f159Connect($database);
    $sql="SELECT TITLE AS \"title\",CAST('2024-02-29' AS DATE) AS \"day\","
        ."CAST('13:14:15' AS TIME) AS \"time\",CAST('2024-02-29 13:14:15' AS TIMESTAMP) AS \"stamp\" "
        .'FROM LAB_ITEMS WHERE ID=1';
    $wanted=['ibase.dateformat'=>'%d.%m.%Y','ibase.timeformat'=>'%H:%M',
        'ibase.timestampformat'=>'%d.%m.%Y %H:%M:%S'];
    $saved=[];$returns=[];
    foreach($wanted as $key=>$value){$saved[$key]=ini_get($key);}
    $before=f159Read($db,$sql)[0];
    try{
        foreach($wanted as $key=>$value){
            $previous=ini_set($key,$value);
            if($previous===false)throw new RuntimeException('Этот процесс не разрешил изменение формата.');
            $returns[$key]=$previous;
        }
        $during=f159Read($db,$sql)[0];
    }finally{
        foreach($saved as $key=>$value){
            if(ini_set($key,$value)===false)throw new RuntimeException('Исходный формат не восстановлен.');
        }
    }
    $after=f159Read($db,$sql)[0];
    $restored=true;foreach($saved as $key=>$value){$restored=$restored && ini_get($key)===$value;}
    f159Close($db);
    $rows=[['Товар',$before['title']],['Дата до изменения',$before['day']],['Дата для накладной',$during['day']],
        ['Время до изменения',$before['time']],['Время для накладной',$during['time']],['Полная отметка',$during['stamp']],
        ['Дата после восстановления',$after['day']],['Настройки восстановлены',$restored]];
    $checks=['default_formats'=>$before===['title'=>'Cable','day'=>'2024-02-29','time'=>'13:14:15','stamp'=>'2024-02-29 13:14:15'],
        'custom_formats'=>$during===['title'=>'Cable','day'=>'29.02.2024','time'=>'13:14','stamp'=>'29.02.2024 13:14:15'],
        'old_values_returned'=>$returns===$saved,'original_settings_restored'=>$restored,
        'same_sql_after_restore'=>$after===$before,'closed'=>$db===null];
    $observations=['before'=>$before,'during'=>$during,'after'=>$after,'original_ini'=>$saved,
        'requested_ini'=>$wanted,'ini_set_returns'=>$returns,'stored_values_not_modified'=>true,
        'scope'=>'текущий процесс выполнения, не редактирование php.ini'];

} finally {
    if(is_resource($db)){f159Close($db);}
    if(is_resource($service)){f159Detach($service);}
    $removed=f159Cleanup($owned);
}

f159Report('fb159-effective-ini','Формат даты доставки: увидеть изменение и вернуть исходные настройки',$rows,$checks,$observations,$runtime,$owned,$removed);

Товар — Cable
Дата до изменения — 2024-02-29
Дата для накладной — 29.02.2024
Время до изменения — 13:14:15
Время для накладной — 13:14
Полная отметка — 29.02.2024 13:14:15
Дата после восстановления — 2024-02-29
Настройки восстановлены — да

HTML-результат · JSON с наблюдениями.

Ошибки и границы применения

ini_set не переписывает php.ini и не изменяет хранимые даты. Эти три настройки INI_ALL можно менять во время выполнения; INI_SYSTEM этим способом не настраивается. Выбор формата влияет на последующие fetch в текущем выполнении, поэтому для обычного сайта часто удобнее сохранять стандартный формат и отдельно оформлять поле средствами DateTimeImmutable. В исходнике 3.0.1 разбор входных строк зависит от HAVE_STRPTIME; нельзя заключать, что любой формат вывода автоматически станет универсальным форматом входных параметров на Windows. Показан вывод фиксированных SQL-значений без часового пояса, а не преобразование часовых поясов.

Функция подключения уже существует, но сервер отклоняет имя кодировки; явный charset в вызове отсутствует. Реальный вопрос на Stack Overflow. Нужно исследовать действующий default_charset и поддерживаемые имена Firebird. HTML-кодировка, загрузка DLL и кодировка соединения не одно и то же. Пример не копирует чужие реквизиты подключения из вопроса.

Попробуйте изменить условие

Почему после печати накладной надо восстановить формат, если значения в базе не менялись?

Режим чтения и содержимое примечания: разные константы для разных действий

Нужен маленький складской отчёт: один товар в наличии и короткое текстовое примечание. У транзакции зададим режим только чтения, а у fetch — получение содержимого BLOB. На экране будет memo159, а не служебный идентификатор BLOB. Имена констант позволяют понять назначение каждого аргумента без расшифровки чисел.

Минимальный шаг

$flags = IBASE_READ | IBASE_COMMITTED | IBASE_REC_VERSION | IBASE_NOWAIT;
$transaction = ibase_trans($flags, $db);
// Для отдельного шага чтения уже полученного результата:
$row = ibase_fetch_assoc($result, IBASE_FETCH_BLOBS);

Константа — именованное неизменяемое значение, которое расширение предоставляет после загрузки. Оператор | объединяет совместимые битовые флаги. READ задаёт чтение, COMMITTED — уровень изоляции, REC_VERSION — политику версий для такого чтения, NOWAIT — отказ без ожидания при конфликте. FETCH_BLOBS относится к преобразованию результата fetch, а не к изоляции. Короткий фрагмент требует уже открытых $db/$result; полный файл показывает их создание и завершение.

Видимый результат

<?php
declare(strict_types=1);
require __DIR__.'/lab.php';
$owned=[];$removed=[];$db=$service=null;
try {
    $config=f159Config();$service=f159Service();$runtime=f159Runtime($service);

    $database=f159CreateDatabase($service,$owned,'flags');
    $db=f159Connect($database);
    $transaction=null;$result=null;
    $flags=IBASE_READ | IBASE_COMMITTED | IBASE_REC_VERSION | IBASE_NOWAIT;
    $call=f159Capture(static fn()=>ibase_trans($flags,$db));
    if(!is_resource($call['value'])||$call['warning'])f159Failure('Транзакция чтения не начата',$call);
    $transaction=$call['value'];unset($call);
    try{
        $sql='SELECT TITLE AS "title",QTY AS "qty",CAST(\'memo159\' AS BLOB SUB_TYPE TEXT) AS "note" '
            .'FROM LAB_ITEMS WHERE QTY>0 ORDER BY ID ROWS 1';
        $result=f159Query($transaction,$sql);
        $call=f159Capture(static fn()=>ibase_fetch_assoc($result,IBASE_FETCH_BLOBS));
        if(!is_array($call['value'])||$call['warning'])f159Failure('Строка отчёта не прочитана',$call);
        $product=$call['value'];unset($call);
        if(ibase_free_result($result)!==true)f159Failure('Результат не освобождён');$result=null;
        $committed=ibase_commit($transaction);$transaction=null;
        if($committed!==true)f159Failure('Транзакция чтения не завершена');
    }finally{
        if(is_resource($result)){ibase_free_result($result);$result=null;}
        if(is_resource($transaction)){ibase_rollback($transaction);$transaction=null;}
    }
    f159Close($db);
    $rows=[['Назначение транзакции','только чтение'],['Товар в наличии',$product['title']],['Остаток',$product['qty']],
        ['Текст примечания',$product['note']],['Получено содержимое BLOB',$product['note']==='memo159'],
        ['Транзакция завершена',$committed],['Соединение освобождено',$db===null]];
    $checks=['named_transaction_flags'=>$flags===(IBASE_READ | IBASE_COMMITTED | IBASE_REC_VERSION | IBASE_NOWAIT),
        'bounded_selection'=>$product['title']==='Cable' && $product['qty']===3,
        'blob_content_read'=>$product['note']==='memo159','read_transaction_finished'=>$committed===true && $transaction===null,
        'result_released'=>$result===null,'closed'=>$db===null];
    $observations=['transaction_flags'=>['IBASE_READ','IBASE_COMMITTED','IBASE_REC_VERSION','IBASE_NOWAIT'],
        'fetch_flags'=>['IBASE_FETCH_BLOBS'],'selected'=>$product,
        'query'=>'SELECT TITLE,QTY,CAST(\'memo159\' AS BLOB SUB_TYPE TEXT) AS note FROM LAB_ITEMS WHERE QTY>0 ORDER BY ID ROWS 1',
        'concurrent_conflicts_not_simulated'=>true,'large_blobs_not_loaded'=>true];

} finally {
    if(is_resource($db)){f159Close($db);}
    if(is_resource($service)){f159Detach($service);}
    $removed=f159Cleanup($owned);
}

f159Report('fb159-symbolic-flags','Режим чтения и содержимое примечания: разные константы для разных действий',$rows,$checks,$observations,$runtime,$owned,$removed);

Назначение транзакции — только чтение
Товар в наличии — Cable
Остаток — 3
Текст примечания — memo159
Получено содержимое BLOB — да
Транзакция завершена — да
Соединение освобождено — да

HTML-результат · JSON с наблюдениями.

Ошибки и границы применения

Этот пример не создаёт конкурентный конфликт и не измеряет ожидание. Современный сервер может уточнять READ COMMITTED настройкой ReadConsistency — сверяйте его документацию. FETCH_BLOBS переносит весь BLOB в PHP: для больших вложений нужен порционный ibase_blob_get из главы чтения BLOB. SQL ARRAY — отдельный тип базы, а не массив строк PHP; для него есть FETCH_ARRAYS. IBASE_UNIXTIME не используется здесь: на закреплённой Windows-сборке нативный mktime учитывает окружение C-библиотеки, а TIME без даты дал -1 в подготовке. date_default_timezone_set("UTC") этого не исправило; не объявляйте любое полученное число корректной UTC-меткой.

Попробуйте изменить условие

Примечание выросло до 500 МБ. Достаточно ли оставить FETCH_BLOBS и ограничить запрос ROWS 1?

Все семейства IBASE_*: флаги, действия и значения

Имена IBASE_* доступны после загрузки расширения. Часть из них — совместимые битовые флаги, часть — отдельный код действия, часть — значение параметра выбранного действия. Совпадение чисел в разных семействах не делает имена взаимозаменяемыми. Например, READ относится к ibase_trans, FETCH_BLOBS к fetch, а PRP_AM_READONLY передают как значение действия PRP_ACCESS_MODE в обслуживании базы.

В закреплённом runtime обнаружено 66 имён IBASE_*. Ниже сохранены все семейства официального списка и дополнительно отмеченное исходником IBASE_CREATE. Наличие имени не доказывает поддержку соответствующей операции любым современным Firebird/InterBase: часть административных опций историческая. Таблицы объясняют назначение; конкретный набор аргументов и результаты раскрываются по ссылке на соответствующую главу.

Транзакция: доступ, изоляция и ожидание

Перейти к практике этого семейства.

Чтение значений и исторические имена

Перейти к практике этого семейства.

Резервная копия: опции ibase_backup

Перейти к практике этого семейства.

Восстановление: опции ibase_restore

Перейти к практике этого семейства.

Свойства базы: действие и его значение

Перейти к практике этого семейства.

Проверка и обслуживание: что именно запросили

Перейти к практике этого семейства.

Статистика файла и таблиц: ibase_db_info

Перейти к практике этого семейства.

Сведения экземпляра: ibase_server_info

Перейти к практике этого семейства.

Не объединяйте через | взаимоисключающие READ/WRITE, WAIT/NOWAIT или все уровни изоляции. И не складывайте action/value как флаги: PRP_ACCESS_MODE выбирает действие, PRP_AM_READONLY занимает отдельный аргумент. Даже совместимые флаги должны иметь смысл для конкретной функции и версии сервера.

Платформенная граница UNIXTIME проверена отдельно при подготовке этой главы: в Windows с указанным драйвером DATE и TIMESTAMP преобразовывались нативным mktime, а TIME без даты дал -1; изменение PHP timezone на UTC не меняло окружение C-библиотеки. Официальное предупреждение о датах до 1970 также остаётся значимым. Для однозначного обмена датами выбирайте явный формат и часовой пояс в прикладном контракте, проверяя поддерживаемые SQL-типы; не считайте отсутствие PHP-исключения доказательством правильного времени.

READ COMMITTED в современных Firebird может работать с ReadConsistency; сочетания REC_VERSION/REC_NO_VERSION нужно соотносить с настройкой сервера. Эта глава не моделирует конкурентные блокировки и не обещает определённый таймаут. Базовые различия COMMIT/ROLLBACK и retaining раскрыты в транзакциях.

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

Справочник расширения устроен по задачам. Здесь перечислены все 48 основных имён ibase_* из официального ref.ibase и их 48 совместимых имён fbird_*. В закреплённом исходнике fbird_* зарегистрированы как aliases соответствующих ibase_*: это не ещё один драйвер с другими данными. Из уже разобранных функций ссылка ведёт к точной карточке; три операции пользователей пока ведут к официальному описанию и явно отмечены как следующая отдельная тема.

Соединения и жизненный цикл

Запрос, параметры и подготовленный оператор

Результат и его поля

Транзакции и генератор

Ошибки и число изменённых строк

Запись и чтение BLOB

Сервисные сведения, backup и обслуживание

События базы

Управление пользователями сервера — отдельная административная область

Не начинайте с административного API, если нужна карточка товара: connect → параметризованный query/prepare → fetch нужных полей → завершение ресурсов решают обычную задачу. Services API применяют для сведений экземпляра, backup и обслуживания. Пользователи сервера, роли и пользователи вашего сайта — разные сущности; наличие функции add_user не означает, что её следует вызывать из публичной формы регистрации.

Следующий шаг: обслуживать базу с проверяемым результатом

Теперь можно указать конкретный PHP, отличить незагруженный модуль от ошибки соединения, прочитать нужные поля и объяснить действующие настройки. Дальше — обслуживание собственной базы: sweep, ограничения validation и обратимые свойства. Если задача прикладная, переходите к подготовленным запросам и целостным изменениям в транзакции.

Этот раздел сохраняет установку, настройки, константы и полный указатель как справочную основу. Указатель не означает, что каждый административный сценарий уже реализован: операции пользователей отмечены отдельно. Пакет не меняет рабочие настройки PHP или Firebird на сервере читателя.