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

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

try {
    $config=c174Config();$db=c174Connect();$runtime=c174Runtime($db);

    function saveCsv174(string $filename,array $records): void {
        $file=fopen(__DIR__.'/'.$filename,'wb');
        if($file===false){throw new RuntimeException('Не удалось создать CSV');}
        try {
            foreach($records as $record){
                if(fputcsv($file,$record,';','"','')===false){throw new RuntimeException('Строка CSV не записана');}
            }
        } finally {fclose($file);}
    }
    function readCsv174(string $filename): array {
        $file=fopen(__DIR__.'/'.$filename,'rb');
        if($file===false){throw new RuntimeException('Созданный CSV не найден');}
        $records=[];
        try {
            while(($record=fgetcsv($file,0,';','"',''))!==false){
                $records[]=$record;
                if(count($records)>30){throw new RuntimeException('Учебный файл неожиданно велик');}
            }
        } finally {fclose($file);}
        return $records;
    }

    // This function owns only the request it creates. The caller owns $db.
    function borrowedRows174($db,string $sql,int $orderNo,string $label,array &$trace): array {
        $request=null;
        $call=c174Capture(static function()use($db,$sql){return cubrid_prepare($db,$sql);});
        if(!is_resource($call['value']) || $call['warning']){c174Failure('Запрос не подготовлен',$call);}
        $request=$call['value'];
        try {
            $bound=c174Capture(static function()use($request,$orderNo){return cubrid_bind($request,1,$orderNo,'number');});
            if($bound['value']!==true || $bound['warning']){c174Failure('Номер заявки не связан',$bound);}
            $run=c174Capture(static function()use($request){return cubrid_execute($request);});
            if($run['value']!==true || $run['warning']){c174Failure('Данные заявки не прочитаны',$run);}
            $result=[];
            while(true){
                $next=c174Capture(static function()use($request){return cubrid_fetch_assoc($request);});
                if($next['value']===false && $next['code']===0 && !$next['warning']){break;}
                if(!is_array($next['value']) || $next['warning']){c174Failure('Строка заявки не получена',$next);}
                $result[]=$next['value'];
            }
            return $result;
        } finally {
            c174Release($request);
            $trace[]=$label.': request closed';
        }
    }
    function pickLines174($db,string $table,int $orderNo,array &$trace): array {
        return borrowedRows174($db,'SELECT sku,title,wanted,available,CASE WHEN wanted>available THEN wanted-available ELSE 0 END AS missing FROM '.$table.' WHERE order_no=? ORDER BY line_no',$orderNo,'pick-list',$trace);
    }
    function shortage174($db,string $table,int $orderNo,array &$trace): array {
        return borrowedRows174($db,'SELECT COUNT(*) AS positions,SUM(wanted-available) AS missing FROM '.$table.' WHERE order_no=? AND wanted>available',$orderNo,'shortage',$trace);
    }
    $name=c174OwnName($db,$owned,'TABLE','ownership');$table=c174Qualified($name);
    c174Ddl($db,'CREATE TABLE '.$table.' (line_no INTEGER PRIMARY KEY,order_no INTEGER NOT NULL,sku VARCHAR(24) NOT NULL,title VARCHAR(80) NOT NULL,wanted INTEGER NOT NULL,available INTEGER NOT NULL)');
    c174Commit($db);
    foreach([[1,501,'CAB-1','Кабель',5,3],[2,501,'CLP-2','Хомут',2,8],[3,501,'SOC-3','Розетка',4,0],[4,502,'BOX-4','Коробка',9,9]] as $line){
        c174Command($db,'INSERT INTO '.$table.' (line_no,order_no,sku,title,wanted,available) VALUES (?,?,?,?,?,?)',$line);
    }
    c174Commit($db);
    $trace=[];
    try {
        $lines=pickLines174($db,$table,501,$trace);
        $summary=shortage174($db,$table,501,$trace);
        // The request resources are gone; the connection remains usable.
        $stillOpen=c174Read($db,'SELECT COUNT(*) AS total FROM '.$table);
        c174Commit($db);$trace[]='caller: commit';
    } catch(Throwable $error) {c174Rollback($db);throw $error;}
    $records=[['sku','title','wanted','available','missing']];
    foreach($lines as $line){$records[]=[$line['sku'],$line['title'],$line['wanted'],$line['available'],$line['missing']];}
    saveCsv174('pick-list.csv',$records);
    $expected=[['sku','title','wanted','available','missing'],['CAB-1','Кабель','5','3','2'],['CLP-2','Хомут','2','8','0'],['SOC-3','Розетка','4','0','4']];
    $rows=[['Заявка','501'],['Кабель','нужно 5; доступно 3; не хватает 2'],
        ['Хомут','нужно 2; доступно 8; не хватает 0'],['Розетка','нужно 4; доступно 0; не хватает 4'],
        ['Дефицит',$summary[0]['positions'].' позиции; '.$summary[0]['missing'].' единиц'],
        ['Завершение',implode(' → ',$trace)],['CSV','pick-list.csv']];
    $checks=['chosen_order'=>count($lines)===3,'actual_items'=>$records===$expected,
        'summary_in_sql'=>$summary===[['positions'=>'2','missing'=>'6']],
        'borrowed_connection_survives'=>$stillOpen===[['total'=>'4']],
        'requests_released'=>$trace===['pick-list: request closed','shortage: request closed','caller: commit'],
        'ordinary_rows_after_commit'=>is_array($lines[0])&&$lines[0]['title']==='Кабель',
        'csv_exact'=>readCsv174('pick-list.csv')===$expected];
    $observations=['selected_order'=>501,'items'=>$lines,'shortage'=>$summary,'ownership_trace'=>$trace,
        'other_order_not_selected'=>true,'transactions_owned_by'=>'caller','csv_rows'=>readCsv174('pick-list.csv')];

} finally {

    if (is_resource($db)) {try {$removed=c174Cleanup($db,$owned);} finally {c174Close($db);}}
}

