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

Как выбрать настоящий объект команды

Вы ищете способ получить результат SQL-запроса и попадаете на класс Statement с методами getResult и getNextResult. Кажется, достаточно создать такой объект. Но в установленном расширении конструктор закрыт, а команды приложения создаются другим публичным способом. Разберёмся, что именно можно проверить, какой объект действительно возвращается и как получить нужные строки, не пытаясь подделать внутренний объект драйвера.

Класс описывает тип объекта. Конструктор создаёт и инициализирует экземпляр; private ограничивает его вызов самим классом. Наличие public-метода не создаёт экземпляр автоматически. Reflection — средство прочитать метаданные уже зарегистрированного класса. Здесь new ReflectionClass создаёт объект описания, а не mysql_xdevapi\Statement и не соединение с MySQL.

В PECL 8.0.30 Statement существует и используется внутри реализации CRUD. В просмотренном matching исходнике не найден публичный способ получить его как рабочий объект приложения: внутренний create_stmt получает нативный указатель, а обычный execute выдаёт конкретный объект результата. Это не объявление класса отсутствующим или официально устаревшим. На страницах методов просто нет полноценного описания поведения. Мы сохраняем их сигнатуры и отдельно показываем проверенный публичный путь.

Для этой главы нужны вызов функции и возвращаемое значение, объекты, методы и видимость и Reflection. Если само подключение ещё непонятно, начните с первой коллекции. Карта совместимости и настоящие метаданные продолжает различение документации и установленного расширения.

Ни один прямой вызов getResult/getNextResult/hasMoreResults у Statement в этой главе не объявлен проверенным прикладным сценарием. Новая самостоятельная программа безопасно читает метаданные. Для запросов, нескольких наборов и callback приведены точные ссылки на уже выполненные программы, а не повторные демонстрации с выдуманным Statement.

Три небольшие проверки перед переносом кода

Перед переносом обработчика нужно понять, зарегистрирован ли нужный класс. Проверка не должна запускать пользовательский автозагрузчик, который может создать совсем другой PHP-класс с тем же именем.

$name = 'mysql_xdevapi\\Statement';
$present = class_exists($name, false);
var_dump($present); // В профиле 8.0.30: bool(true).

Переменная $name содержит полное имя с пространством имён. Второй аргумент false отключает автозагрузку: проверяем уже имеющуюся запись. true означает, что класс существует; это ещё не разрешение создавать его через new и не доказательство выполненного SQL.

Проверить границу создания объекта

$name = 'mysql_xdevapi\\Statement';
if (class_exists($name, false)) {
    $info = new ReflectionClass($name);
    var_dump($info->getConstructor()->isPrivate()); // bool(true)
    var_dump($info->isInstantiable());              // bool(false)
}

if выполняет блок только при наличии класса. ReflectionClass принимает его имя. getConstructor возвращает описание конструктора; isPrivate отвечает о видимости, а isInstantiable — о возможности обычного создания экземпляра. В этом конкретном классе конструктор есть; универсальный инспектор должен также обработать null от getConstructor. Итог полезен для миграции: код с new Statement нужно заменить корректной фабрикой соответствующей команды, а не обходом конструктора.

Проверить метод перед выбором API

$info = new ReflectionClass('mysql_xdevapi\\Statement');
echo $info->hasMethod('execute') ? 'Есть execute' : 'Нет execute';
// Нет execute. Для SQL-команды используйте Session::sql → SqlStatement.

Название Statement не является общим интерфейсом всех команд. Нужный приложению метод execute зарегистрирован у SqlStatement, а у исследуемого Statement его нет. Полный отчёт собирает эти отдельные проверки вместе, сохраняет структуру и не вызывает методы нативного экземпляра.

Проверить доступность Statement без создания нативного объекта

Нужен отчёт для проверки совместимости: существует ли Statement, разрешено ли обычное создание, какие константы и методы зарегистрированы. Вход — метаданные текущего PHP; результат — таблица без соединения с базой. Значения 1/2 и private снимаются из настоящего расширения, а не подставляются вместо опроса.

