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

<?php
declare(strict_types=1);
require __DIR__.'/lab.php';
$db=null;$owned=$removed=$rows=$checks=$observations=[];

try {
    $config=c173Config();$db=c173Connect();$runtime=c173Runtime($db);

    // Helpers preserve diagnostics; the SQL operation itself is visible below.
    function compatCall173($db,callable $action): array {
        $call=c173Capture($action);
        $call['connection_code']=cubrid_errno($db);
        $message=cubrid_error($db);
        $call['connection_message_present']=is_string($message)&&$message!=='';
        return $call;
    }
    function selected173($db,string $sql): array {
        $call=compatCall173($db,static function()use($db,$sql){return cubrid_query($sql,$db);});
        if(!is_resource($call['value']) || $call['warning']){c173Failure('Выборка не выполнена',$call);}
        $request=$call['value'];
        try {return c173Rows($request);} finally {c173Release($request);}
    }
    function csvRow173($file,array $fields): void {
        if(fputcsv($file,$fields,';','"','')===false){throw new RuntimeException('Строка CSV не записана');}
    }
    function csvSave173(string $name,array $records): void {
        $file=fopen(__DIR__.'/'.$name,'wb');
        if($file===false){throw new RuntimeException('Файл CSV не открыт');}
        try {foreach($records as $record){csvRow173($file,$record);}}
        finally {fclose($file);}
    }
    function csvRead173(string $name): array {
        $file=fopen(__DIR__.'/'.$name,'rb');
        if($file===false){throw new RuntimeException('Созданный CSV не найден');}
        $records=[];
        try {
            while(($record=fgetcsv($file,0,';','"',''))!==false){
                $records[]=$record;
                if(count($records)>12){throw new RuntimeException('Учебная CSV-выгрузка должна быть ограничена');}
            }
        } finally {fclose($file);}
        return $records;
    }

    $name=c173OwnName($db,$owned,'TABLE','own_id');$table=c173Qualified($name);
    c173Ddl($db,'CREATE TABLE '.$table.' (request_id INTEGER AUTO_INCREMENT(701,1) PRIMARY KEY,title VARCHAR(80) NOT NULL,qty INTEGER NOT NULL)');
    c173Commit($db);
    $insert=compatCall173($db,static function()use($db,$table){
        return cubrid_query("INSERT INTO ".$table." (title,qty) VALUES ('Кабель',3)",$db);
    });
    if($insert['value']!==true || $insert['warning']){c173Failure('Заявка не создана',$insert);}
    // Save the generated ID before another SQL operation changes the context.
    $ownId=cubrid_insert_id($db);
    if(!is_string($ownId) || !preg_match('/^[0-9]+$/D',$ownId)){throw new RuntimeException('Не получен ID своей вставки');}
    c173Commit($db);
    $next=compatCall173($db,static function()use($db,$table){
        return cubrid_query("INSERT INTO ".$table." (title,qty) VALUES ('Хомут',2)",$db);
    });
    if($next['value']!==true || $next['warning']){c173Failure('Вторая заявка не создана',$next);}
    $nextId=cubrid_insert_id($db);
    if(!is_string($nextId)){throw new RuntimeException('ID следующей вставки не получен');}
    c173Commit($db);
    $mine=c173Read($db,'SELECT request_id,title,qty FROM '.$table.' WHERE request_id=?',[$ownId]);
    $afterSelect=cubrid_insert_id($db);
    $all=c173Read($db,'SELECT request_id,title,qty FROM '.$table.' ORDER BY request_id');
    if(count($mine)!==1){throw new RuntimeException('Карточка своей заявки не найдена');}
    $record=$mine[0];
    csvSave173('created-request.csv',[['request_id','title','qty'],[$record['request_id'],$record['title'],$record['qty']]]);
    $parsed=csvRead173('created-request.csv');
    $rows=[['Созданная заявка',$record['request_id'].' | '.$record['title'].' | '.$record['qty']],
        ['Следующая заявка',$nextId],['Тип сохранённого ID',gettype($ownId)],
        ['ID после SELECT',$afterSelect],['CSV','created-request.csv']];
    $checks=['insert_true'=>$insert['value']===true,'own_id_string'=>$ownId==='701',
        'next_id_separate'=>$nextId==='702' && $ownId!==$nextId,
        'own_card_exact'=>$mine===[['request_id'=>'701','title'=>'Кабель','qty'=>'3']],
        'two_requests_saved'=>count($all)===2 && $all[1]['request_id']==='702',
        'select_clears_insert_context'=>$afterSelect===0,
        'csv_exact'=>$parsed===[['request_id','title','qty'],['701','Кабель','3']]];
    $observations=['created_id'=>$ownId,'later_id'=>$nextId,'own_card'=>$mine,'all_requests'=>$all,
        'after_select_insert_id'=>$afterSelect,'csv_rows'=>$parsed];

} finally {

    if (is_resource($db)) {try {$removed=c173Cleanup($db,$owned);} finally {c173Close($db);}}
}

