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

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

    $items=f156OwnTable($db,$owned,'csv','(ID INTEGER NOT NULL PRIMARY KEY, TITLE VARCHAR(60) CHARACTER SET UTF8 NOT NULL, STOCK INTEGER NOT NULL, ACTIVE SMALLINT NOT NULL)');
    $q=f156Qualified($items);
    foreach ([[1,'Кабель; силовой',0,1],[2,'Клемма "мини"',4,1],[3,'Архивный товар',9,0]] as $item) {
        f156Command($db,"INSERT INTO $q (ID,TITLE,STOCK,ACTIVE) VALUES (?,?,?,?)",$item);
    }
    f156Commit($db);
    $result=$stream=null;$fetched=[];$eof=false;
    $csvFile=__DIR__.'/catalog.csv';
    try {
        $result=f156Query($db,"SELECT ID,TITLE,STOCK FROM $q WHERE ACTIVE=? ORDER BY ID",[1]);
        $stream=fopen($csvFile,'wb');
        if ($stream===false) {throw new RuntimeException('CSV не открыт для записи');}
        if (fputcsv($stream,['id','title','stock'],';','"','',"\n")===false) {throw new RuntimeException('Заголовок CSV не записан');}
        while (true) {
            $call=f156Capture(static fn()=>ibase_fetch_row($result));
            if ($call['warning'] || $call['code']!==0) {f156Failure('Ошибка чтения строки',$call);}
            if ($call['value']===false) {$eof=true;break;}
            $row=$call['value'];
            if (fputcsv($stream,$row,';','"','',"\n")===false) {throw new RuntimeException('Строка CSV не записана');}
            $fetched[]=$row; // Только две строки учебного отчёта; большой экспорт так не накапливают.
        }
    } finally {
        if (is_resource($stream)) {fclose($stream);$stream=null;}
        if (is_resource($result)) {ibase_free_result($result);$result=null;}
    }
    f156Commit($db);
    $expectedCsv="id;title;stock\n1;\"Кабель; силовой\";0\n2;\"Клемма \"\"мини\"\"\";4\n";
    $actualCsv=file_get_contents($csvFile);
    if ($actualCsv===false) {throw new RuntimeException('CSV не прочитан после записи');}
    $parsed=[];$stream=fopen($csvFile,'rb');
    if ($stream===false) {throw new RuntimeException('CSV не открыт повторно');}
    try {while (($line=fgetcsv($stream,0,';','"',''))!==false) {$parsed[]=$line;}}
    finally {fclose($stream);$stream=null;}
    $rows=[['Файл рядом с example.php','catalog.csv'],['Заголовок CSV','id;title;stock'],
        ['Первая строка CSV','1;"Кабель; силовой";0'],['Вторая строка CSV','2;"Клемма ""мини""";4'],
        ['Выгружено товаров',count($fetched)],['Нулевой остаток сохранён',$fetched[0][2]===0],
        ['Архивный товар исключён SQL',count($fetched)===2],['Обратное чтение CSV восстановило поля',$parsed===[['id','title','stock'],['1','Кабель; силовой','0'],['2','Клемма "мини"','4']]]];
    $checks=['selected_rows'=>$fetched===[[1,'Кабель; силовой',0],[2,'Клемма "мини"',4]],
        'clean_eof'=>$eof,'exact_csv'=>$actualCsv===$expectedCsv,'csv_roundtrip'=>$parsed===[['id','title','stock'],['1','Кабель; силовой','0'],['2','Клемма "мини"','4']],
        'zero_preserved'=>$fetched[0][2]===0,'sql_filtered_archive'=>count($fetched)===2];
    $observations=['query_columns'=>['ID','TITLE','STOCK'],'where_active'=>1,'order_by'=>'ID','fetched_rows'=>$fetched,
        'csv_filename'=>'catalog.csv','csv_utf8'=>$actualCsv,'parsed_csv'=>$parsed,'sha256'=>hash('sha256',$actualCsv),'eof'=>$eof,'production_export_needs_row_accumulation'=>false];

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

f156Report('fb156-csv-export','Выгрузить выбранные товары в CSV, сохранив ноль и кавычки',$rows,$checks,$observations,$runtime,$owned,$removed);

