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

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

    $name=c168CreateTable($db,$owned,'compatibility',[
        ['id'=>10,'sku'=>'CAB-168','title'=>'Кабель','category'=>'parts','price_cents'=>1250,'qty'=>4,'note'=>null],
        ['id'=>20,'sku'=>'TAPE-168','title'=>'Лента','category'=>'parts','price_cents'=>240,'qty'=>0,'note'=>null],
        ['id'=>30,'sku'=>'CLIP-168','title'=>'Клипса','category'=>'parts','price_cents'=>350,'qty'=>12,'note'=>'В наличии']
    ]);
    $module=cubrid_version();
    $client=c168Capture(static function(){return cubrid_get_client_info();});
    $server=c168Capture(static function()use($db){return cubrid_get_server_info($db);});
    $charset=c168Capture(static function()use($db){return cubrid_get_charset($db);});
    foreach([$client,$server,$charset] as $call) {
        if (!is_string($call['value']) || $call['value']==='' || $call['warning']) {c168Failure('Сведения о компонентах недоступны',$call);}
    }
    $items=c168Read($db,'SELECT sku,title,price_cents,qty FROM '.c168Qualified($name)
        .' WHERE category=? AND qty>0 AND price_cents<=? ORDER BY price_cents,id LIMIT 2',['parts',1500]);
    c168Commit($db);
    $captions=[];
    foreach($items as $item) {$captions[]=$item['title'].' / '.(int)$item['price_cents'].' коп. / '.(int)$item['qty'].' шт.';}
    $rows=[['PHP-модуль cubrid',$module],['Клиентская библиотека CCI',$client['value']],
        ['Сервер',$server['value']],['Кодировка соединения',$charset['value']],
        ['Товар 1',$captions[0]??''],['Товар 2',$captions[1]??''],['Товар без остатка скрыт',!in_array('TAPE-168',array_column($items,'sku'),true)]];
    $checks=['module_reported'=>is_string($module)&&$module!=='','module_profile'=>$module==='11.2.0.0002',
        'client_profile'=>$client['value']==='11.2.0','server_profile'=>$server['value']==='11.3.5.1274',
        'charset_utf8'=>$charset['value']==='utf-8','two_bounded_rows'=>count($items)===2,
        'price_order'=>array_column($items,'sku')===['CLIP-168','CAB-168'],
        'first_caption'=>($captions[0]??null)==='Клипса / 350 коп. / 12 шт.',
        'second_caption'=>($captions[1]??null)==='Кабель / 1250 коп. / 4 шт.',
        'zero_stock_excluded'=>!in_array('TAPE-168',array_column($items,'sku'),true)];
    $observations=['components'=>['php_module'=>$module,'client'=>$client['value'],'server'=>$server['value'],'charset'=>$charset['value']],
        'catalog_rows'=>$items,'projection'=>['sku','title','price_cents','qty'],
        'filter'=>['category'=>'parts','qty_greater_than'=>0,'maximum_price_cents'=>1500],'limit'=>2];

} finally {
    if (function_exists('c168LockChildStopped') && !c168LockChildStopped()) {
        throw new RuntimeException('Дочерний процесс ещё работает; очистка таблицы запрещена до его остановки.');
    }
    if (is_resource($db)) {try {$removed=c168Cleanup($db,$owned);} finally {c168Close($db);}}
}

c168Report('cub168-compatibility-report','Отчёт для переноса каталога: какие компоненты работают и какие товары прочитаны',$rows,$checks,$observations,$runtime,$owned,$removed);

PHP-модуль cubrid — 11.2.0.0002
Клиентская библиотека CCI — 11.2.0
Сервер — 11.3.5.1274
Кодировка соединения — utf-8
Товар 1 — Клипса / 350 коп. / 12 шт.
Товар 2 — Кабель / 1250 коп. / 4 шт.
Товар без остатка скрыт — да