c173Report('cub173-own-insert-id','Создать заявку и открыть именно её карточку',$rows,$checks,$observations,$runtime,$owned,$removed);

Созданная заявка — 701 | Кабель | 3
Следующая заявка — 702
Тип сохранённого ID — string
ID после SELECT — 0
CSV — created-request.csv

Распакуйте весь ZIP и прочитайте README.txt. example.php содержит действия урока, lab.php — подключение к отдельной учебной базе, создание только собственной таблицы и очистку. Запускается CLI-проект с native-расширением cubrid, не публичный обработчик сайта. После запуска result.html показывает результат, result.json — наблюдения, а отдельный файл ниже содержит полученные данные.

<?php
declare(strict_types=1);
require __DIR__.'/lab.php';
$db=null;$owned=$removed=$rows=$checks=$observations=[];

try {
    $config=c173Config();$db=c173Connect();$runtime=c173Runtime($db);

    // Helpers preserve diagnostics; the SQL operation itself is visible below.
    function compatCall173($db,callable $action): array {
        $call=c173Capture($action);
        $call['connection_code']=cubrid_errno($db);
        $message=cubrid_error($db);
        $call['connection_message_present']=is_string($message)&&$message!=='';
        return $call;
    }
    function selected173($db,string $sql): array {
        $call=compatCall173($db,static function()use($db,$sql){return cubrid_query($sql,$db);});
        if(!is_resource($call['value']) || $call['warning']){c173Failure('Выборка не выполнена',$call);}
        $request=$call['value'];
        try {return c173Rows($request);} finally {c173Release($request);}
    }
    function csvRow173($file,array $fields): void {
        if(fputcsv($file,$fields,';','"','')===false){throw new RuntimeException('Строка CSV не записана');}
    }
    function csvSave173(string $name,array $records): void {
        $file=fopen(__DIR__.'/'.$name,'wb');
        if($file===false){throw new RuntimeException('Файл CSV не открыт');}
        try {foreach($records as $record){csvRow173($file,$record);}}
        finally {fclose($file);}
    }
    function csvRead173(string $name): array {
        $file=fopen(__DIR__.'/'.$name,'rb');
        if($file===false){throw new RuntimeException('Созданный CSV не найден');}
        $records=[];
        try {
            while(($record=fgetcsv($file,0,';','"',''))!==false){
                $records[]=$record;
                if(count($records)>12){throw new RuntimeException('Учебная CSV-выгрузка должна быть ограничена');}
            }
        } finally {fclose($file);}
        return $records;
    }

    $name=c173CreateTable($db,$owned,'diagnostics',[
        ['id'=>1,'sku'=>'CB-01','title'=>'Кабель','category'=>'электрика','price_cents'=>12500,'qty'=>3],
        ['id'=>2,'sku'=>'CL-02','title'=>'Хомут','category'=>'крепёж','price_cents'=>250,'qty'=>0]
    ]);$table=c173Qualified($name);
    $bad=compatCall173($db,static function()use($db,$table){return cubrid_query('SELECT absent_column FROM '.$table,$db);});
    if($bad['value']!==false){throw new RuntimeException('Контрольный SQL неожиданно выполнился');}
    // Diagnostics are already saved. Explicitly end this unit before recovery.
    c173Rollback($db);
    $call=compatCall173($db,static function()use($db,$table){return cubrid_query('SELECT id,title,qty FROM '.$table.' WHERE qty>0 ORDER BY id',$db);});
    if(!is_resource($call['value']) || $call['warning']){c173Failure('Каталог не прочитан',$call);}
    $recoveredCode=$call['connection_code'];$recoveredMessage=$call['connection_message_present'];
    $request=$call['value'];
    try {$catalog=c173Rows($request);} finally {c173Release($request);}
    $empty=selected173($db,'SELECT id,title FROM '.$table.' WHERE id=999');
    $diagnosticRows=[['stage','outcome','code','message_present'],['invalid_column','sql_error',$bad['connection_code'],$bad['connection_message_present']?'yes':'no'],
        ['recovered_catalog','1 row',$recoveredCode,$recoveredMessage?'yes':'no'],['empty_selection','0 rows',0,'no']];
    csvSave173('query-diagnostics.csv',$diagnosticRows);
    $parsed=csvRead173('query-diagnostics.csv');
    $rows=[['Ошибочный столбец','SQL отклонён; причина сохранена'],['Сохранённый код',$bad['connection_code']],['Исправленный каталог',$catalog[0]['id'].' | '.$catalog[0]['title'].' | '.$catalog[0]['qty']],
        ['Новая диагностика',$recoveredCode],['Поиск id=999',count($empty)],['CSV','query-diagnostics.csv']];
    $checks=['invalid_sql_false'=>$bad['value']===false,'error_saved'=>$bad['warning'] && $bad['connection_code']===-494 && $bad['code']===-494 && $bad['facility']===1 && $bad['connection_message_present'],
        'recovery_rows'=>$catalog===[['id'=>'1','title'=>'Кабель','qty'=>'3']],
        'recovery_diagnostics_reset'=>$recoveredCode===0 && $recoveredMessage===false,
        'empty_is_not_failure'=>$empty===[],
        'csv_exact'=>$parsed===[['stage','outcome','code','message_present'],['invalid_column','sql_error','-494','yes'],['recovered_catalog','1 row','0','no'],['empty_selection','0 rows','0','no']]];
    $observations=['failed_query'=>['code'=>$bad['connection_code'],'message_present'=>$bad['connection_message_present'],
        'warning'=>$bad['warning'],'global_code'=>$bad['code'],'facility'=>$bad['facility']],
        'catalog'=>$catalog,'empty'=>$empty,'after_recovery'=>['code'=>$recoveredCode,'message_present'=>$recoveredMessage],
        'csv_rows'=>$parsed];

} finally {

    if (is_resource($db)) {try {$removed=c173Cleanup($db,$owned);} finally {c173Close($db);}}
}

