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

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

    function prepare156($db,string $sql) {
        $call=f156Capture(static fn()=>ibase_prepare($db,$sql));
        if (!is_resource($call['value']) || $call['warning']) {f156Failure('Команда не подготовлена',$call);}
        return $call['value'];
    }
    function parameterCount156($query): int {
        $call=f156Capture(static fn()=>ibase_num_params($query));
        if (!is_int($call['value']) || $call['warning']) {f156Failure('Число параметров не получено',$call);}
        return $call['value'];
    }
    function execute156($query,array $values) {
        // Native ibase parameters are positional: a numeric list, not named PHP arguments.
        if (!array_is_list($values)) {throw new InvalidArgumentException('Нужен упорядоченный список значений.');}
        $needed=parameterCount156($query);
        if (count($values)!==$needed) {
            throw new DomainException('Ожидалось '.$needed.' значения, получено '.count($values));
        }
        $call=f156Capture(static fn()=>ibase_execute($query,...$values));
        if ($call['value']===false || $call['warning']) {f156Failure('Подготовленная команда не выполнена',$call);}
        return $call['value'];
    }
    function readPrepared156($query,array $values): array {
        $result=execute156($query,$values);
        if (!is_resource($result)) {throw new RuntimeException('Ожидался результат SELECT.');}
        try {return f156Rows($result);}
        finally {
            $call=f156Capture(static fn()=>ibase_free_result($result));$result=null;
            if ($call['value']!==true || $call['warning']) {f156Failure('Результат не освобождён',$call);}
        }
    }
    function releaseQuery156(&$query): bool {
        $call=f156Capture(static fn()=>ibase_free_query($query));
        if ($call['value']!==true || $call['warning']) {f156Failure('Подготовленная команда не освобождена',$call);}
        $query=null;
        return true;
    }

    $name=f156OwnTable($db,$owned,'count','(item_id INTEGER NOT NULL PRIMARY KEY,title VARCHAR(40) CHARACTER SET UTF8 NOT NULL,qty INTEGER NOT NULL CHECK(qty>=0),marker VARCHAR(1))');
    $q=f156Qualified($name);

    $sql="INSERT INTO $q(item_id,title,qty,marker) VALUES(?,?,?,'?')";
    $query=prepare156($db,$sql);
    try {
        $needed=parameterCount156($query);
        $rejected='';
        try {execute156($query,[101,'Кабель']);}
        catch (DomainException $error) {$rejected=$error->getMessage();}
        $before=f156Read($db,"SELECT COUNT(*) AS \"n\" FROM $q")[0]['n'];
        execute156($query,[101,'Кабель',3]);
    } finally {if (is_resource($query)) {releaseQuery156($query);}}
    f156Commit($db);
    $saved=f156Read($db,"SELECT item_id AS \"id\",title AS \"title\",qty AS \"qty\",marker AS \"marker\" FROM $q WHERE item_id=?",[101])[0];
    $rows=[['Параметров у команды',$needed],['Знаков ? в тексте SQL',substr_count($sql,'?')],
        ['Отказ проверки списка',$rejected],['Строк после отклонения',(int)$before],
        ['Сохранённый товар',$saved['title']],['Количество',$saved['qty']],['Литерал marker',$saved['marker']]];
    $checks=['three_parameters'=>$needed===3,'literal_not_parameter'=>substr_count($sql,'?')===4,
        'missing_value_rejected'=>$rejected==='Ожидалось 3 значения, получено 2','no_partial_insert'=>(int)$before===0,
        'correct_row_saved'=>$saved===['id'=>101,'title'=>'Кабель','qty'=>3,'marker'=>'?'],'query_released'=>$query===null];
    $observations=['sql_shape'=>"INSERT INTO own_table(item_id,title,qty,marker) VALUES(?,?,?,'?')",
        'valid_parameter_order'=>['item_id','title','qty'],'application_refusal_before_execute'=>true,'selected'=>$saved];

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

f156Report('fb156-parameter-count','Импорт товара: заметить пропущенное количество до INSERT',$rows,$checks,$observations,$runtime,$owned,$removed);

