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

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

    $items=f153OwnTable($db,$owned,'reuse','(ID INTEGER NOT NULL PRIMARY KEY, CATEGORY VARCHAR(16) NOT NULL, TITLE VARCHAR(40) CHARACTER SET UTF8 NOT NULL, PRICE_KOPECKS INTEGER NOT NULL, STOCK INTEGER NOT NULL)');
    $q=f153Qualified($items);
    $fixtures=[[1,'cable','Кабель USB',1500,12],[2,'cable','Переходник',3200,0],[3,'cable','Кабель HDMI',4500,7],[4,'accessory','Подставка',8000,3]];
    foreach ($fixtures as $item) {f153Command($db,"INSERT INTO $q (ID,CATEGORY,TITLE,PRICE_KOPECKS,STOCK) VALUES (?,?,?,?,?)",$item);}
    f153Commit($db);
    $query=ibase_prepare($db,"SELECT ID,TITLE,PRICE_KOPECKS FROM $q WHERE CATEGORY=? AND PRICE_KOPECKS<=? AND STOCK>0 ORDER BY PRICE_KOPECKS,ID ROWS 10");
    if ($query===false) {f153Failure('Не удалось подготовить фильтр');}
    $selections=[];$result=null;
    try {
        foreach ([['cable',2000],['cable',5000],['accessory',10000],['missing',5000]] as [$category,$maximum]) {
            $result=ibase_execute($query,$category,$maximum);
            if ($result===false) {f153Failure('Фильтр не выполнен');}
            if (!is_resource($result)) {throw new RuntimeException('SELECT должен вернуть результат');}
            try {$selections[]=f153Rows($result);}
            finally {
                if (ibase_free_result($result)!==true) {f153Failure('Результат фильтра не освобождён');}
                $result=null;
            }
        }
    } finally {
        if (is_resource($result)) {ibase_free_result($result);$result=null;}
        if (ibase_free_query($query)!==true) {f153Failure('Подготовленный фильтр не освобождён');}
        $query=null;
    }
    $ids=array_map(static fn(array $page):array=>array_column($page,'ID'),$selections);
    $total=(int)f153Read($db,"SELECT COUNT(*) AS TOTAL FROM $q")[0]['TOTAL'];
    $rows=[['Подготовок SQL',1],['Выполнений с разными значениями',4],['cable: цена до 2000 копеек',implode(', ',$ids[0])],
        ['cable: цена до 5000 копеек',implode(', ',$ids[1])],['accessory: цена до 10000 копеек',implode(', ',$ids[2])],
        ['Строк для отсутствующей категории',count($selections[3])],['Всего товаров после поиска',$total]];
    $checks=['first_filter'=>$ids[0]===[1],'second_filter'=>$ids[1]===[1,3],'third_filter'=>$ids[2]===[4],
        'empty_result'=>$selections[3]===[],'out_of_stock_excluded'=>!in_array(2,array_merge(...$ids),true),'stored_rows_unchanged'=>$total===4];
    $observations=['filters'=>[['cable',2000],['cable',5000],['accessory',10000],['missing',5000]],'selected_rows'=>$selections,
        'parameter_order'=>['category','maximum_kopecks'],'selected_columns'=>['ID','TITLE','PRICE_KOPECKS'],'row_limit'=>10,
        'prepare_calls'=>1,'execute_calls'=>4,'performance_benchmark'=>false];

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

f153Report('fb153-prepare-reuse','Повторить поиск товара по категории и пределу цены',$rows,$checks,$observations,$runtime,$owned,$removed);