c173Report('cub173-query-diagnostics','Отличить ошибочный SQL от пустого каталога',$rows,$checks,$observations,$runtime,$owned,$removed);

Ошибочный столбец — SQL отклонён; причина сохранена
Сохранённый код — -494
Исправленный каталог — 1 | Кабель | 3
Новая диагностика — 0
Поиск id=999 — 0
CSV — query-diagnostics.csv

Распакуйте весь ZIP и прочитайте README.txt. example.php содержит действия урока, lab.php — подключение к отдельной учебной базе, создание только собственной таблицы и очистку. Запускается CLI-проект с native-расширением cubrid, не публичный обработчик сайта. После запуска result.html показывает результат, result.json — наблюдения, а отдельный файл ниже содержит полученные данные.

<?php
declare(strict_types=1);
require __DIR__.'/lab.php';
$db=null;$owned=$removed=$rows=$checks=$observations=[];

try {
    $config=c173Config();$db=c173Connect();$runtime=c173Runtime($db);

    // Helpers preserve diagnostics; the SQL operation itself is visible below.
    function compatCall173($db,callable $action): array {
        $call=c173Capture($action);
        $call['connection_code']=cubrid_errno($db);
        $message=cubrid_error($db);
        $call['connection_message_present']=is_string($message)&&$message!=='';
        return $call;
    }
    function selected173($db,string $sql): array {
        $call=compatCall173($db,static function()use($db,$sql){return cubrid_query($sql,$db);});
        if(!is_resource($call['value']) || $call['warning']){c173Failure('Выборка не выполнена',$call);}
        $request=$call['value'];
        try {return c173Rows($request);} finally {c173Release($request);}
    }
    function csvRow173($file,array $fields): void {
        if(fputcsv($file,$fields,';','"','')===false){throw new RuntimeException('Строка CSV не записана');}
    }
    function csvSave173(string $name,array $records): void {
        $file=fopen(__DIR__.'/'.$name,'wb');
        if($file===false){throw new RuntimeException('Файл CSV не открыт');}
        try {foreach($records as $record){csvRow173($file,$record);}}
        finally {fclose($file);}
    }
    function csvRead173(string $name): array {
        $file=fopen(__DIR__.'/'.$name,'rb');
        if($file===false){throw new RuntimeException('Созданный CSV не найден');}
        $records=[];
        try {
            while(($record=fgetcsv($file,0,';','"',''))!==false){
                $records[]=$record;
                if(count($records)>12){throw new RuntimeException('Учебная CSV-выгрузка должна быть ограничена');}
            }
        } finally {fclose($file);}
        return $records;
    }

    $name=c173CreateTable($db,$owned,'csv_export',[
        ['id'=>1,'sku'=>'CB-01','title'=>'Кабель','category'=>'электрика','price_cents'=>12500,'qty'=>3],
        ['id'=>2,'sku'=>'CL-02','title'=>'Хомут','category'=>'крепёж','price_cents'=>250,'qty'=>4],
        ['id'=>3,'sku'=>'SO-03','title'=>'Розетка','category'=>'электрика','price_cents'=>5000,'qty'=>2],
        ['id'=>4,'sku'=>'BX-04','title'=>'Коробка','category'=>'электрика','price_cents'=>1200,'qty'=>0],
        ['id'=>5,'sku'=>'TP-05','title'=>'Лента','category'=>'электрика','price_cents'=>800,'qty'=>1]
    ]);$table=c173Qualified($name);
    $request=null;$file=null;$count=0;$preview=[];
    try {
        $sql='SELECT sku,title,qty FROM '.$table.' WHERE id BETWEEN 2 AND 4 AND qty>0 ORDER BY id';
        $call=compatCall173($db,static function()use($db,$sql){return cubrid_unbuffered_query($sql,$db);});
        if(!is_resource($call['value']) || $call['warning']){c173Failure('Выгрузка не начата',$call);}
        $request=$call['value'];
        $file=fopen(__DIR__.'/selected-catalog.csv','wb');
        if($file===false){throw new RuntimeException('CSV не открыт');}
        csvRow173($file,['sku','title','qty']);
        while(true){
            $read=c173Capture(static function()use($request){return cubrid_fetch_assoc($request);});
            if($read['warning'] || $read['code']!==0 || $read['value']===null){c173Failure('Строка выгрузки не прочитана',$read);}
            if($read['value']===false){break;}
            $row=$read['value'];
            csvRow173($file,[$row['sku'],$row['title'],$row['qty']]);
            $count++;
            // Bounded screen preview; the export is not accumulated in an array.
            if(count($preview)<3){$preview[]=$row;}
        }
    } finally {
        if(is_resource($file)){fclose($file);}
        c173Release($request);
    }
    // Read back this deliberately tiny fixture only after closing the SQL result.
    $parsed=csvRead173('selected-catalog.csv');
    $stillThere=c173Read($db,'SELECT COUNT(*) AS total FROM '.$table);
    $rows=[['Условие SQL','id от 2 до 4; qty > 0'],['Строка 1',$preview[0]['sku'].' | '.$preview[0]['title'].' | '.$preview[0]['qty']],
        ['Строка 2',$preview[1]['sku'].' | '.$preview[1]['title'].' | '.$preview[1]['qty']],['Выгружено строк',$count],['Всего товаров в базе',(int)$stillThere[0]['total']],['CSV','selected-catalog.csv']];
    $checks=['selected_count'=>$count===2,'bounded_preview'=>count($preview)===2,
        'selected_values'=>$preview===[['sku'=>'CL-02','title'=>'Хомут','qty'=>'4'],['sku'=>'SO-03','title'=>'Розетка','qty'=>'2']],
        'csv_exact'=>$parsed===[['sku','title','qty'],['CL-02','Хомут','4'],['SO-03','Розетка','2']],
        'connection_reused_after_release'=>$stillThere===[['total'=>'5']]];
    $observations=['selected_columns'=>['sku','title','qty'],'preview'=>$preview,'written_rows'=>$count,
        'database_rows'=>(int)$stillThere[0]['total'],'csv_rows'=>$parsed,'memory_benchmark_performed'=>false];

} finally {

    if (is_resource($db)) {try {$removed=c173Cleanup($db,$owned);} finally {c173Close($db);}}
}

