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

<?php
declare(strict_types=1);
require __DIR__.'/lab.php';
$db=null;$owned=$removed=$rows=$checks=$observations=[];
try {
    $config=f154Config();$db=f154Connect($config);$runtime=f154Runtime($db,$config);

    $items=f154OwnTable($db,$owned,'outcome','(ID INTEGER NOT NULL PRIMARY KEY, STOCK INTEGER NOT NULL CHECK (STOCK >= 0))');
    $q=f154Qualified($items);
    f154Command($db,"INSERT INTO $q (ID,STOCK) VALUES (?,?)",[1,3]);
    f154Commit($db);
    $quantity=2;
    if ($quantity<=0) {throw new InvalidArgumentException('Количество должно быть положительным');}
    $first=f154Query($db,"UPDATE $q SET STOCK=STOCK-? WHERE ID=? AND STOCK>=?",[$quantity,1,$quantity]);
    $firstCount=ibase_affected_rows($db);
    if ($firstCount===false) {f154Failure('Нет количества строк первого UPDATE');}
    if ($firstCount!==1) {throw new RuntimeException('Первое резервирование должно изменить один товар');}
    f154Commit($db);
    $second=f154Query($db,"UPDATE $q SET STOCK=STOCK-? WHERE ID=? AND STOCK>=?",[$quantity,1,$quantity]);
    $secondCount=ibase_affected_rows($db);
    if ($secondCount===false) {f154Failure('Нет количества строк второго UPDATE');}
    if ($secondCount!==0) {throw new RuntimeException('Недостаточный остаток не должен изменяться');}
    f154Commit($db);
    $stock=(int)f154Read($db,"SELECT STOCK FROM $q WHERE ID=?",[1])[0]['STOCK'];
    $rows=[['Начальный остаток',3],['Запрошено в каждом резервировании',$quantity],
        ['Первый UPDATE вернул число 1',$first===1],['Первый UPDATE: изменено строк',$firstCount],
        ['Второй UPDATE вернул true',$second===true],['Второй UPDATE: изменено строк',$secondCount],
        ['Остаток после двух запросов',$stock],['Второй запрос является ошибкой SQL',$second===false]];
    $checks=['first_return'=>$first===1,'first_affected'=>$firstCount===1,'second_success_without_change'=>$second===true,
        'second_affected_zero'=>$secondCount===0,'stock_never_negative'=>$stock===1,'positive_quantity'=>$quantity===2];
    $observations=['initial_stock'=>3,'quantity'=>2,'first_return'=>$first,'first_affected'=>$firstCount,
        'second_return'=>$second,'second_affected'=>$secondCount,'final_stock'=>$stock,
        'conditional_update'=>true,'selection_of_all_rows'=>false,'separate_requests_committed'=>2];

} finally {
    if (is_resource($db)) {try {$removed=f154Cleanup($db,$owned);} finally {ibase_close($db);}}
}

f154Report('fb154-update-outcome','Зарезервировать товар и отличить отсутствие остатка от ошибки SQL',$rows,$checks,$observations,$runtime,$owned,$removed);

Начальный остаток — 3
Запрошено в каждом резервировании — 2
Первый UPDATE вернул число 1 — да
Первый UPDATE: изменено строк — 1
Второй UPDATE вернул true — да
Второй UPDATE: изменено строк — 0
Остаток после двух запросов — 1
Второй запрос является ошибкой SQL — нет

Запустите example.php по README.txt. lab.php содержит открытый код проверки отдельной базы, захвата ожидаемых предупреждений, чтения и вывода отчёта. Создаётся одна собственная таблица; после наблюдений она удаляется. Рядом остаются result.html, result.json и metrics.json.

