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

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

    $config=s151Config();$db=s151Connect($config);$runtime=s151Runtime($db,$config);

    $orders=s151OwnTable($db,$owned,'cancel_reuse','(id int NOT NULL PRIMARY KEY, total_minor int NOT NULL)');
    $q=s151Qualified($orders);
    s151Command($db,"INSERT INTO $q (id,total_minor) VALUES (1,1000),(2,2000),(3,3000),(4,4000)");
    $minimum=1000;
    $params=[&$minimum];
    $stmt=sqlsrv_prepare($db,"SELECT id,total_minor FROM $q WHERE total_minor>=? ORDER BY id",$params,['QueryTimeout'=>10]);
    if ($stmt===false) {s151Failure('Подготовка поиска');}
    try {
        $resourceId=get_resource_id($stmt);
        if (sqlsrv_execute($stmt)===false) {s151Failure('Первый поиск');}
        $first=sqlsrv_fetch_array($stmt,SQLSRV_FETCH_ASSOC);
        if ($first===false) {s151Failure('Первая строка поиска');}
        if ($first===null) {throw new RuntimeException('В учебной выдаче должна быть строка');}
        // The caller now needs another filter; rows 2, 3 and 4 of this result are not used.
        $cancelled=sqlsrv_cancel($stmt);
        if ($cancelled===false) {s151Failure('Отмена остатка первого поиска');}
        $minimum=3000;
        if (sqlsrv_execute($stmt)===false) {s151Failure('Повторный поиск с новым порогом');}
        $again=s151Rows($stmt);
        $sameStatement=$resourceId===get_resource_id($stmt);
    } finally {
        $freed=sqlsrv_free_stmt($stmt);
        if ($freed===false) {s151Failure('Освобождение поисковой команды');}
    }
    $stmt=null; // Do not use the freed statement again.
    $ids=implode(', ',array_column($again,'id'));
    $remaining=s151Read($db,"SELECT COUNT(*) AS total FROM $q")[0]['total'];
    $rows=[['Первый порог, копейки',1000],['Прочитан ID первого результата',$first['id']],
        ['Остаток результата отменён',$cancelled],['Новый порог, копейки',$minimum],
        ['ID после повторного execute',$ids],['Повторён тот же подготовленный ресурс',$sameStatement],
        ['Ресурс окончательно освобождён',$freed],['Строк в самой таблице',$remaining]];
    $checks=['first_row'=>$first===['id'=>1,'total_minor'=>1000],'cancel_succeeded'=>$cancelled===true,
        'new_bound_filter'=>$again===[['id'=>3,'total_minor'=>3000],['id'=>4,'total_minor'=>4000]],
        'same_prepared_resource'=>$sameStatement,'free_succeeded'=>$freed===true,'table_unchanged'=>$remaining===4];
    $observations=['first_row'=>$first,'second_result'=>$again,'filter_values'=>[1000,3000],
        'same_statement'=>$sameStatement,'table_row_count_after_cancel'=>$remaining];

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

s151Report('sqlsrv151-cancel-reuse','Закрыть ненужную выдачу и повторить подготовленный поиск',$rows,$checks,$observations,$runtime,$owned,$removed);

Первый порог, копейки — 1000
Прочитан ID первого результата — 1
Остаток результата отменён — да
Новый порог, копейки — 3000
ID после повторного execute — 3, 4
Повторён тот же подготовленный ресурс — да
Ресурс окончательно освобождён — да
Строк в самой таблице — 4

