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

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

    $config=s150Config();$db=s150Connect($config);$runtime=s150Runtime($db,$config);

    $name=s150OwnTable($db,$owned,'fields','(id int NOT NULL PRIMARY KEY, title nvarchar(40) NOT NULL, qty int NOT NULL, note nvarchar(40) NULL, active bit NOT NULL)');
    $q=s150Qualified($name);
    s150Command($db,"INSERT INTO $q (id,title,qty,note,active) VALUES (1,N'Крепёж',0,NULL,1),(2,N'Архивный товар',9,N'Архив',0),(3,N'Кабель',7,N'Полка 2',1)");
    $stmt=s150Query($db,"SELECT title,qty,note FROM $q WHERE active = ? ORDER BY id",[1]);
    try {
        $hasRows=sqlsrv_has_rows($stmt);
        if ($hasRows===false && sqlsrv_errors(SQLSRV_ERR_ERRORS)!==null) {s150Failure('Наличие строк каталога');}
        $fields=sqlsrv_num_fields($stmt);
        if ($fields===false) {s150Failure('Количество полей каталога');}
        $items=[];
        while (true) {
            $state=sqlsrv_fetch($stmt);
            if ($state===null) {break;}
            if ($state===false) {s150Failure('Чтение строки каталога');}
            // Read columns in increasing index order; SQL NULL is a valid field.
            $title=sqlsrv_get_field($stmt,0);
            if ($title===false) {s150Failure('Название');}
            $qty=sqlsrv_get_field($stmt,1);
            if ($qty===false) {s150Failure('Количество');}
            $note=sqlsrv_get_field($stmt,2);
            if ($note===false) {s150Failure('Примечание');}
            $items[]=['title'=>$title,'qty'=>$qty,'note'=>$note];
        }
    } finally {sqlsrv_free_stmt($stmt);}
    $empty=s150Query($db,"SELECT title,qty,note FROM $q WHERE id = ?",[999]);
    try {
        $emptyHasRows=sqlsrv_has_rows($empty);
        $emptyErrors=$emptyHasRows===false ? sqlsrv_errors(SQLSRV_ERR_ERRORS) : null;
        $emptyFields=sqlsrv_num_fields($empty);
        $emptyFetch=sqlsrv_fetch($empty);
    } finally {sqlsrv_free_stmt($empty);}
    $summary=implode(' | ',array_map(fn($item)=>$item['title'].':'.$item['qty'],$items));
    $rows=[['Каталог на экране',$summary],['Наличие строк до чтения',$hasRows],['Столбцов результата',$fields],
        ['Первый товар не пропущен',$items[0]['title']==='Крепёж'],['NULL примечания сохранён',$items[0]['note']===null],
        ['Пустой поиск без ошибки',$emptyHasRows===false&&$emptyErrors===null&&$emptyFetch===null],['Столбцов пустого поиска',$emptyFields]];
    $checks=['ordered_filtered_rows'=>$summary==='Крепёж:0 | Кабель:7','has_rows_before_fetch'=>$hasRows===true,
        'field_count'=>$fields===3,'first_row_preserved'=>$items[0]['title']==='Крепёж','zero_is_value'=>$items[0]['qty']===0,
        'sql_null_is_value'=>$items[0]['note']===null,'clean_end'=>$state===null,
        'empty_not_error'=>$emptyHasRows===false&&$emptyErrors===null&&$emptyFetch===null,'empty_keeps_columns'=>$emptyFields===3];
    $observations=['selected_items'=>$items,'empty_errors'=>$emptyErrors,'fetch_end'=>$state];

} finally {
    if (is_resource($db)) {try {$removed=s150Cleanup($db,$owned);} finally {sqlsrv_close($db);}}
}

s150Report('sqlsrv150-forward-fields','Прочитать каталог по полям и сохранить первую строку',$rows,$checks,$observations,$runtime,$owned,$removed);

Каталог на экране — Крепёж:0 | Кабель:7
Наличие строк до чтения — да
Столбцов результата — 3
Первый товар не пропущен — да
NULL примечания сохранён — да
Пустой поиск без ошибки — да
Столбцов пустого поиска — 3