Файл рядом с example.php — catalog.csv
Заголовок CSV — id;title;stock
Первая строка CSV — 1;"Кабель; силовой";0
Вторая строка CSV — 2;"Клемма ""мини""";4
Выгружено товаров — 2
Нулевой остаток сохранён — да
Архивный товар исключён SQL — да
Обратное чтение CSV восстановило поля — да

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

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

    $items=f156OwnTable($db,$owned,'object','(ID INTEGER NOT NULL PRIMARY KEY, TITLE VARCHAR(40) CHARACTER SET UTF8, NOTE VARCHAR(40) CHARACTER SET UTF8, STOCK INTEGER NOT NULL)');
    $q=f156Qualified($items);
    f156Command($db,"INSERT INTO $q (ID,TITLE,NOTE,STOCK) VALUES (?,?,?,?)",[1,'Кабель',null,0]);
    f156Command($db,"INSERT INTO $q (ID,TITLE,NOTE,STOCK) VALUES (?,?,?,?)",[2,'','',4]);
    f156Commit($db);
    $result=f156Query($db,'SELECT ID,TITLE AS "title",NOTE AS "note",STOCK AS "stock" FROM '.$q.' ORDER BY ID');
    try {
        $call=f156Capture(static fn()=>ibase_fetch_object($result));
        if ($call['value']===false || $call['warning']) {f156Failure('Первая карточка не прочитана',$call);}
        $first=$call['value'];unset($call);
        $call=f156Capture(static fn()=>ibase_fetch_object($result));
        if ($call['value']===false || $call['warning']) {f156Failure('Вторая карточка не прочитана',$call);}
        $second=$call['value'];unset($call);
        $end=f156Capture(static fn()=>ibase_fetch_object($result));
        if ($end['warning'] || $end['code']!==0) {f156Failure('Ошибка в конце выдачи',$end);}
    } finally {ibase_free_result($result);$result=null;}
    f156Commit($db);
    $noteLabel=$first->note===null?'не указано':($first->note===''?'пустая строка':$first->note);
    $secondNote=$second->note===null?'не указано':($second->note===''?'пустая строка':$second->note);
    $rows=[['Тип первой строки',get_class($first)],['ID первой карточки',$first->ID],['Название первой карточки',$first->title],
        ['Остаток первой карточки',$first->stock],['Примечание первой карточки',$noteLabel],
        ['Свойство note существует',property_exists($first,'note')],['isset для note с NULL',isset($first->note)],
        ['Название второй карточки пустое',$second->title===''],['Примечание второй карточки',$secondNote],
        ['Остаток второй карточки',$second->stock],['После двух карточек получен конец выдачи',$end['value']===false]];
    $checks=['stdclass'=>get_class($first)==='stdClass','quoted_alias'=>$first->title==='Кабель'&&property_exists($first,'stock'),
        'unquoted_uppercase'=>$first->ID===1,'null_kept'=>$first->note===null,'null_property_exists'=>property_exists($first,'note')&&!isset($first->note),
        'empty_kept'=>$second->title===''&&$second->note==='','zero_kept'=>$first->stock===0,
        'second_stock'=>$second->stock===4,'clean_eof'=>$end['value']===false&&!$end['warning']&&$end['code']===0];
    $observations=['first'=>get_object_vars($first),'second'=>get_object_vars($second),'class'=>get_class($first),
        'null_label'=>$noteLabel,'empty_label'=>$secondNote,'eof'=>$end['value'],'result_freed_before_render'=>true];

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

f156Report('fb156-object-card','Получить карточку товара с понятными свойствами и различить NULL, пустую строку и ноль',$rows,$checks,$observations,$runtime,$owned,$removed);