Распакуйте в отдельную папку и следуйте README.txt. lab.php содержит открытый код подключения к отдельному учебному SQL Server и сохранения результатов. example.php создаёт одну собственную таблицу, демонстрирует состояние команды и удаляет только эту таблицу после наблюдений.

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

    $config=s151Config();$db=s151Connect($config);$runtime=s151Runtime($db,$config);

    $stock=s151OwnTable($db,$owned,'cancel_transaction','(id int NOT NULL PRIMARY KEY, available int NOT NULL)');
    $q=s151Qualified($stock);
    s151Command($db,"INSERT INTO $q (id,available) VALUES (1,10)");
    s151Command($db,'SET NOCOUNT OFF');
    $active=false;$stmt=null;
    try {
        if (sqlsrv_begin_transaction($db)===false) {s151Failure('Начало учебного резерва');}
        $active=true;
        $stmt=s151Query($db,"UPDATE $q SET available=available-? WHERE id=? AND available>=?",[2,1,2]);
        $affected=sqlsrv_rows_affected($stmt);
        if ($affected===false) {s151Failure('Количество изменённых строк резерва');}
        if ($affected!==1) {throw new RuntimeException('Ожидался резерв одной учебной позиции');}
        // This UPDATE has completed. Cancel is not an undo of its data change.
        $cancelled=sqlsrv_cancel($stmt);
        if ($cancelled===false) {s151Failure('Отмена остатка команды резерва');}
        if (sqlsrv_free_stmt($stmt)===false) {s151Failure('Освобождение команды резерва');}
        $stmt=null;
        $inside=s151Read($db,"SELECT available FROM $q WHERE id=?",[1])[0]['available'];
        $transactionCount=s151Read($db,'SELECT @@TRANCOUNT AS transaction_count')[0]['transaction_count'];
        $rolledBack=sqlsrv_rollback($db);
        if ($rolledBack===false) {s151Failure('Явная отмена учебного резерва');}
        $active=false;
    } finally {
        if (is_resource($stmt)) {sqlsrv_free_stmt($stmt);}
        if ($active && sqlsrv_rollback($db)===false) {s151Failure('Аварийный откат учебного резерва');}
    }
    $after=s151Read($db,"SELECT available FROM $q WHERE id=?",[1])[0]['available'];
    $afterCount=s151Read($db,'SELECT @@TRANCOUNT AS transaction_count')[0]['transaction_count'];
    $rows=[['До резерва',10],['UPDATE изменил строк',$affected],['cancel команды успешен',$cancelled],
        ['Свое соединение после cancel видит',$inside],['Транзакций после cancel',$transactionCount],
        ['Явный rollback успешен',$rolledBack],['После rollback доступно',$after],['Транзакций после rollback',$afterCount]];
    $checks=['one_row_updated'=>$affected===1,'cancel_succeeded'=>$cancelled===true,'cancel_not_undo'=>$inside===8,
        'transaction_still_active'=>$transactionCount===1,'rollback_succeeded'=>$rolledBack===true,
        'stock_restored'=>$after===10,'transaction_closed'=>$afterCount===0];
    $observations=['available_before'=>10,'available_after_completed_update_and_cancel'=>$inside,
        'transaction_count_after_cancel'=>$transactionCount,'available_after_rollback'=>$after];

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

s151Report('sqlsrv151-cancel-transaction','Отличить отмену команды от отмены резерва',$rows,$checks,$observations,$runtime,$owned,$removed);

До резерва — 10
UPDATE изменил строк — 1
cancel команды успешен — да
Свое соединение после cancel видит — 8
Транзакций после cancel — 1
Явный rollback успешен — да
После rollback доступно — 10
Транзакций после rollback — 0