Распакуйте все файлы и выполните example.php по README.txt. 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=c168Config();$db=c168Connect();$runtime=c168Runtime($db);

    $name=c168CreateTable($db,$owned,'charset');$table=c168Qualified($name);
    $title="Кабель O'Reilly";$note='Проверено <склад> & упаковка';
    $before=c168Capture(static function()use($db){return cubrid_get_charset($db);});
    $compat=c168Capture(static function()use($db){return cubrid_client_encoding($db);});
    if (!is_string($before['value']) || !is_string($compat['value']) || $before['warning'] || $compat['warning']) {
        c168Failure('Кодировка соединения не прочитана',$compat);
    }
    $written=c168Command($db,'INSERT INTO '.$table.' (id,sku,title,category,price_cents,qty,note) VALUES (?,?,?,?,?,?,?)',
        [10,'TEXT-168',$title,'parts',1250,4,$note]);
    c168Commit($db);
    $items=c168Read($db,'SELECT title,note,qty FROM '.$table.' WHERE id=? LIMIT 1',[10]);
    $after=c168Capture(static function()use($db){return cubrid_get_charset($db);});
    c168Commit($db);
    if (count($items)!==1) {throw new RuntimeException('Сохранённый товар не прочитан.');}
    $stored=$items[0]['title'];$sameBytes=hash_equals(hash('sha256',$title),hash('sha256',$stored));
    $rows=[['Исходное название',$title],['Полученное название',$stored],['Байт UTF-8 в названии',strlen($stored)],
        ['get_charset',$before['value']],['client_encoding',$compat['value']],['Байты совпали',$sameBytes],
        ['Примечание',$items[0]['note']],['Getters не изменили кодировку',$before['value']===$after['value']]];
    $checks=['inserted_one'=>$written===1,'read_one'=>count($items)===1,'title_exact'=>$stored===$title,
        'byte_identity'=>$sameBytes,'title_bytes'=>strlen($stored)===21,'valid_utf8'=>preg_match('//u',$stored)===1,
        'charset_utf8'=>$before['value']==='utf-8','compatible_getter'=>$compat['value']===$before['value'],
        'getter_preserves_charset'=>$after['value']===$before['value'],'after_no_warning'=>!$after['warning'],
        'note_exact'=>$items[0]['note']===$note,'quantity_preserved'=>$items[0]['qty']==='4'];
    $observations=['input'=>['title'=>$title,'note'=>$note],'stored_row'=>$items[0],
        'sha256_input'=>hash('sha256',$title),'sha256_readback'=>hash('sha256',$stored),
        'input_bytes'=>strlen($title),'readback_bytes'=>strlen($stored),
        'charset_before'=>$before['value'],'charset_after'=>$after['value'],'client_encoding'=>$compat['value']];

} finally {
    if (function_exists('c168LockChildStopped') && !c168LockChildStopped()) {
        throw new RuntimeException('Дочерний процесс ещё работает; очистка таблицы запрещена до его остановки.');
    }
    if (is_resource($db)) {try {$removed=c168Cleanup($db,$owned);} finally {c168Close($db);}}
}

c168Report('cub168-charset-roundtrip','Проверить сохранение названия с кириллицей и апострофом',$rows,$checks,$observations,$runtime,$owned,$removed);

Исходное название — Кабель O'Reilly
Полученное название — Кабель O'Reilly
Байт UTF-8 в названии — 21
get_charset — utf-8
client_encoding — utf-8
Байты совпали — да
Примечание — Проверено <склад> & упаковка
Getters не изменили кодировку — да

