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

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

    $name=c166CreateTable($db,$owned,'transfer',[
        ['id'=>1,'sku'=>'CELL-A-166','title'=>'Кабель: ячейка А','category'=>'storage','price_cents'=>1200,'qty'=>12,'note'=>null],
        ['id'=>2,'sku'=>'CELL-B-166','title'=>'Кабель: ячейка Б','category'=>'storage','price_cents'=>1200,'qty'=>4,'note'=>null]
    ]);
    $table=c166Qualified($name);
    $before=c166Read($db,'SELECT id,qty FROM '.$table.' ORDER BY id LIMIT 2');
    $modeBefore=cubrid_get_autocommit($db);
    if ($modeBefore!==false) {throw new RuntimeException('Для переноса нужен явный режим транзакции.');}
    $amount=3;$sourceId=1;$destinationId=2;
    if ($amount<=0 || $sourceId===$destinationId) {throw new InvalidArgumentException('Неверные данные переноса.');}
    $committed=false;
    try {
        $debited=c166Command($db,'UPDATE '.$table.' SET qty=qty-? WHERE id=? AND qty>=?',[$amount,$sourceId,$amount]);
        if ($debited!==1) {throw new RuntimeException('Нет источника или недостаточно коробок.');}
        $credited=c166Command($db,'UPDATE '.$table.' SET qty=qty+? WHERE id=?',[$amount,$destinationId]);
        if ($credited!==1) {throw new RuntimeException('Ячейка назначения не найдена.');}
        $commit=c166Capture(static function() use ($db) {return cubrid_commit($db);});
        if ($commit['value']!==true || $commit['warning']) {c166Failure('Перенос не подтверждён',$commit);}
        $committed=true;
    } catch (Throwable $failure) {
        c166Rollback($db);
        throw $failure;
    }
    $modeAfter=cubrid_get_autocommit($db);
    $sameConnection=c166Read($db,'SELECT id,qty FROM '.$table.' ORDER BY id LIMIT 2');
    c166Commit($db);
    c166Close($db);$db=c166Connect();
    $fresh=c166Read($db,'SELECT id,title,qty FROM '.$table.' ORDER BY id LIMIT 2');
    $quantities=array_map(static function(array $row):int {return (int)$row['qty'];},$fresh);
    $rows=[['До переноса: А / Б','12 / 4'],['Перенесено коробок',$amount],
        ['После commit: А / Б',$quantities[0].' / '.$quantities[1]],['Всего коробок',array_sum($quantities)],
        ['Новое подключение видит перенос',$quantities===[9,7]],['Autocommit после commit',$modeAfter]];
    $checks=['before_source'=>(int)$before[0]['qty']===12,'before_destination'=>(int)$before[1]['qty']===4,
        'explicit_mode'=>$modeBefore===false,'debit_one'=>$debited===1,'credit_one'=>$credited===1,
        'commit_confirmed'=>$committed && $commit['value']===true,'mode_stays_manual'=>$modeAfter===false,
        'same_connection_usable'=>array_column($sameConnection,'qty')===['9','7'],
        'fresh_source'=>$quantities[0]===9,'fresh_destination'=>$quantities[1]===7,
        'total_preserved'=>array_sum($quantities)===16,'same_two_cells'=>array_column($fresh,'id')===['1','2']];
    $observations=['before'=>$before,'amount'=>$amount,'affected_rows'=>[$debited,$credited],
        'same_connection_after_commit'=>$sameConnection,'fresh_connection_rows'=>$fresh,
        'mode_before'=>$modeBefore,'mode_after_commit'=>$modeAfter,'commit_return'=>$commit['value']];

} finally {
    if (is_resource($db)) {try {$removed=c166Cleanup($db,$owned);} finally {c166Close($db);}}
}

c166Report('cub166-transfer-commit','Перенести три коробки между двумя ячейками склада',$rows,$checks,$observations,$runtime,$owned,$removed);