<?php
declare(strict_types=1);
require __DIR__.'/lab.php';
$db=null;$owned=$removed=$rows=$checks=$observations=[];
try {
    $config=f154Config();$db=f154Connect($config);$runtime=f154Runtime($db,$config);

    $items=f154OwnTable($db,$owned,'sql_error','(ID INTEGER NOT NULL PRIMARY KEY, TITLE VARCHAR(40) CHARACTER SET UTF8 NOT NULL)');
    $q=f154Qualified($items);
    f154Command($db,"INSERT INTO $q (ID,TITLE) VALUES (?,?)",[1,'Кабель']);
    f154Commit($db);
    // Capture immediately reads ibase_errcode and ibase_errmsg; it does not publish raw diagnostics.
    $failed=f154Capture(static fn()=>ibase_query($db,"SELECT NOT_A_FIELD FROM $q"));
    $savedCode=ibase_errcode();$savedMessage=ibase_errmsg();
    $messagePresent=is_string($savedMessage)&&$savedMessage!=='';
    $mentionsBadColumn=$messagePresent&&str_contains($savedMessage,'NOT_A_FIELD');
    unset($savedMessage);
    if ($failed['value']!==false || $savedCode!==-206 || !$messagePresent) {
        throw new RuntimeException('Ожидался контролируемый отказ из-за неизвестного столбца');
    }
    $result=f154Query($db,"SELECT ID,TITLE FROM $q ORDER BY ID");
    $afterCode=ibase_errcode();$afterMessage=ibase_errmsg();
    try {$validRows=f154Rows($result);}
    finally {
        if (ibase_free_result($result)!==true) {f154Failure('Результат исправленного SELECT не освобождён');}
        $result=null;
    }
    $rows=[['Ошибочный SELECT вернул false',$failed['value']===false],['Сохранённый код ошибки',$savedCode],
        ['Сообщение получено сразу',$messagePresent],['Сообщение указало NOT_A_FIELD',$mentionsBadColumn],
        ['После исправленного SELECT код ошибки отсутствует',$afterCode===false],
        ['После исправленного SELECT сообщение отсутствует',$afterMessage===false],
        ['Исправленный SELECT вернул название',$validRows[0]['TITLE']],['Сохранённый код после исправления',$savedCode]];
    $checks=['invalid_sql_false'=>$failed['value']===false,'expected_error_code'=>$savedCode===-206,
        'error_message_captured'=>$messagePresent&&$failed['message_present'],'column_identified'=>$mentionsBadColumn,
        'php_warning_captured'=>$failed['warning'],'next_query_cleared_error'=>$afterCode===false&&$afterMessage===false,
        'correct_query_rows'=>$validRows===[['ID'=>1,'TITLE'=>'Кабель']],'saved_snapshot_retained'=>$savedCode===-206];
    $observations=['failed_return'=>$failed['value'],'captured_code'=>$savedCode,'warning_captured'=>$failed['warning'],
        'message_present'=>$messagePresent,'mentions_bad_column'=>$mentionsBadColumn,'raw_error_text_published'=>false,
        'code_after_success'=>$afterCode,'message_after_success'=>$afterMessage,'correct_rows'=>$validRows];

} finally {
    if (is_resource($db)) {try {$removed=f154Cleanup($db,$owned);} finally {ibase_close($db);}}
}

f154Report('fb154-sql-error','Сохранить причину ошибки до следующего обращения к драйверу',$rows,$checks,$observations,$runtime,$owned,$removed);

Ошибочный SELECT вернул false — да
Сохранённый код ошибки — -206
Сообщение получено сразу — да
Сообщение указало NOT_A_FIELD — да
После исправленного SELECT код ошибки отсутствует — да
После исправленного SELECT сообщение отсутствует — да
Исправленный SELECT вернул название — Кабель
Сохранённый код после исправления — -206

Запустите example.php по README.txt. lab.php содержит открытый код проверки отдельной базы, захвата ожидаемых предупреждений, чтения и вывода отчёта. Создаётся одна собственная таблица; после наблюдений она удаляется. Рядом остаются result.html, result.json и metrics.json.