Распакуйте все файлы и выполните example.php по README.txt. 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=c168Config();$db=c168Connect();$runtime=c168Runtime($db);

    $name=c168CreateTable($db,$owned,'selection',[
        ['id'=>1,'sku'=>'KIT-168','title'=>'Набор крепежа','category'=>'kits','price_cents'=>890,'qty'=>6,'note'=>null],
        ['id'=>2,'sku'=>'BOX-168','title'=>'Коробка','category'=>'packing','price_cents'=>190,'qty'=>8,'note'=>'']
    ]);
    $listed=c168Capture(static function()use($db){return cubrid_list_dbs($db);});
    if (!is_array($listed['value']) || $listed['warning']) {c168Failure('Список баз недоступен',$listed);}
    $databases=$listed['value'];$allowed=[$config['database']=>'Учебный каталог'];$visible=[];
    foreach(array_keys($databases) as $index) {
        $candidate=cubrid_db_name($databases,(int)$index);
        if ($candidate===false) {throw new RuntimeException('Имя из списка не прочитано.');}
        if (array_key_exists($candidate,$allowed)) {$visible[$candidate]=$allowed[$candidate];}
    }
    $chosen=$config['database'];$foreignChoice='customer-production';
    $foreignDenied=!array_key_exists($foreignChoice,$visible);
    if (!array_key_exists($chosen,$visible)) {throw new RuntimeException('Учебная база не входит в разрешённый список.');}
    $outside=cubrid_db_name($databases,count($databases));
    c168Commit($db);$selectedDb=null;
    try {
        // chosen прошёл allowlist; c168Connect открывает именно эту учебную конфигурацию.
        $selectedDb=c168Connect(true);
        $identity=c168Read($selectedDb,'SELECT DATABASE() AS database_name');
        $catalog=c168Read($selectedDb,'SELECT sku,title,qty FROM '.c168Qualified($name)
            .' WHERE category=? AND qty>0 ORDER BY id LIMIT 2',['kits']);
        c168Commit($selectedDb);
    } finally {c168Close($selectedDb);}
    $actual=$identity[0]['database_name']??null;
    $caption=isset($catalog[0])?$catalog[0]['title'].' — '.(int)$catalog[0]['qty'].' шт.':'';
    $rows=[['Разрешённых вариантов',count($visible)],['Подпись выбора',$visible[$chosen]],
        ['База подтверждена SQL',$actual],['Каталог выбранной базы',$caption],
        ['Чужой выбор отклонён до подключения',$foreignDenied],['Индекс за границей списка отклонён',$outside===false]];
    $checks=['list_is_array'=>is_array($databases),'own_database_listed'=>in_array($config['database'],$databases,true),
        'only_allowed_visible'=>array_keys($visible)===[$config['database']],
        'foreign_denied_before_connect'=>$foreignDenied,'out_of_range_false'=>$outside===false,
        'identity_one_row'=>count($identity)===1,'selected_database_confirmed'=>$actual===$chosen,
        'catalog_one_row'=>count($catalog)===1,'catalog_sku'=>($catalog[0]['sku']??null)==='KIT-168',
        'catalog_caption'=>$caption==='Набор крепежа — 6 шт.','second_connection_closed'=>$selectedDb===null];
    $observations=['database_names'=>$databases,'allowed_names'=>array_keys($allowed),'visible_choices'=>$visible,
        'chosen'=>$chosen,'actual_database'=>$actual,'catalog_rows'=>$catalog,
        'invalid_index'=>count($databases),'invalid_index_return'=>$outside,'foreign_attempt_connected'=>false];

} finally {
    if (function_exists('c168LockChildStopped') && !c168LockChildStopped()) {
        throw new RuntimeException('Дочерний процесс ещё работает; очистка таблицы запрещена до его остановки.');
    }
    if (is_resource($db)) {try {$removed=c168Cleanup($db,$owned);} finally {c168Close($db);}}
}

c168Report('cub168-database-selection','Выбрать разрешённую базу из списка и подтвердить, какой каталог открыт',$rows,$checks,$observations,$runtime,$owned,$removed);

Разрешённых вариантов — 1
Подпись выбора — Учебный каталог
База подтверждена SQL — phpmanual168
Каталог выбранной базы — Набор крепежа — 6 шт.
Чужой выбор отклонён до подключения — да
Индекс за границей списка отклонён — да