c173Report('cub173-csv-export','Выгрузить выбранный участок каталога по одной строке',$rows,$checks,$observations,$runtime,$owned,$removed);

Условие SQL — id от 2 до 4; qty > 0
Строка 1 — CL-02 | Хомут | 4
Строка 2 — SO-03 | Розетка | 2
Выгружено строк — 2
Всего товаров в базе — 5
CSV — selected-catalog.csv

Распакуйте весь ZIP и прочитайте README.txt. example.php содержит действия урока, lab.php — подключение к отдельной учебной базе, создание только собственной таблицы и очистку. Запускается CLI-проект с native-расширением cubrid, не публичный обработчик сайта. После запуска result.html показывает результат, result.json — наблюдения, а отдельный файл ниже содержит полученные данные.

<?php
declare(strict_types=1);
require __DIR__.'/lab.php';
$db=null;$owned=$removed=$rows=$checks=$observations=[];

try {
    $config=c173Config();$db=c173Connect();$runtime=c173Runtime($db);

    // Helpers preserve diagnostics; the SQL operation itself is visible below.
    function compatCall173($db,callable $action): array {
        $call=c173Capture($action);
        $call['connection_code']=cubrid_errno($db);
        $message=cubrid_error($db);
        $call['connection_message_present']=is_string($message)&&$message!=='';
        return $call;
    }
    function selected173($db,string $sql): array {
        $call=compatCall173($db,static function()use($db,$sql){return cubrid_query($sql,$db);});
        if(!is_resource($call['value']) || $call['warning']){c173Failure('Выборка не выполнена',$call);}
        $request=$call['value'];
        try {return c173Rows($request);} finally {c173Release($request);}
    }
    function csvRow173($file,array $fields): void {
        if(fputcsv($file,$fields,';','"','')===false){throw new RuntimeException('Строка CSV не записана');}
    }
    function csvSave173(string $name,array $records): void {
        $file=fopen(__DIR__.'/'.$name,'wb');
        if($file===false){throw new RuntimeException('Файл CSV не открыт');}
        try {foreach($records as $record){csvRow173($file,$record);}}
        finally {fclose($file);}
    }
    function csvRead173(string $name): array {
        $file=fopen(__DIR__.'/'.$name,'rb');
        if($file===false){throw new RuntimeException('Созданный CSV не найден');}
        $records=[];
        try {
            while(($record=fgetcsv($file,0,';','"',''))!==false){
                $records[]=$record;
                if(count($records)>12){throw new RuntimeException('Учебная CSV-выгрузка должна быть ограничена');}
            }
        } finally {fclose($file);}
        return $records;
    }

    $name=c173CreateTable($db,$owned,'text_search',[
        ['id'=>1,'sku'=>'CB-01','title'=>"Кабель O'Reilly",'category'=>'электрика','price_cents'=>12500,'qty'=>3],
        ['id'=>2,'sku'=>'DS-02','title'=>'Скидка 10%','category'=>'акции','price_cents'=>250,'qty'=>1],
        ['id'=>3,'sku'=>'CB-03','title'=>'Кабель обычный','category'=>'электрика','price_cents'=>5000,'qty'=>2]
    ]);$table=c173Qualified($name);
    $search="Кабель O'Reilly";
    $escaped=cubrid_real_escape_string($search,$db);
    if($escaped===false){throw new RuntimeException('Текст SQL не подготовлен');}
    // Only this literal is escaped. The table was generated and validated by lab.php.
    $literal=selected173($db,"SELECT id,title FROM ".$table." WHERE title='".$escaped."' ORDER BY id");
    $bound=c173Read($db,'SELECT id,title FROM '.$table.' WHERE title=? ORDER BY id',[$search]);
    $percent=cubrid_real_escape_string('Скидка 10%',$db);
    if($percent===false){throw new RuntimeException('Второй текст SQL не подготовлен');}
    $exactPercent=selected173($db,"SELECT id,title FROM ".$table." WHERE title='".$percent."'");
    $sortKey='title';$allowedSort=['title'=>'title, id','id'=>'id'];
    if(!array_key_exists($sortKey,$allowedSort)){throw new InvalidArgumentException('Неизвестный порядок');}
    $sorted=selected173($db,'SELECT id,title FROM '.$table.' WHERE id IN (1,3) ORDER BY '.$allowedSort[$sortKey]);
    if(count($literal)!==1 || count($bound)!==1 || count($exactPercent)!==1){throw new RuntimeException('Точное совпадение не найдено');}
    $records=[['method','id','title'],['escaped',$literal[0]['id'],$literal[0]['title']],
        ['prepared',$bound[0]['id'],$bound[0]['title']],['percent_literal',$exactPercent[0]['id'],$exactPercent[0]['title']]];
    csvSave173('text-search.csv',$records);$parsed=csvRead173('text-search.csv');
    $rows=[['Искомое название',$search],['Значение внутри SQL-кавычек',$escaped],
        ['Точный результат',$literal[0]['id'].' | '.$literal[0]['title']],['Параметр дал те же данные',$literal===$bound],
        ['Процент при сравнении =',$exactPercent[0]['id'].' | '.$exactPercent[0]['title']],['CSV','text-search.csv']];
    $checks=['apostrophe_doubled'=>$escaped==="Кабель O''Reilly",'utf8_roundtrip'=>$literal===[['id'=>'1','title'=>"Кабель O'Reilly"]],
        'prepared_same'=>$bound===$literal,'percent_is_literal'=>$exactPercent===[['id'=>'2','title'=>'Скидка 10%']],
        'allowed_order_only'=>count($sorted)===2 && $allowedSort[$sortKey]==='title, id',
        'csv_exact'=>$parsed===[['method','id','title'],['escaped','1',"Кабель O'Reilly"],['prepared','1',"Кабель O'Reilly"],['percent_literal','2','Скидка 10%']]];
    $observations=['input'=>$search,'escaped_literal'=>$escaped,'literal_rows'=>$literal,'parameter_rows'=>$bound,
        'percent_rows'=>$exactPercent,'sort_key'=>$sortKey,'allowed_order_result'=>$sorted,'csv_rows'=>$parsed];

} finally {

    if (is_resource($db)) {try {$removed=c173Cleanup($db,$owned);} finally {c173Close($db);}}
}

c173Report('cub173-legacy-text-search','Найти точное название с апострофом и сравнить с параметром',$rows,$checks,$observations,$runtime,$owned,$removed);

Искомое название — Кабель O'Reilly
Значение внутри SQL-кавычек — Кабель O''Reilly
Точный результат — 1 | Кабель O'Reilly
Параметр дал те же данные — да
Процент при сравнении = — 2 | Скидка 10%
CSV — text-search.csv

Распакуйте весь ZIP и прочитайте README.txt. example.php содержит действия урока, lab.php — подключение к отдельной учебной базе, создание только собственной таблицы и очистку. Запускается CLI-проект с native-расширением cubrid, не публичный обработчик сайта. После запуска result.html показывает результат, result.json — наблюдения, а отдельный файл ниже содержит полученные данные.