Подготовок SQL — 1
Выполнений с разными значениями — 4
cable: цена до 2000 копеек — 1
cable: цена до 5000 копеек — 1, 3
accessory: цена до 10000 копеек — 4
Строк для отсутствующей категории — 0
Всего товаров после поиска — 4

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

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

    $clients=f153OwnTable($db,$owned,'bound','(ID INTEGER NOT NULL PRIMARY KEY, CLIENT_NAME VARCHAR(80) CHARACTER SET UTF8 NOT NULL, EMAIL VARCHAR(120) CHARACTER SET UTF8 NOT NULL)');
    $q=f153Qualified($clients);$name="О'Коннор";
    $insert=ibase_prepare($db,"INSERT INTO $q (ID,CLIENT_NAME,EMAIL) VALUES (?,?,?)");
    if ($insert===false) {f153Failure('INSERT не подготовлен');}
    try {
        $first=ibase_execute($insert,1,$name,'o.connor@example.test');
        if ($first===false) {f153Failure('Имя не сохранено');}
        $second=ibase_execute($insert,2,'Анна','anna@example.test');
        if ($second===false) {f153Failure('Вторая запись не сохранена');}
        // Deliberate failure: the third required parameter is missing. Capture before another driver call.
        $missing=f153Capture(static fn()=>ibase_execute($insert,3,'Без адреса'));
    } finally {
        if (ibase_free_query($insert)!==true) {f153Failure('INSERT не освобождён');}
        $insert=null;
    }
    f153Commit($db);
    $find=ibase_prepare($db,"SELECT ID,CLIENT_NAME FROM $q WHERE CLIENT_NAME=? ORDER BY ID");
    if ($find===false) {f153Failure('Поиск клиента не подготовлен');}
    $result=null;
    try {
        $result=ibase_execute($find,$name);
        if ($result===false) {f153Failure('Поиск имени не выполнен');}
        try {$found=f153Rows($result);} finally {ibase_free_result($result);$result=null;}
        $result=ibase_execute($find,"x' OR 1=1 --");
        if ($result===false) {f153Failure('Поиск буквального текста не выполнен');}
        try {$literal=f153Rows($result);} finally {ibase_free_result($result);$result=null;}
    } finally {
        if (is_resource($result)) {ibase_free_result($result);$result=null;}
        if (ibase_free_query($find)!==true) {f153Failure('Поиск не освобождён');}
        $find=null;
    }
    $all=f153Read($db,"SELECT ID,CLIENT_NAME,EMAIL FROM $q ORDER BY ID");
    $rows=[['Сохранённое и найденное имя',$found[0]['CLIENT_NAME']],['ID найденного клиента',$found[0]['ID']],
        ['Недостающий параметр вернул false',$missing['value']===false],['Предупреждение PHP перехвачено',$missing['warning']],
        ['Код ошибки сервера при этом',$missing['code']],['Совпадений с буквальным x\' OR 1=1 --',count($literal)],['Записей после ошибочного вызова',count($all)]];
    $checks=['apostrophe_utf8_intact'=>$found===[['ID'=>1,'CLIENT_NAME'=>$name]],'missing_argument_rejected'=>$missing['value']===false,
        'php_warning_captured'=>$missing['warning']===true,'no_server_error_code'=>$missing['code']===0,'literal_not_sql'=>$literal===[],
        'only_valid_rows_saved'=>array_column($all,'ID')===[1,2],'correct_parameter_position'=>$all[0]['EMAIL']==='o.connor@example.test'];
    $observations=['saved_clients'=>$all,'search_rows'=>$found,'literal_search_rows'=>$literal,
        'missing_argument'=>['returned_false'=>$missing['value']===false,'php_warning'=>$missing['warning'],'server_code'=>$missing['code']],
        'parameter_order'=>['ID','CLIENT_NAME','EMAIL'],'connection_charset'=>'UTF8','raw_warning_text_published'=>false];

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

f153Report('fb153-bound-input','Сохранить имя с апострофом и поймать пропущенный параметр',$rows,$checks,$observations,$runtime,$owned,$removed);

Сохранённое и найденное имя — О'Коннор
ID найденного клиента — 1
Недостающий параметр вернул false — да
Предупреждение PHP перехвачено — да
Код ошибки сервера при этом — 0
Совпадений с буквальным x' OR 1=1 -- — 0
Записей после ошибочного вызова — 2

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

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

    $items=f153OwnTable($db,$owned,'metadata','(ID INTEGER NOT NULL PRIMARY KEY, TITLE VARCHAR(40) CHARACTER SET UTF8 NOT NULL, NOTE VARCHAR(20) CHARACTER SET UTF8)');
    $q=f153Qualified($items);
    f153Command($db,"INSERT INTO $q (ID,TITLE,NOTE) VALUES (?,?,?)",[1,'Кабель №7',null]);
    f153Command($db,"INSERT INTO $q (ID,TITLE,NOTE) VALUES (?,?,?)",[2,'Адаптер','']);
    f153Commit($db);
    $query=ibase_prepare($db,"SELECT ID AS ITEM_ID,TITLE AS PRODUCT_NAME,NOTE AS COMMENT_TEXT FROM $q WHERE ID>=? ORDER BY ID");
    if ($query===false) {f153Failure('Отчёт не подготовлен');}
    $result=null;
    try {
        $result=ibase_execute($query,1);
        if ($result===false) {f153Failure('Отчёт не выполнен');}
        $count=ibase_num_fields($result);
        if (!is_int($count)) {throw new RuntimeException('Количество полей не получено');}
        $fields=[];
        for ($index=0;$index<$count;$index++) {
            $info=ibase_field_info($result,$index);
            if (!is_array($info)) {throw new RuntimeException('Описание поля не получено');}
            $fields[]=array_intersect_key($info,array_flip(['name','alias','relation','length','type']));
        }
        $data=f153Rows($result);
    } finally {
        if (is_resource($result)) {ibase_free_result($result);$result=null;}
        if (ibase_free_query($query)!==true) {f153Failure('Отчёт не освобождён');}
        $query=null;
    }
    $headers=array_column($fields,'alias');
    $nullValue=array_key_exists('COMMENT_TEXT',$data[0]) && $data[0]['COMMENT_TEXT']===null;
    $emptyValue=$data[1]['COMMENT_TEXT']==='';
    $rows=[['Столбцов в результате',$count],['Строк данных',count($data)],['Заголовки по alias',implode(', ',$headers)],
        ['Имя исходного второго столбца',$fields[1]['name']],['Его alias в отчёте',$fields[1]['alias']],['Тип второго столбца',$fields[1]['type']],
        ['length второго столбца, байт',(int)$fields[1]['length']],['Первый комментарий действительно NULL',$nullValue],['Второй комментарий — пустая строка',$emptyValue]];
    $checks=['three_columns'=>$count===3,'two_data_rows'=>count($data)===2,'header_aliases'=>$headers===['ITEM_ID','PRODUCT_NAME','COMMENT_TEXT'],
        'source_name_preserved'=>$fields[1]['name']==='TITLE','varchar_type'=>$fields[1]['type']==='VARCHAR',
        'utf8_capacity_bytes'=>(int)$fields[1]['length']===160,'null_not_empty'=>$nullValue && $emptyValue,
        'same_source_relation'=>array_unique(array_column($fields,'relation'))===[$items]];
    $observations=['field_metadata'=>$fields,'data_rows'=>$data,'headers'=>$headers,'source_character_limit'=>40,
        'reported_length_measures_bytes'=>true,'metadata_does_not_supply_nullable_flag'=>true];

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