Параметров у команды — 3
Знаков ? в тексте SQL — 4
Отказ проверки списка — Ожидалось 3 значения, получено 2
Строк после отклонения — 0
Сохранённый товар — Кабель
Количество — 3
Литерал marker — ?

Самостоятельный CLI-пример создаёт одну свою таблицу в отдельной Firebird, выполняет настоящий prepare/execute/SELECT, создаёт result.html и result.json и удаляет таблицу. lab.php и README.txt приложены.

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

    function prepare156($db,string $sql) {
        $call=f156Capture(static fn()=>ibase_prepare($db,$sql));
        if (!is_resource($call['value']) || $call['warning']) {f156Failure('Команда не подготовлена',$call);}
        return $call['value'];
    }
    function parameterCount156($query): int {
        $call=f156Capture(static fn()=>ibase_num_params($query));
        if (!is_int($call['value']) || $call['warning']) {f156Failure('Число параметров не получено',$call);}
        return $call['value'];
    }
    function execute156($query,array $values) {
        // Native ibase parameters are positional: a numeric list, not named PHP arguments.
        if (!array_is_list($values)) {throw new InvalidArgumentException('Нужен упорядоченный список значений.');}
        $needed=parameterCount156($query);
        if (count($values)!==$needed) {
            throw new DomainException('Ожидалось '.$needed.' значения, получено '.count($values));
        }
        $call=f156Capture(static fn()=>ibase_execute($query,...$values));
        if ($call['value']===false || $call['warning']) {f156Failure('Подготовленная команда не выполнена',$call);}
        return $call['value'];
    }
    function readPrepared156($query,array $values): array {
        $result=execute156($query,$values);
        if (!is_resource($result)) {throw new RuntimeException('Ожидался результат SELECT.');}
        try {return f156Rows($result);}
        finally {
            $call=f156Capture(static fn()=>ibase_free_result($result));$result=null;
            if ($call['value']!==true || $call['warning']) {f156Failure('Результат не освобождён',$call);}
        }
    }
    function releaseQuery156(&$query): bool {
        $call=f156Capture(static fn()=>ibase_free_query($query));
        if ($call['value']!==true || $call['warning']) {f156Failure('Подготовленная команда не освобождена',$call);}
        $query=null;
        return true;
    }

    $name=f156OwnTable($db,$owned,'metadata','(CODE INTEGER NOT NULL PRIMARY KEY,TITLE VARCHAR(20) CHARACTER SET UTF8 NOT NULL,PRICE DECIMAL(10,2) NOT NULL CHECK(PRICE>=0))');
    $q=f156Qualified($name);

    $query=prepare156($db,"INSERT INTO $q(CODE,TITLE,PRICE) VALUES(?,?,?)");
    $metadata=[];
    try {
        $count=parameterCount156($query);
        for ($index=0;$index<$count;$index++) {
            $call=f156Capture(static fn()=>ibase_param_info($query,$index));
            if (!is_array($call['value']) || $call['warning']) {f156Failure('Описание параметра не получено',$call);}
            $info=$call['value'];
            $metadata[]=['position'=>$index,'name'=>$info['name'],'alias'=>$info['alias'],'relation'=>$info['relation'],
                'length'=>$info['length'],'type'=>$info['type']];
        }
        $outside=f156Capture(static fn()=>ibase_param_info($query,3));
        $code=7;$title='Кабель USB';$price='19.90';
        // An INTEGER descriptor does not express our business rule: product code must be positive.
        if ($code<=0) {throw new DomainException('Код товара должен быть положительным.');}
        execute156($query,[$code,$title,$price]);
    } finally {if (is_resource($query)) {releaseQuery156($query);}}
    f156Commit($db);
    $saved=f156Read($db,"SELECT CODE AS \"code\",TITLE AS \"title\",PRICE AS \"price\" FROM $q WHERE CODE=?",[7])[0];
    $labels=[];
    foreach ($metadata as $item) {$labels[]=$item['type'].'; length='.$item['length'];}
    $namesEmpty=true;
    foreach ($metadata as $item) {
        $namesEmpty=$namesEmpty && $item['name']==='' && $item['alias']==='' && $item['relation']==='';
    }
    $rows=[['Параметр 0: CODE',$labels[0]],['Параметр 1: TITLE',$labels[1]],['Параметр 2: PRICE',$labels[2]],
        ['name / alias / relation пусты',$namesEmpty],['Индекс 3 вернул false',$outside['value']===false],
        ['Сохранённое название',$saved['title']],['Цена после чтения',$saved['price']]];
    $checks=['three_input_descriptors'=>$count===3 && count($metadata)===3,
        'expected_types'=>array_column($metadata,'type')===['INTEGER','VARCHAR','NUMERIC(18,2)'],
        'lengths_are_byte_strings'=>array_column($metadata,'length')===['4','80','8'],
        'names_not_guessed'=>$namesEmpty,'outside_index_refused'=>$outside['value']===false && !$outside['warning'],
        'decimal_preserved'=>$saved===['code'=>7,'title'=>'Кабель USB','price'=>'19.90'],'query_released'=>$query===null];
    $observations=['input_metadata'=>$metadata,'declared_columns'=>['CODE INTEGER','TITLE VARCHAR(20) CHARACTER SET UTF8','PRICE DECIMAL(10,2) CHECK(PRICE>=0)'],
        'explicit_form_labels'=>['Код товара','Название товара','Цена'],'saved'=>$saved,'out_of_range_warning'=>$outside['warning']];

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