До переноса: А / Б — 12 / 4
Перенесено коробок — 3
После commit: А / Б — 9 / 7
Всего коробок — 16
Новое подключение видит перенос — да
Autocommit после commit — нет

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

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

    $name=c166CreateTable($db,$owned,'destination',[
        ['id'=>1,'sku'=>'CELL-A-166','title'=>'Кабель: ячейка А','category'=>'storage','price_cents'=>1200,'qty'=>12,'note'=>null],
        ['id'=>2,'sku'=>'CELL-B-166','title'=>'Кабель: ячейка Б','category'=>'storage','price_cents'=>1200,'qty'=>4,'note'=>null]
    ]);
    $table=c166Qualified($name);$amount=3;$destinationId=9999;
    $before=c166Read($db,'SELECT id,qty FROM '.$table.' ORDER BY id LIMIT 2');
    $modeBefore=cubrid_get_autocommit($db);
    if ($modeBefore!==false) {throw new RuntimeException('Для переноса нужен autocommit=false.');}
    $debited=c166Command($db,'UPDATE '.$table.' SET qty=qty-? WHERE id=? AND qty>=?',[$amount,1,$amount]);
    if ($debited!==1) {throw new RuntimeException('Первое списание не выполнено.');}
    $pending=c166Read($db,'SELECT qty FROM '.$table.' WHERE id=?',[1]);
    $credited=c166Command($db,'UPDATE '.$table.' SET qty=qty+? WHERE id=?',[$amount,$destinationId]);
    if ($credited!==0) {throw new RuntimeException('Ожидалась отсутствующая ячейка назначения.');}
    // SQL был корректным, но бизнес-операцию нельзя завершить частично.
    $rollback=c166Capture(static function() use ($db) {return cubrid_rollback($db);});
    if ($rollback['value']!==true || $rollback['warning']) {c166Failure('Перенос не отменён',$rollback);}
    $sameConnection=c166Read($db,'SELECT id,qty FROM '.$table.' ORDER BY id LIMIT 2');
    c166Commit($db);c166Close($db);$db=c166Connect();
    $fresh=c166Read($db,'SELECT id,title,qty FROM '.$table.' ORDER BY id LIMIT 2');
    $quantities=array_map(static function(array $row):int {return (int)$row['qty'];},$fresh);
    $modeAfter=cubrid_get_autocommit($db);
    $rows=[['До переноса: А / Б','12 / 4'],['А внутри незавершённого переноса',(int)$pending[0]['qty']],
        ['Найдено ячеек назначения',$credited],['После rollback: А / Б',$quantities[0].' / '.$quantities[1]],
        ['Всего коробок',array_sum($quantities)],['Перенос принят',false]];
    $checks=['before_two_cells'=>count($before)===2,'initial_quantities'=>array_column($before,'qty')===['12','4'],
        'manual_mode'=>$modeBefore===false,'first_update_happened'=>$debited===1,
        'own_pending_change_visible'=>(int)$pending[0]['qty']===9,'second_update_matched_nothing'=>$credited===0,
        'rollback_confirmed'=>$rollback['value']===true,'same_connection_restored'=>array_column($sameConnection,'qty')===['12','4'],
        'fresh_state_restored'=>$quantities===[12,4],'total_preserved'=>array_sum($quantities)===16,
        'destination_not_created'=>array_column($fresh,'id')===['1','2'],'manual_mode_preserved'=>$modeAfter===false];
    $observations=['before'=>$before,'pending_source'=>$pending,'destination_requested'=>$destinationId,
        'affected_rows'=>[$debited,$credited],'rollback_return'=>$rollback['value'],
        'same_connection_after_rollback'=>$sameConnection,'fresh_connection_rows'=>$fresh,
        'refusal_reason'=>'Ячейка назначения не найдена; перенос отменён целиком.'];

} finally {
    if (is_resource($db)) {try {$removed=c166Cleanup($db,$owned);} finally {c166Close($db);}}
}

c166Report('cub166-transfer-rollback','Отменить списание, если ячейка назначения не существует',$rows,$checks,$observations,$runtime,$owned,$removed);