Самостоятельная локальная программа: создаёт одну собственную таблицу SQL Server, выполняет сценарий, сохраняет result.html/result.json/metrics.json и удаляет свою таблицу. Настройка подключения описана в README.txt.

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

    $config=s150Config();$db=s150Connect($config);$runtime=s150Runtime($db,$config);

    class InvoiceView150 {
        public $invoiceId;
        public $title;
        public $quantity;
        public $ctorSawId;
        public $caption;
        public function __construct(string $prefix) {
            $this->ctorSawId=$this->invoiceId;
            $this->caption=$prefix.' #'.$this->invoiceId.': '.$this->title.' × '.$this->quantity;
        }
    }
    $name=s150OwnTable($db,$owned,'objects','(id int NOT NULL PRIMARY KEY, title nvarchar(40) NOT NULL, qty int NOT NULL)');
    $q=s150Qualified($name);
    s150Command($db,"INSERT INTO $q (id,title,qty) VALUES (7,N'Кабель',3)");
    $sql="SELECT id AS invoiceId,title,qty AS quantity FROM $q WHERE id = ?";
    $plain=s150Query($db,$sql,[7]);
    try {
        $item=sqlsrv_fetch_object($plain);
        if ($item===false) {s150Failure('Объект накладной');}
        if ($item===null) {throw new RuntimeException('Учебная накладная не найдена.');}
        $plainEnd=sqlsrv_fetch_object($plain);
        if ($plainEnd===false) {s150Failure('Завершение накладной');}
    } finally {sqlsrv_free_stmt($plain);}
    $custom=s150Query($db,$sql,[7]);
    try {
        $view=sqlsrv_fetch_object($custom,InvoiceView150::class,['Накладная']);
        if ($view===false) {s150Failure('Модель представления');}
        if (!$view instanceof InvoiceView150) {throw new RuntimeException('Ожидался объект представления.');}
    } finally {sqlsrv_free_stmt($custom);}
    $rows=[['Класс простого результата',get_class($item)],['Псевдоним invoiceId',$item->invoiceId],['Количество',$item->quantity],
        ['Подпись модели',$view->caption],['ID, видимый конструктору',$view->ctorSawId],['Конец после единственной строки',$plainEnd===null]];
    $checks=['stdclass_result'=>$item instanceof stdClass,'aliased_id'=>$item->invoiceId===7,
        'quantity_value'=>$item->quantity===3,'declared_view'=>$view instanceof InvoiceView150,
        'hydrated_before_constructor'=>$view->ctorSawId===7,'caption_value'=>$view->caption==='Накладная #7: Кабель × 3',
        'clean_object_end'=>$plainEnd===null,'declared_fields'=>get_object_vars($item)===['invoiceId'=>7,'title'=>'Кабель','quantity'=>3]];
    $observations=['plain'=>get_object_vars($item),'custom'=>get_object_vars($view),'constructor_args'=>['Накладная']];

} finally {
    if (is_resource($db)) {try {$removed=s150Cleanup($db,$owned);} finally {sqlsrv_close($db);}}
}

s150Report('sqlsrv150-object-row','Получить объект накладной с понятными именами свойств',$rows,$checks,$observations,$runtime,$owned,$removed);

Класс простого результата — stdClass
Псевдоним invoiceId — 7
Количество — 3
Подпись модели — Накладная #7: Кабель × 3
ID, видимый конструктору — 7
Конец после единственной строки — да