c174Report('cub174-resource-ownership','Два модуля комплектования заимствуют одно соединение',$rows,$checks,$observations,$runtime,$owned,$removed);

Заявка — 501
Кабель — нужно 5; доступно 3; не хватает 2
Хомут — нужно 2; доступно 8; не хватает 0
Розетка — нужно 4; доступно 0; не хватает 4
Дефицит — 2 позиции; 6 единиц
Завершение — pick-list: request closed → shortage: request closed → caller: commit
CSV — pick-list.csv

Распакуйте весь ZIP и прочитайте README.txt. example.php содержит логику урока, lab.php — проверку отдельной среды и работу с собственными ресурсами. Этот проект выполняет SQL и удаляет только свою учебную таблицу. После запуска откройте result.html и скачиваемый ниже JSON или CSV.

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

try {
    $config=c174Config();$db=c174Connect();$runtime=c174Runtime($db);

    function saveCsv174(string $filename,array $records): void {
        $file=fopen(__DIR__.'/'.$filename,'wb');
        if($file===false){throw new RuntimeException('Не удалось создать CSV');}
        try {
            foreach($records as $record){
                if(fputcsv($file,$record,';','"','')===false){throw new RuntimeException('Строка CSV не записана');}
            }
        } finally {fclose($file);}
    }
    function readCsv174(string $filename): array {
        $file=fopen(__DIR__.'/'.$filename,'rb');
        if($file===false){throw new RuntimeException('Созданный CSV не найден');}
        $records=[];
        try {
            while(($record=fgetcsv($file,0,';','"',''))!==false){
                $records[]=$record;
                if(count($records)>30){throw new RuntimeException('Учебный файл неожиданно велик');}
            }
        } finally {fclose($file);}
        return $records;
    }

    function preset174(string $name): array {
        $allowed=['screen'=>['mode'=>CUBRID_ASSOC,'symbol'=>'CUBRID_ASSOC'],
                  'csv'=>['mode'=>CUBRID_NUM,'symbol'=>'CUBRID_NUM']];
        if(!isset($allowed[$name])){throw new InvalidArgumentException('Неизвестный профиль результата');}
        return $allowed[$name];
    }
    function exportRows174($db,string $table,string $profile,string $category,int $limit,int &$executions): array {
        $choice=preset174($profile);
        if($limit<1 || $limit>20){throw new InvalidArgumentException('Предел строк должен быть от 1 до 20');}
        $sql='SELECT sku,title,qty FROM '.$table.' WHERE category=? AND qty>0 ORDER BY id LIMIT '.$limit;
        $call=c174Capture(static function()use($db,$sql){return cubrid_prepare($db,$sql);});
        if(!is_resource($call['value']) || $call['warning']){c174Failure('Профильный запрос не подготовлен',$call);}
        $request=$call['value'];$records=[];
        try {
            $bound=c174Capture(static function()use($request,$category){return cubrid_bind($request,1,$category,'string');});
            if($bound['value']!==true || $bound['warning']){c174Failure('Категория не связана',$bound);}
            $run=c174Capture(static function()use($request){return cubrid_execute($request);});$executions++;
            if($run['value']!==true || $run['warning']){c174Failure('Выгрузка не выполнена',$run);}
            while(true){
                $next=c174Capture(static function()use($request,$choice){return cubrid_fetch($request,$choice['mode']);});
                if($next['value']===false && $next['code']===0 && !$next['warning']){break;}
                if(!is_array($next['value']) || $next['warning']){c174Failure('Строка выгрузки не прочитана',$next);}
                $records[]=$next['value'];
            }
        } finally {c174Release($request);}
        return $records;
    }
    $name=c174CreateTable($db,$owned,'presets',[
        ['id'=>1,'sku'=>'CAB-1','title'=>'Кабель','category'=>'электрика','price_cents'=>1000,'qty'=>3],
        ['id'=>2,'sku'=>'CLP-2','title'=>'Хомут','category'=>'крепёж','price_cents'=>100,'qty'=>8],
        ['id'=>3,'sku'=>'SOC-3','title'=>'Розетка','category'=>'электрика','price_cents'=>2000,'qty'=>0],
        ['id'=>4,'sku'=>'CAB-4','title'=>"Кабель O'Reilly",'category'=>'электрика','price_cents'=>1100,'qty'=>2]]);
    $table=c174Qualified($name);$executions=0;
    $screen=exportRows174($db,$table,'screen','электрика',2,$executions);
    $csv=exportRows174($db,$table,'csv','электрика',2,$executions);
    $before=$executions;$rejected=false;
    try {exportRows174($db,$table,'CUBRID_BOTH','электрика',2,$executions);}
    catch(InvalidArgumentException $expected){$rejected=true;}
    c174Commit($db);
    $normalized=[];foreach($screen as $record){$normalized[]=[$record['sku'],$record['title'],$record['qty']];}
    $expected=[['CAB-1','Кабель','3'],['CAB-4',"Кабель O'Reilly",'2']];
    saveCsv174('selected-export.csv',array_merge([['sku','title','qty']],$csv));
    $rows=[['Экран: ключи',implode(', ',array_keys($screen[0]))],['CSV: ключи',implode(', ',array_keys($csv[0]))],
        ['Первая позиция',implode(' | ',$csv[0])],['Вторая позиция',implode(' | ',$csv[1])],
        ['Неизвестный профиль',$rejected?'отклонён до SQL':'не отклонён'],['Выполнено SELECT',$executions],['CSV','selected-export.csv']];
    $checks=['screen_shape'=>array_keys($screen[0])===['sku','title','qty'],
        'csv_shape'=>array_keys($csv[0])===[0,1,2],'same_values'=>$normalized===$csv&&$csv===$expected,
        'sql_selects_available'=>count($csv)===2,'unknown_before_sql'=>$rejected&&$before===$executions&&$executions===2,
        'named_modes'=>preset174('screen')['mode']===CUBRID_ASSOC&&preset174('csv')['mode']===CUBRID_NUM,
        'utf8_apostrophe'=>$csv[1][1]==="Кабель O'Reilly",'csv_exact'=>readCsv174('selected-export.csv')===array_merge([['sku','title','qty']],$expected)];
    $observations=['selected_category'=>'электрика','limit'=>2,'screen'=>$screen,'csv'=>$csv,
        'profiles'=>['screen'=>'CUBRID_ASSOC','csv'=>'CUBRID_NUM'],'invalid_rejected_before_sql'=>$rejected&&$before===$executions];

} finally {

    if (is_resource($db)) {try {$removed=c174Cleanup($db,$owned);} finally {c174Close($db);}}
}