До переноса: А / Б — 12 / 4
А внутри незавершённого переноса — 9
Найдено ячеек назначения — 0
После rollback: А / Б — 12 / 4
Всего коробок — 16
Перенос принят — нет

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

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

    $name=c166CreateTable($db,$owned,'batch',[
        ['id'=>1,'sku'=>'CABLE-166','title'=>'Кабель','category'=>'electrical','price_cents'=>1200,'qty'=>12,'note'=>null],
        ['id'=>2,'sku'=>'CLAMP-166','title'=>'Клемма','category'=>'electrical','price_cents'=>1800,'qty'=>4,'note'=>null]
    ]);
    $table=c166Qualified($name);
    $before=c166Read($db,'SELECT id,sku,price_cents,qty FROM '.$table.' ORDER BY id LIMIT 2');
    $changed=c166Command($db,'UPDATE '.$table.' SET price_cents=? WHERE id=?',[9900,1]);
    if ($changed!==1) {throw new RuntimeException('Цена не изменена.');}
    $pending=c166Read($db,'SELECT price_cents FROM '.$table.' WHERE id=?',[1]);
    $request=null;
    try {
        $request=cubrid_prepare($db,'UPDATE '.$table.' SET sku=? WHERE id=?');
        if ($request===false) {c166Failure('Изменение SKU не подготовлено');}
        if (!cubrid_bind($request,1,'CABLE-166','string') || !cubrid_bind($request,2,2,'number')) {
            c166Failure('Параметры SKU не переданы');
        }
        $failure=c166Capture(static function() use ($request) {return cubrid_execute($request);});
        // Capture сохранил ошибку ДО close_request и rollback.
    } finally {if (is_resource($request)) {c166Release($request);}}
    if ($failure['value']!==false) {throw new RuntimeException('Ожидался отказ UNIQUE-ограничения.');}
    $rollback=c166Capture(static function() use ($db) {return cubrid_rollback($db);});
    if ($rollback['value']!==true || $rollback['warning']) {c166Failure('Пакет не отменён',$rollback);}
    $after=c166Read($db,'SELECT id,sku,price_cents,qty FROM '.$table.' ORDER BY id LIMIT 2');
    $modeAfter=cubrid_get_autocommit($db);
    $diagnostic=['code'=>$failure['code'],'facility'=>$failure['facility'],
        'warning'=>$failure['warning'],'message_present'=>$failure['message_present']];
    $rows=[['Цена кабеля до пакета, коп.',1200],['Цена внутри пакета, коп.',(int)$pending[0]['price_cents']],
        ['Повторный SKU принят',$failure['value']!==false],['Цена после rollback, коп.',(int)$after[0]['price_cents']],
        ['SKU второй карточки',$after[1]['sku']],['Исходный каталог восстановлен',$after===$before]];
    $checks=['two_initial_items'=>count($before)===2,'first_edit_applied'=>$changed===1,
        'pending_price_visible'=>(int)$pending[0]['price_cents']===9900,'duplicate_sku_rejected'=>$failure['value']===false,
        'diagnostic_saved'=>$failure['code']===-670 && $failure['facility']===1 && $failure['message_present'],
        'warning_captured'=>$failure['warning']===true,'request_released'=>$request===null,
        'rollback_confirmed'=>$rollback['value']===true,'all_fields_restored'=>$after===$before,
        'original_price_restored'=>(int)$after[0]['price_cents']===1200,'original_sku_preserved'=>$after[1]['sku']==='CLAMP-166',
        'manual_mode_preserved'=>$modeAfter===false];
    $observations=['before'=>$before,'pending_first_price'=>$pending,'after'=>$after,
        'failed_execute_return'=>$failure['value'],'failure'=>$diagnostic,'rollback_return'=>$rollback['value'],
        'business_policy'=>'Один пакет двух изменений: при любом отказе не подтверждать ни одно.'];

} finally {
    if (is_resource($db)) {try {$removed=c166Cleanup($db,$owned);} finally {c166Close($db);}}
}

c166Report('cub166-batch-rollback','Отменить пакет редактирования, когда второй SKU уже занят',$rows,$checks,$observations,$runtime,$owned,$removed);

