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

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

    $config=s152Config();$db=s152Connect($config);$runtime=s152Runtime($db,$config);

    function finishContract152($stmt): array {
        $sets=[];
        for ($result=0;$result<16;$result++) {
            $fields=sqlsrv_num_fields($stmt);
            if ($fields===false) {
                $errors=sqlsrv_errors(SQLSRV_ERR_ALL);
                return ['done'=>false,'sets'=>$sets,'diagnostics'=>s152Diagnostics($errors)];
            }
            if ($fields>0) {
                $rows=[];
                while (true) {
                    $row=sqlsrv_fetch_array($stmt,SQLSRV_FETCH_ASSOC);
                    if ($row===null) {break;}
                    if ($row===false) {
                        $errors=sqlsrv_errors(SQLSRV_ERR_ALL);
                        return ['done'=>false,'sets'=>$sets,'diagnostics'=>s152Diagnostics($errors)];
                    }
                    $rows[]=$row;
                }
                $sets[]=$rows;
            }
            $next=sqlsrv_next_result($stmt);
            if ($next===false) {
                $errors=sqlsrv_errors(SQLSRV_ERR_ALL);
                return ['done'=>false,'sets'=>$sets,'diagnostics'=>s152Diagnostics($errors)];
            }
            if ($next===null) {return ['done'=>true,'sets'=>$sets,'diagnostics'=>[]];}
        }
        throw new RuntimeException('Учебная процедура неожиданно вернула больше 16 результатов.');
    }

    $name=s152OwnTable($db,$owned,'invoice','(invoice_id int NOT NULL,line_no int NOT NULL,qty int NOT NULL,unit_kopecks int NOT NULL,PRIMARY KEY(invoice_id,line_no))');
    $q=s152Qualified($name);
    s152Command($db,"INSERT INTO $q(invoice_id,line_no,qty,unit_kopecks) VALUES(71,1,1,10000),(71,2,2,2700),(71,3,1,2500),(72,1,9,900)");
    $procName=s152OwnProcedure($db,$owned,'invoice_total',"@invoiceId int,@total int OUTPUT AS BEGIN SET NOCOUNT ON;
        SELECT line_no,qty,unit_kopecks,qty*unit_kopecks AS line_total FROM $q WHERE invoice_id=@invoiceId ORDER BY line_no;
        SELECT @total=COALESCE(SUM(qty*unit_kopecks),0) FROM $q WHERE invoice_id=@invoiceId; END");
    $proc=s152Qualified($procName);$invoiceId=71;$total=0;
    $params=[[$invoiceId,SQLSRV_PARAM_IN,SQLSRV_PHPTYPE_INT,SQLSRV_SQLTYPE_INT],
        [&$total,SQLSRV_PARAM_OUT,SQLSRV_PHPTYPE_INT,SQLSRV_SQLTYPE_INT]];
    $stmt=s152Query($db,"{CALL $proc(?,?)}",$params);
    try {$result=finishContract152($stmt);} finally {sqlsrv_free_stmt($stmt);}
    if (!$result['done']) {throw new RuntimeException('Не все результаты счёта прочитаны.');}
    $lines=$result['sets'][0]??[];
    $amount=intdiv($total,100).'.'.str_pad((string)($total%100),2,'0',STR_PAD_LEFT);
    $rows=[['Счёт',$invoiceId],['Получено строк',count($lines)],['Номера строк',implode(', ',array_column($lines,'line_no'))],['Итог, копеек',$total],['К оплате, рублей',$amount],['PHP-тип итога',get_debug_type($total)]];
    $checks=['all_results_finished'=>$result['done'],'three_invoice_lines'=>count($lines)===3,
        'correct_line_order'=>array_column($lines,'line_no')===[1,2,3],
        'line_totals'=>array_column($lines,'line_total')===[10000,5400,2500],
        'one_result_set'=>count($result['sets'])===1,'output_exact'=>$total===17900,'visible_amount'=>$amount==='179.00'];
    $observations=['invoice_lines'=>$lines,'output_total'=>$total,'completion'=>$result];

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

s152Report('sqlsrv152-param-output','Получить строки счёта и его итог через OUT',$rows,$checks,$observations,$runtime,$owned,$removed);

Счёт — 71
Получено строк — 3
Номера строк — 1, 2, 3
Итог, копеек — 17900
К оплате, рублей — 179.00
PHP-тип итога — int

Самостоятельная программа включает lab.php и README.txt. Она создаёт свою небольшую таблицу и процедуру SQL Server, вызывает процедуру с параметрами, сохраняет result.html/result.json/metrics.json и удаляет только собственные учебные объекты. Процедура создаётся одним SQL-вызовом без GO: GO — команда внешнего клиента, а не часть отправляемого T-SQL.

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

    $config=s152Config();$db=s152Connect($config);$runtime=s152Runtime($db,$config);

    function finishContract152($stmt): array {
        $sets=[];
        for ($result=0;$result<16;$result++) {
            $fields=sqlsrv_num_fields($stmt);
            if ($fields===false) {
                $errors=sqlsrv_errors(SQLSRV_ERR_ALL);
                return ['done'=>false,'sets'=>$sets,'diagnostics'=>s152Diagnostics($errors)];
            }
            if ($fields>0) {
                $rows=[];
                while (true) {
                    $row=sqlsrv_fetch_array($stmt,SQLSRV_FETCH_ASSOC);
                    if ($row===null) {break;}
                    if ($row===false) {
                        $errors=sqlsrv_errors(SQLSRV_ERR_ALL);
                        return ['done'=>false,'sets'=>$sets,'diagnostics'=>s152Diagnostics($errors)];
                    }
                    $rows[]=$row;
                }
                $sets[]=$rows;
            }
            $next=sqlsrv_next_result($stmt);
            if ($next===false) {
                $errors=sqlsrv_errors(SQLSRV_ERR_ALL);
                return ['done'=>false,'sets'=>$sets,'diagnostics'=>s152Diagnostics($errors)];
            }
            if ($next===null) {return ['done'=>true,'sets'=>$sets,'diagnostics'=>[]];}
        }
        throw new RuntimeException('Учебная процедура неожиданно вернула больше 16 результатов.');
    }

    $name=s152OwnTable($db,$owned,'stock','(id int NOT NULL PRIMARY KEY,sku nvarchar(40) NOT NULL,qty int NOT NULL CHECK(qty>=0))');
    $q=s152Qualified($name);
    s152Command($db,"INSERT INTO $q(id,sku,qty) VALUES(1,N'Кабель-3x2.5',10)");
    $procName=s152OwnProcedure($db,$owned,'reserve',"@id int,@amount int OUTPUT AS BEGIN SET NOCOUNT ON;
        DECLARE @requested int=@amount; DECLARE @changed TABLE(qty int NOT NULL);
        UPDATE $q SET qty=qty-@requested OUTPUT inserted.qty INTO @changed(qty)
            WHERE id=@id AND @requested>0 AND qty>=@requested;
        IF @@ROWCOUNT<>1 THROW 50001,N'Недостаточно остатка или неверный запрос',1;
        SELECT @amount=qty FROM @changed;
        SELECT @requested AS reserved,@amount AS remaining; END");
    $proc=s152Qualified($procName);$productId=1;$amount=3;$requested=$amount;
    $params=[[$productId,SQLSRV_PARAM_IN,SQLSRV_PHPTYPE_INT,SQLSRV_SQLTYPE_INT],
        [&$amount,SQLSRV_PARAM_INOUT,SQLSRV_PHPTYPE_INT,SQLSRV_SQLTYPE_INT]];
    $stmt=s152Query($db,"{CALL $proc(?,?)}",$params);
    try {$result=finishContract152($stmt);} finally {sqlsrv_free_stmt($stmt);}
    if (!$result['done']) {throw new RuntimeException('Резерв не завершён.');}
    $saved=s152Read($db,"SELECT sku,qty FROM $q WHERE id=?",[$productId])[0];
    $rows=[['Товар',$saved['sku']],['Запрошено к резерву',$requested],['INOUT после завершения',$amount],['Остаток в таблице',$saved['qty']],['Результат процедуры','зарезервировано 3, осталось 7']];
    $checks=['all_results_finished'=>$result['done'],'input_preserved_for_receipt'=>$requested===3,
        'inout_now_remaining'=>$amount===7,'database_updated_once'=>$saved['qty']===7,
        'receipt_matches'=>$result['sets']===[[['reserved'=>3,'remaining'=>7]]]];
    $observations=['requested'=>$requested,'remaining'=>$amount,'saved'=>$saved,'results'=>$result['sets']];

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

s152Report('sqlsrv152-param-inout','Передать количество резерва и получить остаток через INOUT',$rows,$checks,$observations,$runtime,$owned,$removed);

Товар — Кабель-3x2.5
Запрошено к резерву — 3
INOUT после завершения — 7
Остаток в таблице — 7
Результат процедуры — зарезервировано 3, осталось 7

Самостоятельная программа включает lab.php и README.txt. Она создаёт свою небольшую таблицу и процедуру SQL Server, вызывает процедуру с параметрами, сохраняет result.html/result.json/metrics.json и удаляет только собственные учебные объекты. Процедура создаётся одним SQL-вызовом без GO: GO — команда внешнего клиента, а не часть отправляемого T-SQL.

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

    $config=s152Config();$db=s152Connect($config);$runtime=s152Runtime($db,$config);

    function finishContract152($stmt): array {
        $sets=[];
        for ($result=0;$result<16;$result++) {
            $fields=sqlsrv_num_fields($stmt);
            if ($fields===false) {
                $errors=sqlsrv_errors(SQLSRV_ERR_ALL);
                return ['done'=>false,'sets'=>$sets,'diagnostics'=>s152Diagnostics($errors)];
            }
            if ($fields>0) {
                $rows=[];
                while (true) {
                    $row=sqlsrv_fetch_array($stmt,SQLSRV_FETCH_ASSOC);
                    if ($row===null) {break;}
                    if ($row===false) {
                        $errors=sqlsrv_errors(SQLSRV_ERR_ALL);
                        return ['done'=>false,'sets'=>$sets,'diagnostics'=>s152Diagnostics($errors)];
                    }
                    $rows[]=$row;
                }
                $sets[]=$rows;
            }
            $next=sqlsrv_next_result($stmt);
            if ($next===false) {
                $errors=sqlsrv_errors(SQLSRV_ERR_ALL);
                return ['done'=>false,'sets'=>$sets,'diagnostics'=>s152Diagnostics($errors)];
            }
            if ($next===null) {return ['done'=>true,'sets'=>$sets,'diagnostics'=>[]];}
        }
        throw new RuntimeException('Учебная процедура неожиданно вернула больше 16 результатов.');
    }

    $name=s152OwnTable($db,$owned,'labels','(id int NOT NULL PRIMARY KEY,label nvarchar(40) NOT NULL)');
    $q=s152Qualified($name);
    s152Command($db,"INSERT INTO $q(id,label) VALUES(1,?)",[
        ['Кабель №7',SQLSRV_PARAM_IN,SQLSRV_PHPTYPE_STRING('UTF-8'),SQLSRV_SQLTYPE_NVARCHAR('40')]]);
    $procName=s152OwnProcedure($db,$owned,'label_receipt',"@id int,@receipt nvarchar(80) OUTPUT AS BEGIN SET NOCOUNT ON;
        SELECT @receipt=N'Получено: '+label FROM $q WHERE id=@id;
        IF @@ROWCOUNT<>1 THROW 50003,N'Этикетка не найдена',1;
        SELECT @id AS receipt_id; END");
    $proc=s152Qualified($procName);$receipt='';
    $params=[1,[&$receipt,SQLSRV_PARAM_OUT,SQLSRV_PHPTYPE_STRING('UTF-8'),SQLSRV_SQLTYPE_NVARCHAR('80')]];
    $stmt=s152Query($db,"{CALL $proc(?,?)}",$params);
    try {$valid=finishContract152($stmt);} finally {sqlsrv_free_stmt($stmt);}
    if (!$valid['done']) {throw new RuntimeException('Полная квитанция не получена.');}
    // Deliberate local failure: the SQL parameter remains80; only the client binding is too short.
    $oldWarnings=sqlsrv_get_config('WarningsReturnAsErrors');
    if (!sqlsrv_configure('WarningsReturnAsErrors',true)) {s152Failure('Настройка учебной диагностики');}
    $short='';$bad=null;
    try {
        $shortParams=[1,[&$short,SQLSRV_PARAM_OUT,SQLSRV_PHPTYPE_STRING('UTF-8'),SQLSRV_SQLTYPE_NVARCHAR('4')]];
        $badStmt=sqlsrv_query($db,"{CALL $proc(?,?)}",$shortParams,['QueryTimeout'=>10]);
        if ($badStmt===false) {
            $errors=sqlsrv_errors(SQLSRV_ERR_ALL);
            $bad=['done'=>false,'sets'=>[],'diagnostics'=>s152Diagnostics($errors)];
        } else {
            try {$bad=finishContract152($badStmt);} finally {sqlsrv_free_stmt($badStmt);}
        }
        // Do not display or trust $short: output buffers after failure are not a valid receipt.
    } finally {
        if (!sqlsrv_configure('WarningsReturnAsErrors',$oldWarnings)) {s152Failure('Восстановление настройки диагностики');}
    }
    $truncated=false;
    foreach ($bad['diagnostics'] as $diagnostic) {
        if ($diagnostic['SQLSTATE']==='01004') {$truncated=true;}
    }
    $saved=s152Read($db,"SELECT label FROM $q WHERE id=?",[1])[0]['label'];
    $rows=[['Полная квитанция',$receipt],['PHP-тип квитанции',get_debug_type($receipt)],['Вместимость правильного параметра','NVARCHAR(80)'],['Слишком короткий параметр','NVARCHAR(4)'],['Обрезание распознано по SQLSTATE','01004'],['Значение ошибочного OUT','не используется'],['Исходная этикетка в базе',$saved]];
    $checks=['valid_finished'=>$valid['done'],'unicode_complete'=>$receipt==='Получено: Кабель №7',
        'valid_string'=>is_string($receipt),'small_buffer_failed'=>$bad['done']===false,
        'truncation_diagnostic'=>$truncated,'original_label_intact'=>$saved==='Кабель №7',
        'warning_policy_restored'=>sqlsrv_get_config('WarningsReturnAsErrors')===$oldWarnings];
    $observations=['complete_receipt'=>$receipt,'valid_results'=>$valid['sets'],
        'too_small'=>['done'=>$bad['done'],'diagnostics'=>$bad['diagnostics']],
        'original_label'=>$saved,'small_output_omitted'=>'Недостоверный OUT после ошибки не читается в отчёт.'];

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

s152Report('sqlsrv152-param-text-buffer','Вернуть кириллицу полностью и распознать короткий буфер',$rows,$checks,$observations,$runtime,$owned,$removed);

Полная квитанция — Получено: Кабель №7
PHP-тип квитанции — string
Вместимость правильного параметра — NVARCHAR(80)
Слишком короткий параметр — NVARCHAR(4)
Обрезание распознано по SQLSTATE — 01004
Значение ошибочного OUT — не используется
Исходная этикетка в базе — Кабель №7

Самостоятельная программа включает lab.php и README.txt. Она создаёт свою небольшую таблицу и процедуру SQL Server, вызывает процедуру с параметрами, сохраняет result.html/result.json/metrics.json и удаляет только собственные учебные объекты. Процедура создаётся одним SQL-вызовом без GO: GO — команда внешнего клиента, а не часть отправляемого T-SQL.

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

    $config=s152Config();$db=s152Connect($config);$runtime=s152Runtime($db,$config);

    function finishContract152($stmt): array {
        $sets=[];
        for ($result=0;$result<16;$result++) {
            $fields=sqlsrv_num_fields($stmt);
            if ($fields===false) {
                $errors=sqlsrv_errors(SQLSRV_ERR_ALL);
                return ['done'=>false,'sets'=>$sets,'diagnostics'=>s152Diagnostics($errors)];
            }
            if ($fields>0) {
                $rows=[];
                while (true) {
                    $row=sqlsrv_fetch_array($stmt,SQLSRV_FETCH_ASSOC);
                    if ($row===null) {break;}
                    if ($row===false) {
                        $errors=sqlsrv_errors(SQLSRV_ERR_ALL);
                        return ['done'=>false,'sets'=>$sets,'diagnostics'=>s152Diagnostics($errors)];
                    }
                    $rows[]=$row;
                }
                $sets[]=$rows;
            }
            $next=sqlsrv_next_result($stmt);
            if ($next===false) {
                $errors=sqlsrv_errors(SQLSRV_ERR_ALL);
                return ['done'=>false,'sets'=>$sets,'diagnostics'=>s152Diagnostics($errors)];
            }
            if ($next===null) {return ['done'=>true,'sets'=>$sets,'diagnostics'=>[]];}
        }
        throw new RuntimeException('Учебная процедура неожиданно вернула больше 16 результатов.');
    }

    $name=s152OwnTable($db,$owned,'exact','(id int NOT NULL PRIMARY KEY,total decimal(19,4) NOT NULL,external_id bigint NOT NULL)');
    $q=s152Qualified($name);
    $inputTotal='123456789012345.6789';$inputId='9223372036854775806';
    s152Command($db,"INSERT INTO $q(id,total,external_id) VALUES(1,?,?)",[
        [$inputTotal,SQLSRV_PARAM_IN,SQLSRV_PHPTYPE_STRING('UTF-8'),SQLSRV_SQLTYPE_DECIMAL(19,4)],
        [$inputId,SQLSRV_PARAM_IN,SQLSRV_PHPTYPE_STRING('UTF-8'),SQLSRV_SQLTYPE_BIGINT]]);
    $procName=s152OwnProcedure($db,$owned,'exact_receipt',"@id int,@total decimal(19,4) OUTPUT,@externalId bigint OUTPUT AS BEGIN SET NOCOUNT ON;
        SELECT @total=total,@externalId=external_id FROM $q WHERE id=@id;
        IF @@ROWCOUNT<>1 THROW 50002,N'Запись не найдена',1;
        SELECT @id AS receipt_id; END");
    $proc=s152Qualified($procName);$total='0';$externalId='0';
    $params=[1,[&$total,SQLSRV_PARAM_OUT,SQLSRV_PHPTYPE_STRING('UTF-8'),SQLSRV_SQLTYPE_DECIMAL(19,4)],
        [&$externalId,SQLSRV_PARAM_OUT,SQLSRV_PHPTYPE_STRING('UTF-8'),SQLSRV_SQLTYPE_BIGINT]];
    $stmt=s152Query($db,"{CALL $proc(?,?,?)}",$params);
    try {$result=finishContract152($stmt);} finally {sqlsrv_free_stmt($stmt);}
    if (!$result['done']) {throw new RuntimeException('Точные выходные значения не получены.');}
    $payload=json_encode(['total'=>$total,'external_id'=>$externalId],JSON_UNESCAPED_UNICODE|JSON_THROW_ON_ERROR);
    $decoded=json_decode($payload,true,512,JSON_THROW_ON_ERROR);
    $saved=s152Read($db,"SELECT total,external_id FROM $q WHERE id=?",[1])[0];
    $rows=[['Сумма DECIMAL(19,4)',$total],['PHP-тип суммы',get_debug_type($total)],['Номер BIGINT',$externalId],['PHP-тип номера',get_debug_type($externalId)],['JSON для передачи',$payload]];
    $checks=['all_results_finished'=>$result['done'],'decimal_exact'=>$total===$inputTotal,
        'bigint_exact'=>$externalId===$inputId,'both_strings'=>is_string($total)&&is_string($externalId),
        'json_preserves_contract'=>$decoded===['total'=>$inputTotal,'external_id'=>$inputId],
        'readback_agrees'=>$saved===['total'=>$inputTotal,'external_id'=>$inputId],
        'receipt_selected'=>$result['sets']===[[['receipt_id'=>1]]]];
    $observations=['output'=>['total'=>$total,'external_id'=>$externalId],'database'=>$saved,'json'=>$payload];

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

s152Report('sqlsrv152-param-exact-output','Передать точную сумму и большой номер без округления',$rows,$checks,$observations,$runtime,$owned,$removed);

Сумма DECIMAL(19,4) — 123456789012345.6789
PHP-тип суммы — string
Номер BIGINT — 9223372036854775806
PHP-тип номера — string
JSON для передачи — {"total":"123456789012345.6789","external_id":"9223372036854775806"}

Самостоятельная программа включает lab.php и README.txt. Она создаёт свою небольшую таблицу и процедуру SQL Server, вызывает процедуру с параметрами, сохраняет result.html/result.json/metrics.json и удаляет только собственные учебные объекты. Процедура создаётся одним SQL-вызовом без GO: GO — команда внешнего клиента, а не часть отправляемого T-SQL.