Ожидаемый результат профиля 8.0.30

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

    $name='mysql_xdevapi\Statement';
    if (!class_exists($name,false)) {
        throw new RuntimeException('Statement не зарегистрирован в этом PHP. Сначала проверьте загрузку и версию mysql_xdevapi.');
    }
    $class=new ReflectionClass($name);
    $constructor=$class->getConstructor();
    $constructorVisibility=$constructor===null ? 'нет' :
        ($constructor->isPrivate() ? 'private' : ($constructor->isProtected() ? 'protected' : 'public'));
    $constants=$class->getConstants();
    ksort($constants);
    $methods=[];
    foreach (['getResult','getNextResult','hasMoreResults'] as $methodName) {
        if (!$class->hasMethod($methodName)) {throw new RuntimeException('Ожидаемый метод не зарегистрирован.');}
        $method=$class->getMethod($methodName);
        $methods[$methodName]=[
            'public'=>$method->isPublic(),'static'=>$method->isStatic(),
            'required_parameters'=>$method->getNumberOfRequiredParameters(),
            'declared_parameters'=>$method->getNumberOfParameters(),
            'declared_return'=>$method->hasReturnType() ? (string)$method->getReturnType() : null,
            'declaring_class'=>$method->getDeclaringClass()->getName(),
        ];
    }
    $sqlAvailable=class_exists('mysql_xdevapi\SqlStatement',false);
    $sqlClass=$sqlAvailable ? new ReflectionClass('mysql_xdevapi\SqlStatement') : null;
    $sqlExecute=$sqlClass!==null && $sqlClass->hasMethod('execute') && $sqlClass->getMethod('execute')->isPublic();
    $publicReaders=true;
    foreach ($methods as $method) {
        $publicReaders=$publicReaders && $method['public'] && !$method['static'] && $method['required_parameters']===0;
    }
    $rows=[['Statement зарегистрирован',true],['Класс внутренний',$class->isInternal()],
        ['Можно создать обычным new',$class->isInstantiable()],['Видимость конструктора',$constructorVisibility],
        ['EXECUTE_ASYNC',$constants['EXECUTE_ASYNC']??null],['BUFFERED',$constants['BUFFERED']??null],
        ['getResult — public',$methods['getResult']['public']],
        ['getNextResult — public',$methods['getNextResult']['public']],
        ['hasMoreResults — public',$methods['hasMoreResults']['public']],
        ['У Statement есть execute',$class->hasMethod('execute')],
        ['У SqlStatement есть public execute',$sqlExecute],
        ['Рабочий путь','Session::sql → SqlStatement → результат'],
        ['Соединение с базой открывалось',false]];
    $checks=['registered_internal_class'=>$class->isInternal() && $class->getExtensionName()==='mysql_xdevapi',
        'constructor_boundary'=>$constructorVisibility==='private' && !$class->isInstantiable(),
        'constants_match'=>$constants===['BUFFERED'=>2,'EXECUTE_ASYNC'=>1],
        'three_instance_readers'=>$publicReaders && count($methods)===3,
        'public_sql_route_has_execute'=>!$class->hasMethod('execute') && $sqlExecute,
        'no_database_contact'=>$session===null && $owned===[]];
    $observations+=['class'=>$class->getName(),'extension'=>$class->getExtensionName(),
        'internal'=>$class->isInternal(),'instantiable'=>$class->isInstantiable(),
        'constructor_visibility'=>$constructorVisibility,'constants'=>$constants,'methods'=>$methods,
        'statement_has_execute'=>$class->hasMethod('execute'),'sqlstatement_has_public_execute'=>$sqlExecute,
        'native_instance_created'=>false,'native_instance_methods_called'=>false,
        'database_connection_attempted'=>false];

} finally {
    if ($session instanceof mysql_xdevapi\Session) {
        try {
            if ($schema instanceof mysql_xdevapi\Schema) {$removed=x147Cleanup($schema,$owned);}
        } finally {$session->close();}
    }
}

x147Report('mysql147-x-statement-contract-map', 'Проверить доступность Statement без создания нативного объекта', $rows, $checks, $observations, $runtime, $owned, $removed);

Statement зарегистрирован — да
Класс внутренний — да
Можно создать обычным new — нет
Видимость конструктора — private
EXECUTE_ASYNC — 1
BUFFERED — 2
getResult — public — да
getNextResult — public — да
hasMoreResults — public — да
У Statement есть execute — нет
У SqlStatement есть public execute — да
Рабочий путь — Session::sql → SqlStatement → результат
Соединение с базой открывалось — нет

Таблица фактического запуска · Полные метаданные и проверки JSON.

Архив содержит example.php, lab.php и README.txt. В JSON сохраняются видимость, объявленные параметры и наличие типа возврата; metrics.json — сводные проверки. Отчёт не запускает SQL, не создаёт экземпляр Statement и не выясняет готовность сервера. Если расширение отсутствует, он сообщает причину; начните с диагностики установки.

Объявленные параметры — именно метаданные регистрации, а не полный разбор аргументов внутри расширения. В этом профиле Reflection показывает ноль параметров у читателей, но общий нативный reader также содержит callback-ветвь. Поэтому по числу ноль нельзя автоматически заключать «callback не поддерживается»; его публичный путь разобран в связанной программе с фактическим результатом.

Проверьте понимание

В отчёте getResult помечен public, а класс нельзя создать обычным new. Противоречат ли эти наблюдения друг другу? Можно ли по declared_return=null объявить, что результат всегда null?

Получить строки и дочитать ответ публичными методами