f156Report('fb156-parameter-metadata','Диагностика импорта: увидеть входные типы, байты и предел метаданных',$rows,$checks,$observations,$runtime,$owned,$removed);

Параметр 0: CODE — INTEGER; length=4
Параметр 1: TITLE — VARCHAR; length=80
Параметр 2: PRICE — NUMERIC(18,2); length=8
name / alias / relation пусты — да
Индекс 3 вернул false — да
Сохранённое название — Кабель USB
Цена после чтения — 19.90

Самостоятельный CLI-пример создаёт одну свою таблицу в отдельной Firebird, выполняет настоящий prepare/execute/SELECT, создаёт result.html и result.json и удаляет таблицу. lab.php и README.txt приложены.

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

    function prepare156($db,string $sql) {
        $call=f156Capture(static fn()=>ibase_prepare($db,$sql));
        if (!is_resource($call['value']) || $call['warning']) {f156Failure('Команда не подготовлена',$call);}
        return $call['value'];
    }
    function parameterCount156($query): int {
        $call=f156Capture(static fn()=>ibase_num_params($query));
        if (!is_int($call['value']) || $call['warning']) {f156Failure('Число параметров не получено',$call);}
        return $call['value'];
    }
    function execute156($query,array $values) {
        // Native ibase parameters are positional: a numeric list, not named PHP arguments.
        if (!array_is_list($values)) {throw new InvalidArgumentException('Нужен упорядоченный список значений.');}
        $needed=parameterCount156($query);
        if (count($values)!==$needed) {
            throw new DomainException('Ожидалось '.$needed.' значения, получено '.count($values));
        }
        $call=f156Capture(static fn()=>ibase_execute($query,...$values));
        if ($call['value']===false || $call['warning']) {f156Failure('Подготовленная команда не выполнена',$call);}
        return $call['value'];
    }
    function readPrepared156($query,array $values): array {
        $result=execute156($query,$values);
        if (!is_resource($result)) {throw new RuntimeException('Ожидался результат SELECT.');}
        try {return f156Rows($result);}
        finally {
            $call=f156Capture(static fn()=>ibase_free_result($result));$result=null;
            if ($call['value']!==true || $call['warning']) {f156Failure('Результат не освобождён',$call);}
        }
    }
    function releaseQuery156(&$query): bool {
        $call=f156Capture(static fn()=>ibase_free_query($query));
        if ($call['value']!==true || $call['warning']) {f156Failure('Подготовленная команда не освобождена',$call);}
        $query=null;
        return true;
    }

    $name=f156OwnTable($db,$owned,'filters','(item_id INTEGER NOT NULL PRIMARY KEY,title VARCHAR(40) CHARACTER SET UTF8 NOT NULL,price_kopecks INTEGER NOT NULL,stock INTEGER NOT NULL)');
    $q=f156Qualified($name);
    foreach ([[1,'Зажим',500,10],[2,'Кабель',1200,8],[3,'Переходник',2500,0],[4,'Держатель',3000,5],[5,'Зарядка',6000,3]] as $item) {
        f156Command($db,"INSERT INTO $q(item_id,title,price_kopecks,stock) VALUES(?,?,?,?)",$item);
    }
    f156Commit($db);

    $query=prepare156($db,"SELECT item_id AS \"id\",title AS \"title\",price_kopecks AS \"price\" FROM $q WHERE price_kopecks>=? AND price_kopecks<=? AND stock>0 ORDER BY price_kopecks,item_id ROWS 10");
    $form=['max_kopecks'=>3000,'min_kopecks'=>1000];
    try {
        // Deliberate mistake for comparison: array insertion order is not SQL meaning.
        $wrong=array_values($form);
        $empty=readPrepared156($query,$wrong);
        $minimum=$form['min_kopecks'];$maximum=$form['max_kopecks'];
        if ($minimum>$maximum) {throw new DomainException('Минимальная цена больше максимальной.');}
        $correct=[$minimum,$maximum];
        $items=readPrepared156($query,$correct);
        $needed=parameterCount156($query);
    } finally {if (is_resource($query)) {releaseQuery156($query);}}
    $rows=[['Параметров у SELECT',$needed],['Перепутанные границы',implode(' → ',$wrong)],
        ['Строк при неверном порядке',count($empty)],['Границы после сопоставления',implode(' → ',$correct)],
        ['Коды показанных товаров',implode(', ',array_column($items,'id'))],['Товары',implode(' / ',array_column($items,'title'))],
        ['Цены в копейках',implode(', ',array_column($items,'price'))]];
    $checks=['two_parameters'=>$needed===2,'same_count_different_order'=>count($wrong)===$needed && $wrong!==$correct,
        'wrong_order_returns_empty'=>$empty===[],'explicit_mapping'=>array_column($items,'id')===[2,4],
        'price_order_in_sql'=>array_column($items,'price')===[1200,3000],'out_of_stock_excluded'=>!in_array(3,array_column($items,'id'),true),
        'query_released'=>$query===null];
    $observations=['form'=>$form,'wrong_parameters'=>$wrong,'correct_parameters'=>$correct,'selected'=>$items,
        'sql_filters'=>['price_kopecks >= minimum','price_kopecks <= maximum','stock > 0'],'sql_order'=>'price_kopecks, item_id','sql_limit'=>10];

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