Распакуйте все файлы и выполните example.php по README.txt. 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=c168Config();$db=c168Connect();$runtime=c168Runtime($db);

    $name=c168CreateTable($db,$owned,'probe',[
        ['id'=>1,'sku'=>'SCAN-168','title'=>'Сканер','category'=>'equipment','price_cents'=>12900,'qty'=>2,'note'=>null]
    ]);$table=c168Qualified($name);
    $before=c168Capture(static function()use($db){return cubrid_ping($db);});
    if ($before['value']!==true || $before['warning']) {c168Failure('Соединение не отвечает',$before);}
    $bad=c168Capture(static function()use($db,$table){return cubrid_execute($db,'SELECT missing_column_168 FROM '.$table.' WHERE id=1 LIMIT 1');});
    if (is_resource($bad['value'])) {$unexpected=$bad['value'];c168Release($unexpected);throw new RuntimeException('Ожидаемый отказ неизвестного поля не произошёл.');}
    // Диагностика уже сохранена; следующая операция вправе её заменить.
    $failure=['code'=>$bad['code'],'facility'=>$bad['facility'],'warning'=>$bad['warning'],'message_present'=>$bad['message_present']];
    c168Rollback($db);
    $after=c168Capture(static function()use($db){return cubrid_ping($db);});
    if ($after['value']!==true || $after['warning']) {c168Failure('Соединение после отмены не отвечает',$after);}
    $items=c168Read($db,'SELECT title,qty FROM '.$table.' WHERE id=? LIMIT 1',[1]);
    $empty=c168Read($db,'SELECT title,qty FROM '.$table.' WHERE category=? ORDER BY id LIMIT 2',['not-listed']);
    c168Commit($db);
    $caption=isset($items[0])?$items[0]['title'].' — '.(int)$items[0]['qty'].' шт.':'';
    $rows=[['Соединение до запроса отвечает',$before['value']],['Неверный SELECT отклонён',$bad['value']===false],
        ['Причина задачи','Выбрано несуществующее поле'],['Соединение после отказа отвечает',$after['value']],
        ['Исправленный SELECT',$caption],['Строк в пустой выборке',count($empty)],['Пустая выборка является SQL-ошибкой',false]];
    $checks=['initial_ping_true'=>$before['value']===true,'bad_query_false'=>$bad['value']===false,
        'error_code_captured'=>$failure['code']===-494,'error_facility_captured'=>$failure['facility']===1,
        'error_warning_captured'=>$failure['warning'],'error_message_presence'=>$failure['message_present'],
        'ping_after_failure_true'=>$after['value']===true,'correct_query_one_row'=>count($items)===1,
        'correct_caption'=>$caption==='Сканер — 2 шт.','empty_query_succeeded'=>$empty===[],
        'stock_unchanged'=>($items[0]['qty']??null)==='2'];
    $observations=['ping_before'=>$before['value'],'failed_query_return'=>$bad['value'],'failed_query'=>$failure,
        'ping_after'=>$after['value'],'successful_rows'=>$items,'empty_rows'=>$empty,
        'server_was_stopped'=>false,'automatic_retries'=>0];

} finally {
    if (function_exists('c168LockChildStopped') && !c168LockChildStopped()) {
        throw new RuntimeException('Дочерний процесс ещё работает; очистка таблицы запрещена до его остановки.');
    }
    if (is_resource($db)) {try {$removed=c168Cleanup($db,$owned);} finally {c168Close($db);}}
}

c168Report('cub168-connection-probe','Сервер отвечает, а запрос неверен: разделить три исхода задачи',$rows,$checks,$observations,$runtime,$owned,$removed);

Соединение до запроса отвечает — да
Неверный SELECT отклонён — да
Причина задачи — Выбрано несуществующее поле
Соединение после отказа отвечает — да
Исправленный SELECT — Сканер — 2 шт.
Строк в пустой выборке — 0
Пустая выборка является SQL-ошибкой — нет

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