c174Report('cub174-preset-export','Именованный профиль выбирает форму результата, а SQL — строки',$rows,$checks,$observations,$runtime,$owned,$removed);

Экран: ключи — sku, title, qty
CSV: ключи — 0, 1, 2
Первая позиция — CAB-1 | Кабель | 3
Вторая позиция — CAB-4 | Кабель O'Reilly | 2
Неизвестный профиль — отклонён до SQL
Выполнено SELECT — 2
CSV — selected-export.csv

Распакуйте весь ZIP и прочитайте README.txt. example.php содержит логику урока, lab.php — проверку отдельной среды и работу с собственными ресурсами. Этот проект выполняет SQL и удаляет только свою учебную таблицу. После запуска откройте result.html и скачиваемый ниже JSON или CSV.

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

    function saveCsv174(string $filename,array $records): void {
        $file=fopen(__DIR__.'/'.$filename,'wb');
        if($file===false){throw new RuntimeException('Не удалось создать CSV');}
        try {
            foreach($records as $record){
                if(fputcsv($file,$record,';','"','')===false){throw new RuntimeException('Строка CSV не записана');}
            }
        } finally {fclose($file);}
    }
    function readCsv174(string $filename): array {
        $file=fopen(__DIR__.'/'.$filename,'rb');
        if($file===false){throw new RuntimeException('Созданный CSV не найден');}
        $records=[];
        try {
            while(($record=fgetcsv($file,0,';','"',''))!==false){
                $records[]=$record;
                if(count($records)>30){throw new RuntimeException('Учебный файл неожиданно велик');}
            }
        } finally {fclose($file);}
        return $records;
    }

    if(!function_exists('token_get_all')){throw new RuntimeException('Для разбора исходников нужен модуль tokenizer');}
    $map=json_decode(file_get_contents(__DIR__.'/api-map.json'),true,512,JSON_THROW_ON_ERROR);
    function auditTokens174(string $source): array {
        $result=[];$line=1;
        foreach(token_get_all($source) as $token){
            $id=is_array($token)?$token[0]:null;
            $text=is_array($token)?$token[1]:$token;
            $start=is_array($token)?$token[2]:$line;
            if(!in_array($id,[T_WHITESPACE,T_COMMENT,T_DOC_COMMENT],true)){
                $result[]=['id'=>$id,'text'=>$text,'line'=>$start];
            }
            $line=$start+substr_count($text,"\n");
        }
        return $result;
    }
    function inspectFile174(string $filename,string $source,array $map): array {
        $tokens=auditTokens174($source);
        // Resolving namespaces and imported function aliases requires a parser.
        foreach($tokens as $token){
            if(in_array($token['id'],[T_NAMESPACE,T_USE],true)){
                return [[$filename,(string)$token['line'],'*namespace*','scope','manual','manual-namespace']];
            }
        }
        $findings=[];$count=count($tokens);
        for($i=0;$i<$count;$i++){
            $token=$tokens[$i];$next=$tokens[$i+1]??null;$previous=$tokens[$i-1]??null;
            if($next===null || $next['text']!=='('){continue;}
            if($previous!==null && in_array($previous['id'],[T_OBJECT_OPERATOR,T_DOUBLE_COLON,T_NEW,T_NS_SEPARATOR],true)){continue;}
            if($token['id']===T_VARIABLE){
                $findings[]=[$filename,(string)$token['line'],$token['text'],'dynamic','manual','manual-call-target'];continue;
            }
            if($token['id']!==T_STRING){continue;}
            if($previous!==null && ($previous['id']===T_FUNCTION || ($previous['text']==='&' && ($tokens[$i-2]['id']??null)===T_FUNCTION))){continue;}
            $name=strtolower($token['text']);
            if(strpos($name,'cubrid_')!==0){continue;}
            $family=$map[$name]['family']??'unknown';
            $available=function_exists($name)?'yes':'no';
            $actions=['native'=>'keep-native','compatibility'=>'review-compatible','legacy_lob'=>'plan-lob2','obsolete'=>'export-on-old-system','unknown'=>'manual-api'];
            $findings[]=[$filename,(string)$token['line'],$name,$family,$available,$actions[$family]];
        }
        return $findings;
    }
    $records=[['file','line','call','family','available','next_step']];$unchanged=true;$links=[];
    foreach(['catalog.php','legacy.php','namespaced.php'] as $filename){
        $path=__DIR__.'/sample/'.$filename;
        $before=hash_file('sha256',$path);$source=file_get_contents($path);
        if($source===false){throw new RuntimeException('Синтетический исходник не прочитан');}
        foreach(inspectFile174($filename,$source,$map) as $finding){
            $records[]=$finding;
            if(isset($map[$finding[2]])){$links[$finding[2]]='?phpchapter='.$map[$finding[2]]['chapter'].'#'.$map[$finding[2]]['anchor'];}
        }
        $unchanged=$unchanged&&hash_file('sha256',$path)===$before;
    }
    saveCsv174('api-audit.csv',$records);
    $counts=['native'=>0,'compatibility'=>0,'legacy_lob'=>0,'obsolete'=>0,'dynamic'=>0,'scope'=>0,'unknown'=>0];
    foreach(array_slice($records,1) as $record){$counts[$record[3]]++;}
    $rows=[['Прямые вызовы CUBRID',$counts['native']+$counts['compatibility']+$counts['legacy_lob']+$counts['obsolete']],
        ['Нативная группа',$counts['native']],['Совместимая группа',$counts['compatibility']],
        ['Legacy LOB','cubrid_lob_export: доступен; план перехода к LOB2'],
        ['GLO','cubrid_send_glo: отсутствует; нужен экспорт в старой среде'],
        ['Ручной разбор','$callable() и файл с namespace'],['Исходники',$unchanged?'не изменены и не исполнены':'изменены'],['CSV','api-audit.csv']];
    $expected=json_decode(file_get_contents(__DIR__.'/audit-expected.json'),true,512,JSON_THROW_ON_ERROR);
    $checks=['exact_call_sites'=>$records===$expected,'native_count'=>$counts['native']===7,
        'compatibility_count'=>$counts['compatibility']===2,'legacy_available'=>$records[10][4]==='yes',
        'glo_absent'=>$records[11][2]==='cubrid_send_glo'&&$records[11][4]==='no',
        'manual_cases'=>$counts['dynamic']===1&&$counts['scope']===1,
        'source_unchanged'=>$unchanged,'no_database'=>$owned===[]&&$runtime['transport']==='no_database_connection',
        'csv_exact'=>readCsv174('api-audit.csv')===$expected];
    $observations=['findings'=>array_slice($records,1),'counts'=>$counts,'reference_links'=>$links,
        'source_files_executed'=>false,'scope'=>'PHP 7.4 direct unqualified calls; namespace/use and variable calls need review'];

c174Report('cub174-api-audit','Составить план поддержки старого PHP-кода без его запуска',$rows,$checks,$observations,$runtime,$owned,$removed);

Прямые вызовы CUBRID — 11
Нативная группа — 7
Совместимая группа — 2
Legacy LOB — cubrid_lob_export: доступен; план перехода к LOB2
GLO — cubrid_send_glo: отсутствует; нужен экспорт в старой среде
Ручной разбор — $callable() и файл с namespace
Исходники — не изменены и не исполнены
CSV — api-audit.csv

Распакуйте весь ZIP и прочитайте README.txt. example.php содержит логику урока, lab.php — проверку отдельной среды и работу с собственными ресурсами. Этот проект читает локальные файлы и возможности CLI, не открывая соединение с базой. После запуска откройте result.html и скачиваемый ниже JSON или CSV.