Распакуйте в отдельную папку и следуйте README.txt. lab.php содержит открытый код подключения к отдельному учебному SQL Server и сохранения результатов. example.php создаёт одну собственную таблицу, демонстрирует состояние команды и удаляет только эту таблицу после наблюдений.

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

    $config=s151Config();$db=s151Connect($config);$runtime=s151Runtime($db,$config);

    $items=s151OwnTable($db,$owned,'mars_pending','(id int NOT NULL PRIMARY KEY, payload varchar(4000) NOT NULL)');
    $q=s151Qualified($items);
    s151Command($db,";WITH n AS (SELECT 1 AS id UNION ALL SELECT id+1 FROM n WHERE id<200)
        INSERT INTO $q (id,payload) SELECT id,REPLICATE('x',4000) FROM n OPTION (MAXRECURSION 200)");
    $singleConfig=$config;
    $singleConfig['options']['MultipleActiveResultSets']=false;
    $single=s151Connect($singleConfig);
    $pending=null;
    try {
        $pending=s151Query($single,"SELECT id,payload FROM $q ORDER BY id",[],['Scrollable'=>SQLSRV_CURSOR_FORWARD]);
        $first=sqlsrv_fetch_array($pending,SQLSRV_FETCH_ASSOC);
        if ($first===false) {s151Failure('Чтение первой строки большой выдачи');}
        if ($first===null) {throw new RuntimeException('Учебная выдача неожиданно пуста');}
        // Deliberate second command while most of the first result remains unread.
        $blocked=sqlsrv_query($single,"SELECT COUNT(*) AS total FROM $q",[],['QueryTimeout'=>2]);
        $saved=s151Diagnostics(sqlsrv_errors(SQLSRV_ERR_ALL));
        $wasBlocked=$blocked===false;
        if (is_resource($blocked)) {sqlsrv_free_stmt($blocked);}
        if (!$wasBlocked) {throw new RuntimeException('Ожидался контролируемый отказ из-за pending results');}
        $cancelled=sqlsrv_cancel($pending);
        if ($cancelled===false) {s151Failure('Освобождение соединения отменой выдачи');}
        $after=s151Read($single,"SELECT COUNT(*) AS total FROM $q")[0]['total'];
    } finally {
        if (is_resource($pending)) {sqlsrv_free_stmt($pending);}
        sqlsrv_close($single);
    }
    $pendingCode=false;
    foreach ($saved as $error) {
        if ($error['SQLSTATE']==='IMSSP' && $error['code']===-44) {$pendingCode=true;}
    }
    $rows=[['MARS в учебном соединении',false],['Прочитан первый ID',$first['id']],
        ['Байт в поле первой строки',strlen($first['payload'])],['Вторая команда отклонена',$wasBlocked],
        ['Причина pending results сохранена',$pendingCode],['Ненужная выдача отменена',$cancelled],
        ['COUNT после cancel на том же соединении',$after]];
    $checks=['first_id'=>$first['id']===1,'large_unread_result'=>strlen($first['payload'])===4000,
        'second_command_blocked'=>$wasBlocked,'pending_diagnostic'=>$pendingCode,
        'cancel_succeeded'=>$cancelled===true,'connection_reused'=>$after===200];
    $observations=['mars_enabled'=>false,'seeded_rows'=>200,'first_payload_bytes'=>strlen($first['payload']),
        'blocked_command_diagnostic'=>$saved,'count_after_cancel'=>$after];

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

s151Report('sqlsrv151-mars-pending','Освободить соединение, занятое непрочитанной выдачей',$rows,$checks,$observations,$runtime,$owned,$removed);

MARS в учебном соединении — нет
Прочитан первый ID — 1
Байт в поле первой строки — 4000
Вторая команда отклонена — да
Причина pending results сохранена — да
Ненужная выдача отменена — да
COUNT после cancel на том же соединении — 200

Распакуйте в отдельную папку и следуйте README.txt. lab.php содержит открытый код подключения к отдельному учебному SQL Server и сохранения результатов. example.php создаёт одну собственную таблицу, демонстрирует состояние команды и удаляет только эту таблицу после наблюдений.

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

    $config=s151Config();$db=s151Connect($config);$runtime=s151Runtime($db,$config);

    $jobs=s151OwnTable($db,$owned,'query_timeout','(id int NOT NULL PRIMARY KEY, job_status varchar(16) NOT NULL)');
    $q=s151Qualified($jobs);
    s151Command($db,"INSERT INTO $q (id,job_status) VALUES (1,'ready')");
    $started=hrtime(true);
    // A bounded read-only delay deliberately exceeds this statement's one-second timeout.
    $slow=sqlsrv_query($db,"WAITFOR DELAY '00:00:03'; SELECT job_status FROM $q WHERE id=?",[1],['QueryTimeout'=>1]);
    $saved=s151Diagnostics(sqlsrv_errors(SQLSRV_ERR_ALL));
    $elapsed=(hrtime(true)-$started)/1000000000;
    $failed=$slow===false;
    if (is_resource($slow)) {sqlsrv_free_stmt($slow);}
    if (!$failed) {throw new RuntimeException('Ожидался контролируемый таймаут команды');}
    $timeoutDiagnostic=false;
    foreach ($saved as $error) {
        if ($error['SQLSTATE']==='HYT00') {$timeoutDiagnostic=true;}
    }
    $after=s151Read($db,"SELECT job_status FROM $q WHERE id=?",[1])[0]['job_status'];
    $count=s151Read($db,"SELECT COUNT(*) AS total FROM $q")[0]['total'];
    $rows=[['QueryTimeout этой команды, секунд',1],['Искусственная задержка SQL, секунд',3],
        ['Команда вернула false',$failed],['Сохранена диагностика таймаута',$timeoutDiagnostic],
        ['Новый SELECT на том же соединении',$after],['Строк после опыта',$count]];
    $checks=['query_timeout_returned_false'=>$failed,'timeout_diagnostic'=>$timeoutDiagnostic,
        'connection_reused'=>$after==='ready','table_unchanged'=>$count===1];
    $observations=['query_timeout_seconds'=>1,'requested_wait_seconds'=>3,'elapsed_seconds'=>round($elapsed,3),
        'saved_timeout_diagnostic'=>$saved,'state_after_timeout'=>$after,'row_count_after_timeout'=>$count];

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

s151Report('sqlsrv151-query-timeout','Ограничить ожидание команды и отличить таймаут от пустого ответа',$rows,$checks,$observations,$runtime,$owned,$removed);

QueryTimeout этой команды, секунд — 1
Искусственная задержка SQL, секунд — 3
Команда вернула false — да
Сохранена диагностика таймаута — да
Новый SELECT на том же соединении — ready
Строк после опыта — 1

Распакуйте в отдельную папку и следуйте README.txt. lab.php содержит открытый код подключения к отдельному учебному SQL Server и сохранения результатов. example.php создаёт одну собственную таблицу, демонстрирует состояние команды и удаляет только эту таблицу после наблюдений.