<?php
declare(strict_types=1);
require __DIR__.'/lab.php';
$db=null;$owned=$removed=$rows=$checks=$observations=[];
try {
    $config=f154Config();$db=f154Connect($config);$runtime=f154Runtime($db,$config);

    $items=f154OwnTable($db,$owned,'constraint','(ID INTEGER NOT NULL PRIMARY KEY, TITLE VARCHAR(40) CHARACTER SET UTF8 NOT NULL, PRICE_KOPECKS INTEGER NOT NULL CHECK (PRICE_KOPECKS >= 0))');
    $q=f154Qualified($items);
    f154Command($db,"INSERT INTO $q (ID,TITLE,PRICE_KOPECKS) VALUES (?,?,?)",[1,'Кабель',2500]);
    f154Commit($db);
    $tx=ibase_trans(IBASE_WRITE,$db);
    if ($tx===false) {f154Failure('Транзакция изменения каталога не начата');}
    try {
        f154Command($tx,"UPDATE $q SET PRICE_KOPECKS=? WHERE ID=?",[2000,1]);
        $changed=ibase_affected_rows($tx);
        if ($changed!==1) {throw new RuntimeException('Должна измениться цена одного товара');}
        $tentative=(int)f154Read($tx,"SELECT PRICE_KOPECKS FROM $q WHERE ID=?",[1])[0]['PRICE_KOPECKS'];
        $duplicate=f154Capture(static fn()=>ibase_query($tx,"INSERT INTO $q (ID,TITLE,PRICE_KOPECKS) VALUES (?,?,?)",1,'Переходник',900));
        if ($duplicate['value']!==false || $duplicate['code']!==-803 || !$duplicate['message_present']) {
            throw new RuntimeException('Ожидался контролируемый отказ из-за повторного ID');
        }
        // A failed second statement does not itself undo the successful first statement.
        $rolledBack=ibase_rollback($tx);
        if ($rolledBack!==true) {f154Failure('Не удалось отменить весь пакет каталога');}
        $tx=null;
    } finally {
        if (is_resource($tx)) {
            if (ibase_rollback($tx)!==true) {f154Failure('Не удалось завершить незаконченный пакет');}
            $tx=null;
        }
    }
    $stored=f154Read($db,"SELECT ID,TITLE,PRICE_KOPECKS FROM $q ORDER BY ID");
    $rows=[['Цена до пакета, коп.',2500],['Цена внутри транзакции после UPDATE, коп.',$tentative],
        ['Первая команда изменила строк',$changed],['Вторая команда вернула false',$duplicate['value']===false],
        ['Код нарушения уникальности',$duplicate['code']],['Весь пакет явно отменён',$rolledBack],
        ['Цена после rollback, коп.',$stored[0]['PRICE_KOPECKS']],['Товаров после rollback',count($stored)]];
    $checks=['first_write_happened'=>$changed===1&&$tentative===2000,'duplicate_rejected'=>$duplicate['value']===false,
        'constraint_diagnostic'=>$duplicate['code']===-803&&$duplicate['message_present']&&$duplicate['warning'],
        'explicit_rollback'=>$rolledBack===true,'original_price_restored'=>$stored[0]['PRICE_KOPECKS']===2500,
        'catalog_unchanged'=>$stored===[['ID'=>1,'TITLE'=>'Кабель','PRICE_KOPECKS'=>2500]]];
    $observations=['price_before'=>2500,'price_inside_transaction'=>2000,'first_affected'=>$changed,
        'duplicate_return'=>$duplicate['value'],'duplicate_error_code'=>$duplicate['code'],
        'duplicate_message_present'=>$duplicate['message_present'],'raw_error_text_published'=>false,
        'explicit_rollback'=>$rolledBack,'commits_for_business_batch'=>0,'stored_rows_after'=>$stored];

} finally {
    if (is_resource($db)) {try {$removed=f154Cleanup($db,$owned);} finally {ibase_close($db);}}
}

f154Report('fb154-constraint-rollback','Отменить пакет изменения каталога при дублирующемся ключе',$rows,$checks,$observations,$runtime,$owned,$removed);