Самостоятельная локальная программа: создаёт одну собственную таблицу SQL Server, выполняет сценарий, сохраняет result.html/result.json/metrics.json и удаляет свою таблицу. Настройка подключения описана в README.txt.

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

    $config=s150Config();$db=s150Connect($config);$runtime=s150Runtime($db,$config);

    $name=s150OwnTable($db,$owned,'cursor','(id int NOT NULL PRIMARY KEY, sku nvarchar(20) NOT NULL)');
    $q=s150Qualified($name);
    s150Command($db,"INSERT INTO $q (id,sku) VALUES (10,N'SKU-A'),(20,N'SKU-B'),(30,N'SKU-C')");
    $sql="SELECT TOP (3) sku FROM $q ORDER BY id";
    $forward=s150Query($db,$sql);
    try {
        $forwardCount=sqlsrv_num_rows($forward);
        $forwardErrors=$forwardCount===false ? sqlsrv_errors(SQLSRV_ERR_ERRORS) : null;
        $forwardRows=s150Rows($forward);
    } finally {sqlsrv_free_stmt($forward);}
    $stmt=s150Query($db,$sql,[],['Scrollable'=>SQLSRV_CURSOR_STATIC]);
    try {
        $count=sqlsrv_num_rows($stmt);
        if ($count===false) {s150Failure('Счётчик STATIC');}
        $moves=[['FIRST',SQLSRV_SCROLL_FIRST,0],['LAST',SQLSRV_SCROLL_LAST,0],
            ['PRIOR',SQLSRV_SCROLL_PRIOR,0],['RELATIVE(-1)',SQLSRV_SCROLL_RELATIVE,-1],['ABSOLUTE(1)',SQLSRV_SCROLL_ABSOLUTE,1]];
        $positions=[];
        foreach ($moves as [$label,$direction,$offset]) {
            $state=sqlsrv_fetch($stmt,$direction,$offset);
            if ($state===false) {s150Failure('Переход '.$label);}
            if ($state===null) {throw new RuntimeException('В учебном списке ожидается строка '.$label);}
            $sku=sqlsrv_get_field($stmt,0,SQLSRV_PHPTYPE_STRING('UTF-8'));
            if ($sku===false) {s150Failure('Чтение SKU');}
            $positions[$label]=$sku;
        }
        $outside=sqlsrv_fetch($stmt,SQLSRV_SCROLL_ABSOLUTE,9);
        if ($outside===false) {s150Failure('Позиция за границей результата');}
    } finally {sqlsrv_free_stmt($stmt);}
    $parts=[];foreach ($positions as $label=>$sku) {$parts[]=$label.'='.$sku;}
    $summary=implode(' | ',$parts);
    $rows=[['FORWARD: счётчик недоступен',$forwardCount===false],['FORWARD: прочитанные товары',implode(', ',array_column($forwardRows,'sku'))],
        ['STATIC: число строк',$count],['Переходы по результату',$summary],['Позиция 9 отсутствует',$outside===null]];
    $checks=['forward_count_unsupported'=>$forwardCount===false,'forward_diagnostic'=>is_array($forwardErrors)&&count($forwardErrors)>0,
        'forward_still_readable'=>array_column($forwardRows,'sku')===['SKU-A','SKU-B','SKU-C'],'static_count'=>$count===3,
        'position_contract'=>$positions===['FIRST'=>'SKU-A','LAST'=>'SKU-C','PRIOR'=>'SKU-B','RELATIVE(-1)'=>'SKU-A','ABSOLUTE(1)'=>'SKU-B'],
        'outside_is_null'=>$outside===null];
    $observations=['forward_count'=>$forwardCount,'forward_errors'=>s150Diagnostics($forwardErrors),'positions'=>$positions,'outside'=>$outside];

} finally {
    if (is_resource($db)) {try {$removed=s150Cleanup($db,$owned);} finally {sqlsrv_close($db);}}
}

s150Report('sqlsrv150-static-cursor','Посчитать короткий список и перейти к выбранной позиции',$rows,$checks,$observations,$runtime,$owned,$removed);

FORWARD: счётчик недоступен — да
FORWARD: прочитанные товары — SKU-A, SKU-B, SKU-C
STATIC: число строк — 3
Переходы по результату — FIRST=SKU-A | LAST=SKU-C | PRIOR=SKU-B | RELATIVE(-1)=SKU-A | ABSOLUTE(1)=SKU-B
Позиция 9 отсутствует — да