f156Report('fb156-filter-order','Фильтр каталога: правильное количество ещё не означает правильный порядок',$rows,$checks,$observations,$runtime,$owned,$removed);

Параметров у SELECT — 2
Перепутанные границы — 3000 → 1000
Строк при неверном порядке — 0
Границы после сопоставления — 1000 → 3000
Коды показанных товаров — 2, 4
Товары — Кабель / Держатель
Цены в копейках — 1200, 3000

Самостоятельный CLI-пример создаёт одну свою таблицу в отдельной Firebird, выполняет настоящий prepare/execute/SELECT, создаёт result.html и result.json и удаляет таблицу. lab.php и README.txt приложены.

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

    function prepare156($db,string $sql) {
        $call=f156Capture(static fn()=>ibase_prepare($db,$sql));
        if (!is_resource($call['value']) || $call['warning']) {f156Failure('Команда не подготовлена',$call);}
        return $call['value'];
    }
    function parameterCount156($query): int {
        $call=f156Capture(static fn()=>ibase_num_params($query));
        if (!is_int($call['value']) || $call['warning']) {f156Failure('Число параметров не получено',$call);}
        return $call['value'];
    }
    function execute156($query,array $values) {
        // Native ibase parameters are positional: a numeric list, not named PHP arguments.
        if (!array_is_list($values)) {throw new InvalidArgumentException('Нужен упорядоченный список значений.');}
        $needed=parameterCount156($query);
        if (count($values)!==$needed) {
            throw new DomainException('Ожидалось '.$needed.' значения, получено '.count($values));
        }
        $call=f156Capture(static fn()=>ibase_execute($query,...$values));
        if ($call['value']===false || $call['warning']) {f156Failure('Подготовленная команда не выполнена',$call);}
        return $call['value'];
    }
    function readPrepared156($query,array $values): array {
        $result=execute156($query,$values);
        if (!is_resource($result)) {throw new RuntimeException('Ожидался результат SELECT.');}
        try {return f156Rows($result);}
        finally {
            $call=f156Capture(static fn()=>ibase_free_result($result));$result=null;
            if ($call['value']!==true || $call['warning']) {f156Failure('Результат не освобождён',$call);}
        }
    }
    function releaseQuery156(&$query): bool {
        $call=f156Capture(static fn()=>ibase_free_query($query));
        if ($call['value']!==true || $call['warning']) {f156Failure('Подготовленная команда не освобождена',$call);}
        $query=null;
        return true;
    }

    $name=f156OwnTable($db,$owned,'release','(order_id INTEGER NOT NULL PRIMARY KEY,status VARCHAR(16) NOT NULL,total_kopecks INTEGER NOT NULL)');
    $q=f156Qualified($name);
    foreach ([[1,'new',1500],[2,'new',2400],[3,'paid',3900]] as $order) {
        f156Command($db,"INSERT INTO $q(order_id,status,total_kopecks) VALUES(?,?,?)",$order);
    }
    f156Commit($db);

    $query=prepare156($db,"SELECT order_id AS \"id\",total_kopecks AS \"total\" FROM $q WHERE status=? ORDER BY order_id ROWS 2");
    $tabs=[];$executions=0;$resultsReleased=0;
    try {
        foreach (['new','paid','cancelled'] as $status) {
            $tabs[$status]=readPrepared156($query,[$status]);
            $executions++;$resultsReleased++; // readPrepared156 returns only after successful free_result.
        }
    } finally {if (is_resource($query)) {$released=releaseQuery156($query);}}
    // A separate prepared query has no input parameters. Zero is a valid count.
    $next=prepare156($db,"SELECT order_id AS \"id\",total_kopecks AS \"total\" FROM $q WHERE order_id=3");
    try {$zero=parameterCount156($next);$saved=readPrepared156($next,[]);}
    finally {if (is_resource($next)) {releaseQuery156($next);}}
    $rows=[['Подготовок команды вкладок',1],['Выполнений команды вкладок',$executions],['Освобождено результатов вкладок',$resultsReleased],
        ['Новые заказы',implode(', ',array_column($tabs['new'],'id'))],['Оплаченные заказы',implode(', ',array_column($tabs['paid'],'id'))],
        ['Отменённых заказов',count($tabs['cancelled'])],['Команда освобождена',$released && $query===null],
        ['Параметров у нового SELECT',$zero],['Заказ после освобождения команды',$saved[0]['id']]];
    $checks=['one_template_three_executions'=>$executions===3,'all_results_released'=>$resultsReleased===3,
        'correct_tab_rows'=>array_column($tabs['new'],'id')===[1,2] && array_column($tabs['paid'],'id')===[3] && $tabs['cancelled']===[],
        'prepared_query_released'=>$released===true && $query===null,'zero_parameters_are_valid'=>$zero===0,
        'stored_data_still_present'=>$saved===[['id'=>3,'total'=>3900]],'second_query_released'=>$next===null];
    $observations=['tabs'=>$tabs,'template_prepares'=>1,'template_executions'=>$executions,'template_result_releases'=>$resultsReleased,
        'separate_zero_parameter_query'=>['parameters'=>$zero,'selected'=>$saved],'resource_cleanup_is_not_transaction_commit'=>true];

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

f156Report('fb156-statement-release','Три вкладки заказов: переиспользовать команду и освободить её после работы',$rows,$checks,$observations,$runtime,$owned,$removed);

Подготовок команды вкладок — 1
Выполнений команды вкладок — 3
Освобождено результатов вкладок — 3
Новые заказы — 1, 2
Оплаченные заказы — 3
Отменённых заказов — 0
Команда освобождена — да
Параметров у нового SELECT — 0
Заказ после освобождения команды — 3

Самостоятельный CLI-пример создаёт одну свою таблицу в отдельной Firebird, выполняет настоящий prepare/execute/SELECT, создаёт result.html и result.json и удаляет таблицу. lab.php и README.txt приложены.