Цена до пакета, коп. — 2500
Цена внутри транзакции после UPDATE, коп. — 2000
Первая команда изменила строк — 1
Вторая команда вернула false — да
Код нарушения уникальности — -803
Весь пакет явно отменён — да
Цена после rollback, коп. — 2500
Товаров после rollback — 1

Запустите example.php по README.txt. lab.php содержит открытый код проверки отдельной базы, захвата ожидаемых предупреждений, чтения и вывода отчёта. Создаётся одна собственная таблица; после наблюдений она удаляется. Рядом остаются result.html, result.json и metrics.json.

<?php
declare(strict_types=1);
require __DIR__.'/lab.php';
$db=null;$owned=$removed=$rows=$checks=$observations=[];
try {
    $config=f154Config();$db=f154Connect($config);$runtime=f154Runtime($db,$config);

    $counters=f154OwnTable($db,$owned,'close','(ID INTEGER NOT NULL PRIMARY KEY, COUNTER_VALUE INTEGER NOT NULL)');
    $q=f154Qualified($counters);
    f154Command($db,"INSERT INTO $q (ID,COUNTER_VALUE) VALUES (?,?)",[1,100]);
    f154Commit($db);
    f154Command($db,"UPDATE $q SET COUNTER_VALUE=? WHERE ID=?",[166,1]);
    $changed=ibase_affected_rows($db);
    if ($changed!==1) {throw new RuntimeException('Счётчик не обновлён');}
    $committed=ibase_commit($db);
    if ($committed!==true) {f154Failure('Изменение счётчика не подтверждено');}
    $closed=ibase_close($db);
    if ($closed!==true) {f154Failure('Первое соединение не закрыто');}
    $db=null;
    $db=f154Connect($config);
    $result=f154Query($db,"SELECT COUNTER_VALUE FROM $q WHERE ID=?",[1]);
    try {$values=f154Rows($result);}
    finally {
        if (ibase_free_result($result)!==true) {f154Failure('Результат повторного чтения не освобождён');}
        $result=null;
    }
    $persisted=(int)$values[0]['COUNTER_VALUE'];
    // End the read transaction explicitly as well, before final table cleanup and close.
    f154Commit($db);
    $rows=[['Первое соединение изменило строк',$changed],['Commit проверен до close',$committed],
        ['Первое соединение закрыто',$closed],['Новое соединение читает сохранённое значение',$persisted],
        ['Копия результата остаётся в PHP',$values[0]['COUNTER_VALUE']],['Обращений к прежнему закрытому ресурсу',0]];
    $checks=['one_row_updated'=>$changed===1,'commit_before_close'=>$committed===true,'close_succeeded'=>$closed===true,
        'reopened_connection_works'=>is_resource($db),'committed_value_persisted'=>$persisted===166,
        'php_array_copy_retained'=>$values===[['COUNTER_VALUE'=>166]]];
    $observations=['initial_value'=>100,'committed_value'=>166,'reopened_value'=>$persisted,
        'write_commit_explicit'=>true,'read_commit_explicit'=>true,'first_connection_closed'=>$closed,
        'old_handle_called_after_close'=>false,'persistent_connection_used'=>false,
        'lifecycle'=>['connect','write','explicit commit','close + null','connect again','read','free_result + null','explicit commit','cleanup own table','close']];

} finally {
    if (is_resource($db)) {try {$removed=f154Cleanup($db,$owned);} finally {ibase_close($db);}}
}

f154Report('fb154-connection-close','Подтвердить изменения, закрыть соединение и прочитать их заново',$rows,$checks,$observations,$runtime,$owned,$removed);

Первое соединение изменило строк — 1
Commit проверен до close — да
Первое соединение закрыто — да
Новое соединение читает сохранённое значение — 166
Копия результата остаётся в PHP — 166
Обращений к прежнему закрытому ресурсу — 0

Запустите example.php по README.txt. lab.php содержит открытый код проверки отдельной базы, захвата ожидаемых предупреждений, чтения и вывода отчёта. Создаётся одна собственная таблица; после наблюдений она удаляется. Рядом остаются result.html, result.json и metrics.json.