Самостоятельная локальная программа: создаёт одну собственную таблицу SQL Server, выполняет сценарий, сохраняет result.html/result.json/metrics.json и удаляет свою таблицу. Настройка подключения описана в README.txt.

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

    $config=s150Config();$db=s150Connect($config);$runtime=s150Runtime($db,$config);

    $name=s150OwnTable($db,$owned,'batch','(id int NOT NULL PRIMARY KEY, qty int NOT NULL)');
    $q=s150Qualified($name);
    s150Command($db,"INSERT INTO $q (id,qty) VALUES (1,2)");
    $originalNoCount=(s150Read($db,'SELECT CASE WHEN (@@OPTIONS & 512) = 512 THEN 1 ELSE 0 END AS enabled')[0]['enabled']===1);
    try {
        s150Command($db,'SET NOCOUNT OFF');
        $stmt=s150Query($db,"UPDATE $q SET qty = qty + 3 WHERE id = 1; SELECT id,qty FROM $q WHERE id = 999; SELECT id,qty FROM $q WHERE id = 1;");
        try {
            $results=[];$transitions=[];
            while (true) {
                // The first result is already active: do not advance before processing.
                $fields=sqlsrv_num_fields($stmt);
                if ($fields===false) {s150Failure('Описание результата batch');}
                if ($fields===0) {
                    $affected=sqlsrv_rows_affected($stmt);
                    if ($affected===false) {s150Failure('Счётчик batch');}
                    $results[]=['fields'=>0,'affected'=>$affected,'rows'=>[]];
                } else {
                    $hasRows=sqlsrv_has_rows($stmt);
                    $errors=$hasRows===false ? sqlsrv_errors(SQLSRV_ERR_ERRORS) : null;
                    if ($errors!==null) {throw new RuntimeException('Ошибка проверки набора batch.');}
                    $results[]=['fields'=>$fields,'has_rows'=>$hasRows,'rows'=>s150Rows($stmt)];
                }
                $next=sqlsrv_next_result($stmt);
                if ($next===false) {s150Failure('Следующий результат batch');}
                $transitions[]=$next;
                if ($next===null) {break;}
            }
        } finally {sqlsrv_free_stmt($stmt);}
        // NOCOUNT removes the UPDATE count result, not its work or SELECT rows.
        s150Command($db,'SET NOCOUNT ON');
        $quiet=s150Query($db,"UPDATE $q SET qty = 5 WHERE id = 1; SELECT id,qty FROM $q WHERE id = 1;");
        try {
            $quietFields=sqlsrv_num_fields($quiet);
            if ($quietFields===false) {s150Failure('NOCOUNT: поля');}
            $quietRows=s150Rows($quiet);
            $quietEnd=sqlsrv_next_result($quiet);
            if ($quietEnd===false) {s150Failure('NOCOUNT: завершение');}
        } finally {sqlsrv_free_stmt($quiet);}
        $failing=s150Query($db,"SELECT qty FROM $q WHERE id = 1; RAISERROR(N'Controlled lesson error after SELECT',16,1);");
        try {
            $beforeError=s150Rows($failing);
            $failedNext=sqlsrv_next_result($failing);
            $lateErrors=$failedNext===false ? sqlsrv_errors(SQLSRV_ERR_ERRORS) : null;
        } finally {sqlsrv_free_stmt($failing);}
    } finally {s150Command($db,$originalNoCount?'SET NOCOUNT ON':'SET NOCOUNT OFF');}
    $restored=(s150Read($db,'SELECT CASE WHEN (@@OPTIONS & 512) = 512 THEN 1 ELSE 0 END AS enabled')[0]['enabled']===1)===$originalNoCount;
    $errorCodes=is_array($lateErrors)?array_column($lateErrors,'code'):[];
    $rows=[['Последовательность столбцов batch',implode(', ',array_column($results,'fields'))],['UPDATE затронул строк',$results[0]['affected']],
        ['Строк в промежуточном SELECT',count($results[1]['rows'])],['Количество в квитанции',$results[2]['rows'][0]['qty']],
        ['NOCOUNT: сразу набор с двумя полями',$quietFields===2&&$quietRows===[['id'=>1,'qty'=>5]]&&$quietEnd===null],
        ['До отложенной ошибки прочитано',$beforeError[0]['qty']],['Ошибка следующего результата обнаружена',$failedNext===false&&in_array(50000,$errorCodes,true)],['Настройка NOCOUNT восстановлена',$restored]];
    $checks=['three_result_kinds'=>array_column($results,'fields')===[0,2,2],'update_count'=>$results[0]['affected']===1,
        'empty_set_preserved'=>$results[1]['has_rows']===false&&$results[1]['rows']===[],
        'receipt_value'=>$results[2]['rows']===[['id'=>1,'qty'=>5]],'strict_transitions'=>$transitions===[true,true,null],
        'nocount_keeps_receipt'=>$quietFields===2&&$quietRows===[['id'=>1,'qty'=>5]]&&$quietEnd===null,
        'first_select_not_whole_success'=>$beforeError===[['qty'=>5]]&&$failedNext===false,
        'late_error_saved'=>in_array(50000,$errorCodes,true),'setting_restored'=>$restored];
    $observations=['results'=>$results,'transitions'=>$transitions,'nocount_rows'=>$quietRows,'before_error'=>$beforeError,'late_errors'=>s150Diagnostics($lateErrors)];

} finally {
    if (is_resource($db)) {try {$removed=s150Cleanup($db,$owned);} finally {sqlsrv_close($db);}}
}

s150Report('sqlsrv150-batch-results','Прочитать квитанцию batch и заметить ошибку после первого SELECT',$rows,$checks,$observations,$runtime,$owned,$removed);

Последовательность столбцов batch — 0, 2, 2
UPDATE затронул строк — 1
Строк в промежуточном SELECT — 0
Количество в квитанции — 5
NOCOUNT: сразу набор с двумя полями — да
До отложенной ошибки прочитано — 5
Ошибка следующего результата обнаружена — да
Настройка NOCOUNT восстановлена — да

Самостоятельная локальная программа: создаёт одну собственную таблицу SQL Server, выполняет сценарий, сохраняет result.html/result.json/metrics.json и удаляет свою таблицу. Настройка подключения описана в README.txt.