Цена кабеля до пакета, коп. — 1200
Цена внутри пакета, коп. — 9900
Повторный SKU принят — нет
Цена после rollback, коп. — 1200
SKU второй карточки — CLAMP-166
Исходный каталог восстановлен — да

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

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

    $name=c166CreateTable($db,$owned,'autocommit',[
        ['id'=>1,'sku'=>'CABLE-166','title'=>'Кабель','category'=>'electrical','price_cents'=>1200,'qty'=>12,'note'=>null]
    ]);
    $table=c166Qualified($name);$initialMode=cubrid_get_autocommit($db);
    if ($initialMode!==false) {throw new RuntimeException('Начальное состояние должно быть явным.');}
    $initial=c166Read($db,'SELECT qty FROM '.$table.' WHERE id=?',[1]);
    c166Commit($db); // Завершить предыдущую работу перед сменой режима.
    try {
        $enabled=c166Capture(static function() use ($db) {return cubrid_set_autocommit($db,true);});
        if ($enabled['value']!==true || $enabled['warning']) {c166Failure('Autocommit не включён',$enabled);}
        $automaticMode=cubrid_get_autocommit($db);
        $automaticUpdate=c166Command($db,'UPDATE '.$table.' SET qty=qty+? WHERE id=?',[2,1]);
        $automaticRollback=c166Capture(static function() use ($db) {return cubrid_rollback($db);});
        if ($automaticRollback['value']!==true || $automaticRollback['warning']) {c166Failure('ROLLBACK не выполнен',$automaticRollback);}
        $afterAutomatic=c166Read($db,'SELECT qty FROM '.$table.' WHERE id=?',[1]);
        $disabled=c166Capture(static function() use ($db) {return cubrid_set_autocommit($db,false);});
        if ($disabled['value']!==true || $disabled['warning']) {c166Failure('Явный режим не восстановлен',$disabled);}
        $manualMode=cubrid_get_autocommit($db);
        $manualUpdate=c166Command($db,'UPDATE '.$table.' SET qty=qty+? WHERE id=?',[3,1]);
        $pending=c166Read($db,'SELECT qty FROM '.$table.' WHERE id=?',[1]);
        $manualRollback=c166Capture(static function() use ($db) {return cubrid_rollback($db);});
        if ($manualRollback['value']!==true || $manualRollback['warning']) {c166Failure('Ручная правка не отменена',$manualRollback);}
        $afterManual=c166Read($db,'SELECT qty FROM '.$table.' WHERE id=?',[1]);
    } finally {
        // Лаборатория дальше работает в явном режиме; включения true здесь нет.
        $restored=c166Capture(static function() use ($db) {return cubrid_set_autocommit($db,false);});
        if ($restored['value']!==true || $restored['warning']) {c166Failure('Режим очистки не восстановлен',$restored);}
    }
    $finalMode=cubrid_get_autocommit($db);
    $rows=[['Исходный остаток',(int)$initial[0]['qty']],['Autocommit включён',$automaticMode],
        ['После +2 и rollback при autocommit',(int)$afterAutomatic[0]['qty']],
        ['После выключения autocommit и +3',(int)$pending[0]['qty']],
        ['После rollback ручной правки',(int)$afterManual[0]['qty']],['Autocommit на выходе',$finalMode]];
    $checks=['initial_quantity'=>(int)$initial[0]['qty']===12,'initial_manual'=>$initialMode===false,
        'enable_confirmed'=>$enabled['value']===true,'automatic_mode'=>$automaticMode===true,
        'automatic_update_one'=>$automaticUpdate===1,'automatic_rollback_return'=>$automaticRollback['value']===true,
        'already_committed_change_remains'=>(int)$afterAutomatic[0]['qty']===14,
        'disable_confirmed'=>$disabled['value']===true,'manual_mode'=>$manualMode===false,
        'manual_update_one'=>$manualUpdate===1,'pending_manual_visible'=>(int)$pending[0]['qty']===17,
        'manual_rollback_return'=>$manualRollback['value']===true,'manual_change_cancelled'=>(int)$afterManual[0]['qty']===14,
        'final_manual_mode'=>$finalMode===false];
    $observations=['initial'=>$initial,'autocommit_phase'=>['mode'=>$automaticMode,'affected'=>$automaticUpdate,
        'rollback_return'=>$automaticRollback['value'],'after'=>$afterAutomatic],
        'manual_phase'=>['mode'=>$manualMode,'affected'=>$manualUpdate,'pending'=>$pending,
        'rollback_return'=>$manualRollback['value'],'after'=>$afterManual],
        'final_mode'=>$finalMode,'mode_restored_without_switching_on'=>true];

} finally {
    if (is_resource($db)) {try {$removed=c166Cleanup($db,$owned);} finally {c166Close($db);}}
}

c166Report('cub166-autocommit-boundary','Различить уже сохранённое изменение и ещё отменяемую правку',$rows,$checks,$observations,$runtime,$owned,$removed);

Исходный остаток — 12
Autocommit включён — да
После +2 и rollback при autocommit — 14
После выключения autocommit и +3 — 17
После rollback ручной правки — 14
Autocommit на выходе — нет

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