Тип первой строки — stdClass
ID первой карточки — 1
Название первой карточки — Кабель
Остаток первой карточки — 0
Примечание первой карточки — не указано
Свойство note существует — да
isset для note с NULL — нет
Название второй карточки пустое — да
Примечание второй карточки — пустая строка
Остаток второй карточки — 4
После двух карточек получен конец выдачи — да

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

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

    $items=f156OwnTable($db,$owned,'ids','(ID BIGINT NOT NULL PRIMARY KEY, TITLE VARCHAR(40) CHARACTER SET UTF8 NOT NULL)');
    $q=f156Qualified($items);$sequence=f156OwnSequence($db,$owned,'id_seq');
    $call=f156Capture(static fn()=>ibase_gen_id($sequence,0,$db));
    if ($call['value']===false || $call['warning']) {f156Failure('Значение последовательности не прочитано',$call);}
    $initial=$call['value'];unset($call);
    $call=f156Capture(static fn()=>ibase_gen_id($sequence));
    if ($call['value']===false || $call['warning']) {f156Failure('Первый ID не выдан',$call);}
    $firstId=$call['value'];unset($call);$tx=null;
    try {
        $call=f156Capture(static fn()=>ibase_trans(IBASE_WRITE|IBASE_CONCURRENCY|IBASE_NOWAIT,$db));
        if ($call['value']===false || $call['warning']) {f156Failure('Транзакция не создана',$call);}
        $tx=$call['value'];unset($call);
        f156Command($tx,"INSERT INTO $q (ID,TITLE) VALUES (?,?)",[$firstId,'Отменённый товар']);
        if (ibase_rollback($tx)!==true) {f156Failure('Первая запись не отменена');}
        $tx=null;
    } finally {if (is_resource($tx)) {ibase_rollback($tx);$tx=null;}}
    $call=f156Capture(static fn()=>ibase_gen_id($sequence,0,$db));
    if ($call['value']===false || $call['warning']) {f156Failure('Счётчик после rollback не прочитан',$call);}
    $afterRollback=$call['value'];unset($call);
    $cancelledCount=(int)f156Read($db,"SELECT COUNT(*) AS N FROM $q WHERE ID=?",[$firstId])[0]['N'];
    $call=f156Capture(static fn()=>ibase_gen_id($sequence,1,$db));
    if ($call['value']===false || $call['warning']) {f156Failure('Следующий ID не выдан',$call);}
    $nextId=$call['value'];unset($call);
    f156Command($db,"INSERT INTO $q (ID,TITLE) VALUES (?,?)",[$nextId,'Новый товар']);f156Commit($db);
    $stored=f156Read($db,"SELECT ID,TITLE FROM $q ORDER BY ID");f156Commit($db);
    $rows=[['Начальное значение своей последовательности',$initial],['ID отменённой записи',$firstId],
        ['Строк с отменённым ID после rollback',$cancelledCount],['Счётчик после rollback',$afterRollback],
        ['Следующий выданный ID',$nextId],['Сохранённый товар',$stored[0]['TITLE']],['ID сохранённого товара',$stored[0]['ID']],
        ['Число сохранённых товаров',count($stored)],['Rollback вернул номер в последовательность',$afterRollback===$initial]];
    $checks=['initial_zero'=>$initial===0,'default_increment_one'=>$firstId===1,'cancelled_row_absent'=>$cancelledCount===0,
        'sequence_not_rolled_back'=>$afterRollback===1,'next_id_two'=>$nextId===2,'one_stored_row'=>$stored===[['ID'=>2,'TITLE'=>'Новый товар']],
        'integer_on_current_profile'=>is_int($firstId)&&is_int($nextId)];
    $observations=['initial'=>$initial,'allocated_before_rollback'=>$firstId,'current_after_rollback'=>$afterRollback,
        'cancelled_rows'=>$cancelledCount,'next'=>$nextId,'stored'=>$stored,'generator_name_from_request'=>false,
        'sequence_reset_attempted'=>false,'guaranteed_gapless'=>false];

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

f156Report('fb156-generated-id','Выдать новый ID и увидеть, почему rollback оставляет пропуск',$rows,$checks,$observations,$runtime,$owned,$removed);