f153Report('fb153-result-metadata','Собрать заголовки отчёта и отличить описание поля от NULL',$rows,$checks,$observations,$runtime,$owned,$removed);

Столбцов в результате — 3
Строк данных — 2
Заголовки по alias — ITEM_ID, PRODUCT_NAME, COMMENT_TEXT
Имя исходного второго столбца — TITLE
Его alias в отчёте — PRODUCT_NAME
Тип второго столбца — VARCHAR
length второго столбца, байт — 160
Первый комментарий действительно NULL — да
Второй комментарий — пустая строка — да

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

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

    $items=f153OwnTable($db,$owned,'lifecycle','(ID INTEGER NOT NULL PRIMARY KEY, TITLE VARCHAR(40) CHARACTER SET UTF8 NOT NULL)');
    $q=f153Qualified($items);
    foreach ([[1,'Кабель'],[2,'Адаптер'],[3,'Подставка']] as $item) {f153Command($db,"INSERT INTO $q (ID,TITLE) VALUES (?,?)",$item);}
    f153Commit($db);
    $query=ibase_prepare($db,"SELECT ID,TITLE FROM $q WHERE ID>=? ORDER BY ID");
    if ($query===false) {f153Failure('Список не подготовлен');}
    $result=null;
    try {
        $result=ibase_execute($query,1);
        if ($result===false) {f153Failure('Первый список не получен');}
        $firstCall=f153Capture(static fn()=>ibase_fetch_assoc($result));
        if ($firstCall['warning'] || !is_array($firstCall['value'])) {f153Failure('Первая строка не прочитана',$firstCall);}
        $copy=$firstCall['value'];unset($firstCall);
        $freed=ibase_free_result($result);
        if ($freed!==true) {f153Failure('Остаток первого списка не освобождён');}
        $result=null; // Do not use is_resource as proof that a freed old-driver handle is still usable.
        $result=ibase_execute($query,3);
        if ($result===false) {f153Failure('Повторный список не получен');}
        $again=f153Rows($result);
        if (ibase_free_result($result)!==true) {f153Failure('Второй результат не освобождён');}
        $result=null;
    } finally {
        if (is_resource($result)) {ibase_free_result($result);$result=null;}
        $queryFreed=ibase_free_query($query);
        $query=null;
        if ($queryFreed!==true) {f153Failure('Подготовка не освобождена');}
    }
    $total=(int)f153Read($db,"SELECT COUNT(*) AS TOTAL FROM $q")[0]['TOTAL'];
    $rows=[['Прочитанный ID первого списка',$copy['ID']],['Остаток первого результата освобождён',$freed],
        ['ID после повторного execute с порогом 3',implode(', ',array_column($again,'ID'))],['Скопированное имя после освобождения',$copy['TITLE']],
        ['Подготовленный запрос освобождён в конце',$queryFreed],['Соединение после free_query видит товаров',$total],['Повторных вызовов на освобождённом результате',0]];
    $checks=['first_row'=>$copy===['ID'=>1,'TITLE'=>'Кабель'],'first_result_freed'=>$freed===true,
        'prepared_query_reused'=>$again===[['ID'=>3,'TITLE'=>'Подставка']],'query_released'=>$queryFreed===true,
        'php_copy_survives'=>$copy['TITLE']==='Кабель','connection_still_works'=>$total===3];
    $observations=['first_row_copy'=>$copy,'second_execution_rows'=>$again,'first_execution_unread_rows'=>2,
        'resource_order'=>['prepare','execute(1)','fetch one','free_result + null','execute(3)','fetch all','free_result + null','free_query + null','query count'],
        'invalid_released_handle_called'=>false,'table_rows_after'=>3];

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

f153Report('fb153-prepared-cleanup','Закрыть ненужную выдачу и повторить тот же запрос',$rows,$checks,$observations,$runtime,$owned,$removed);

Прочитанный ID первого списка — 1
Остаток первого результата освобождён — да
ID после повторного execute с порогом 3 — 3
Скопированное имя после освобождения — Кабель
Подготовленный запрос освобождён в конце — да
Соединение после free_query видит товаров — 3
Повторных вызовов на освобождённом результате — 0

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