Допустим, экран должен показать позиции счёта и итог. Рабочая команда получается из уже открытой Session. Метод sql возвращает SqlStatement; синхронный execute — результат. Следующий фрагмент показывает этот путь в контексте существующей подготовленной процедуры, а не создаёт учебную базу заново.

$command = $session->sql('CALL ' . $qualifiedProcedure . '()');
$result = $command->execute();
do {
    $rows = $result->getColumnsCount() > 0 ? $result->fetchAll() : [];
    // Обработайте текущий набор, включая пустой.
} while ($result->nextResult() === true);

Это контекстный фрагмент для SqlStatementResult. $session и $qualifiedProcedure подготовлены в самостоятельном примере отчёта об отправлениях. Там первая часть пуста, следующая содержит 2 готовых отправления и 2700 копеек; после завершения ответов контрольный SELECT даёт 1. Нельзя присваивать $result = $result->nextResult(): в проверенном профиле nextResult возвращает bool.

Если отправка и получение разделены

$command = $session->sql('CALL ' . $qualifiedProcedure . '()');
$sent = $command->execute(mysql_xdevapi\SqlStatement::EXECUTE_ASYNC | mysql_xdevapi\SqlStatement::BUFFERED);
if ($sent !== true) { throw new RuntimeException('Команда не отправлена.'); }
$current = $command->getResult();
while ($current !== false && $current !== null) {
    $rows = $current->getColumnsCount() > 0 ? $current->fetchAll() : [];
    // Обработайте эту часть отчёта до перехода.
    if (!$command->hasMoreResults()) { break; }
    $current = $command->getNextResult();
}

Здесь методы getResult/getNextResult/hasMoreResults принадлежат SqlStatement. Константы также берём у SqlStatement; наличие таких же чисел у Statement не превращает его в команду приложения. | объединяет флаги, ASYNC отделяет отправку от получения, BUFFERED выбирает буферизацию. true от execute означает отправку, а не готовый успешный результат.

Полная процедура и все проверки находятся в примере счёта: две лампы и кабель, всего 3200 копеек. Этот путь прочитал три ответа: позиции, сумму и пустое служебное завершение CALL. getResult может ждать сервер: ASYNC не обещает полностью неблокирующий PHP и не разрешает произвольно отправлять следующую команду на занятое соединение. Буферизация не заменяет WHERE/LIMIT для большого отчёта.

Когда возникает ошибка

Callback-путь имеет отдельный контракт: успешная запись и реальная квитанция и отказ повторного заказа показывают фактические события и сохранённые данные. Во втором случае ошибка 1062 прочитана из ответа, исходный ORDER-A остаётся с суммой 12.34, а следующий контрольный запрос работает. Не переносите эти callback-аргументы на Statement только по сходству названий. Полный читатель в тех программах относится именно к публичному SqlStatement.

Выбирайте один способ чтения конкретной последовательности. Цикл nextResult у результата и цикл getNextResult у команды — две разные организации чтения. Смешивание их на одном ответе лишает программу понятного владельца текущего состояния. Пустой набор строк, завершение набора и завершение всей команды — три разных события.

Класс и методы в справочнике

Почему возникают ошибки выбора объекта и чтения

Вопрос приводит к попыткам обхода конструктора через Reflection. Для нативного Statement это неверный путь к рабочей SQL-команде: объекту нужно внутреннее состояние драйвера. Мы исследуем только метаданные класса, а операции получаем через существующий публичный API. Чужой код обхода видимости не используется. Как работать с классом, у которого закрытый конструктор.

Проблема сформулирована для PDO: пустой массив приняли за отсутствие дальнейшего результата. Здесь раскрыта та же ошибка модели, но применяются методы X DevAPI и его собственные фактические результаты; PDO nextRowset не переносится в этот API. После пустого первого набора потерян полезный ответ процедуры.

Обсуждение MySQLi показывает нарушение порядка чтения. Наличие одного массива строк не означает, что весь ответ завершён. В X DevAPI выбираем один потребитель последовательности и дочитываем её перед следующим SQL. Рецепты free/close из другого драйвера не подменяют этот контракт. Следующий запрос отправлен до завершения ответа CALL.

Применить вывод к своему обработчику

Проверьте, откуда берётся каждый объект вашего обработчика: соединение, команда, результат, строка. Если ожидается счёт с несколькими разделами, выберите один способ полного чтения и определите обработку ошибки отдельно от окончания ответа. Публичный отчёт счёта, отказ повторной записи и контракт экспортируемых столбцов показывают продолжение на рабочих данных.

Документированные узлы Statement сохранены в дереве и объяснены полностью в пределах доступного baseline. Это не заявление о проверенных прямых вызовах всех внутренних методов или полноте всего PHP Manual. Состояние поддержки относится к указанной версии расширения; перенос на другую версию начинается с проверки её фактического контракта.