Начальное значение своей последовательности — 0
ID отменённой записи — 1
Строк с отменённым ID после rollback — 0
Счётчик после rollback — 1
Следующий выданный ID — 2
Сохранённый товар — Новый товар
ID сохранённого товара — 2
Число сохранённых товаров — 1
Rollback вернул номер в последовательность — нет

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

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

    $items=f156OwnTable($db,$owned,'cursor','(ID INTEGER NOT NULL PRIMARY KEY, TITLE VARCHAR(40) CHARACTER SET UTF8 NOT NULL, STOCK INTEGER NOT NULL)');
    $q=f156Qualified($items);
    foreach ([[1,'Кабель',0],[2,'Клемма',4],[3,'Архив',9]] as $item) {f156Command($db,"INSERT INTO $q (ID,TITLE,STOCK) VALUES (?,?,?)",$item);}
    f156Commit($db);
    $counted=[1=>10,2=>14];$tx=$cursor=$update=null;$applied=[];$cleanEof=false;
    try {
        $call=f156Capture(static fn()=>ibase_trans(IBASE_WRITE|IBASE_CONCURRENCY|IBASE_NOWAIT,$db));
        if ($call['value']===false || $call['warning']) {f156Failure('Транзакция сверки не создана',$call);}
        $tx=$call['value'];unset($call);
        $cursor=f156Query($tx,"SELECT ID,STOCK FROM $q WHERE ID<=2 FOR UPDATE OF STOCK");
        $call=f156Capture(static fn()=>ibase_name_result($cursor,'FB156_STOCK_CURSOR'));
        if ($call['value']!==true || $call['warning']) {f156Failure('Курсор не получил имя',$call);}
        $named=$call['value'];unset($call);
        $call=f156Capture(static fn()=>ibase_prepare($tx,"UPDATE $q SET STOCK=? WHERE CURRENT OF FB156_STOCK_CURSOR"));
        if ($call['value']===false || $call['warning']) {f156Failure('Обновление текущей строки не подготовлено',$call);}
        $update=$call['value'];unset($call);
        while (true) {
            $call=f156Capture(static fn()=>ibase_fetch_row($cursor));
            if ($call['warning'] || $call['code']!==0) {f156Failure('Строка сверки не прочитана',$call);}
            if ($call['value']===false) {$cleanEof=true;break;}
            $current=$call['value'];unset($call);$id=$current[0];
            if (!array_key_exists($id,$counted) || $counted[$id]<0) {throw new RuntimeException('Нет допустимого результата пересчёта');}
            $newStock=$counted[$id];
            $call=f156Capture(static fn()=>ibase_execute($update,$newStock));
            if ($call['value']===false || $call['warning']) {f156Failure('Текущая строка не изменена',$call);}
            $changed=ibase_affected_rows($tx);
            if ($changed!==1) {throw new RuntimeException('Сверка должна изменить ровно текущую строку');}
            $applied[$id]=['before'=>$current[1],'after'=>$newStock,'changed'=>$changed];unset($call);
        }
        if (ibase_free_query($update)!==true) {f156Failure('Подготовка UPDATE не освобождена');}$update=null;
        if (ibase_free_result($cursor)!==true) {f156Failure('Курсор SELECT не освобождён');}$cursor=null;
        if (ibase_commit($tx)!==true) {f156Failure('Сверка остатков не подтверждена');}$tx=null;
    } finally {
        if (is_resource($update)) {ibase_free_query($update);$update=null;}
        if (is_resource($cursor)) {ibase_free_result($cursor);$cursor=null;}
        if (is_resource($tx)) {ibase_rollback($tx);$tx=null;}
    }
    $stored=f156Read($db,"SELECT ID,STOCK FROM $q ORDER BY ID");f156Commit($db);
    $rows=[['Имя назначено открытому результату',$named],['Кабель: остаток до сверки',$applied[1]['before']],
        ['Кабель: остаток после сверки',$stored[0]['STOCK']],['Клемма: остаток до сверки',$applied[2]['before']],
        ['Клемма: остаток после сверки',$stored[1]['STOCK']],['Товар вне выборки сохранил остаток',$stored[2]['STOCK']],
        ['Обновлено текущих строк',count($applied)],['Оба обновления подтверждены одной транзакцией',true],['Курсор дошёл до конца без ошибки',$cleanEof]];
    $checks=['cursor_named'=>$named===true,'two_rows_updated'=>count($applied)===2,
        'first_current_row'=>$applied[1]===['before'=>0,'after'=>10,'changed'=>1],
        'second_current_row'=>$applied[2]===['before'=>4,'after'=>14,'changed'=>1],
        'committed_values'=>$stored===[['ID'=>1,'STOCK'=>10],['ID'=>2,'STOCK'=>14],['ID'=>3,'STOCK'=>9]],
        'outside_selection_unchanged'=>$stored[2]['STOCK']===9,'clean_eof'=>$cleanEof];
    $observations=['cursor_name'=>'FB156_STOCK_CURSOR','counted'=>$counted,'applied'=>$applied,'stored'=>$stored,
        'selection_condition'=>'ID <= 2','same_explicit_transaction'=>true,'update_before_next_fetch'=>true,
        'query_and_result_released_before_commit'=>true,'concurrency_load_test'=>false];

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

f156Report('fb156-positioned-update','Обновить именно текущий товар открытого курсора и сохранить сверку остатков',$rows,$checks,$observations,$runtime,$owned,$removed);

Имя назначено открытому результату — да
Кабель: остаток до сверки — 0
Кабель: остаток после сверки — 10
Клемма: остаток до сверки — 4
Клемма: остаток после сверки — 14
Товар вне выборки сохранил остаток — 9
Обновлено текущих строк — 2
Оба обновления подтверждены одной транзакцией — да
Курсор дошёл до конца без ошибки — да

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