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

PECL CUBRID >= 8.3.0; отдельное согласование версий PHP/CCI/сервера. · cubrid

cubrid_fetch_array(resource $result, int $type = CUBRID_BOTH): array|false|null

Прочитать одну строку с именованными, числовыми или обоими наборами ключей.

Базовая запись

cubrid_fetch_array(resource $result, int $type = CUBRID_BOTH): array|false|null

В справочной записи resource — открытый request успешно выполненного SELECT, а не соединение $db и не PHP-массив. Знак | перечисляет варианты возврата; это не выполняемая декларация PHP 7.4. Все функции этой страницы представлены в PHP Manual как PECL CUBRID >= 8.3.0. Совместимость PHP, расширения, CCI и сервера проверяют отдельно; закреплённый учебный профиль описан во введении.

BOTH не удваивает число SQL-строк, но даёт два ключа для каждого обычного выбранного поля. Поэтому count($row) в таком режиме не является числом столбцов. Одинаковые имена полей в именованном представлении создают неоднозначность: назначайте разные AS или выбирайте числовые позиции. Имена ключей не превращают переданные значения в int автоматически.

Применение 1: подпись товара по имени поля

$row = cubrid_fetch_array($request, CUBRID_ASSOC);
if ($row === null) { throw new RuntimeException('Строка не прочитана'); }
if ($row !== false) {
    echo $row['title'].' — '.(int)$row['qty'].' шт.';
}

В карточках каталога это даёт «Кабель — 0 шт.». Проверяется весь результат fetch, а не истинность qty: строковый ноль является полезным остатком. Именованный доступ помогает не перепутать title и sku при изменении порядка SELECT.

Применение 2: единая строка для сравнения ячеек отчёта

$row = cubrid_fetch_array($request, CUBRID_ASSOC);
if (is_array($row) && array_key_exists('note', $row)) {
    $noteLabel = $row['note'] === null ? 'Не заполнено' : $row['note'];
}

В отчёте о NULL и пустом тексте весь ряд читается один раз, чтобы сопоставить отдельно полученные ячейки. array_key_exists сохраняет различие «ключ есть со значением null» и «столбец вообще не выбран». Для чисто позиционного экспорта есть cubrid_fetch_row.

Для LOB режим задают, например, CUBRID_ASSOC | CUBRID_LOB; размер/чтение такого объекта относятся к отдельному LOB API, обычный strlen здесь неприменим. Закрывайте request после обхода. Чтение не записывает ваши изменения массива обратно в SQL и не отменяет необходимости WHERE/ORDER BY/LIMIT. Если нужен только именованный режим без выбора типа, рядом cubrid_fetch_assoc.

• PHP Manual: cubrid_fetch_array
• Native CUBRID 11.2.0.0002: точная реализация
• CUBRID: CCI и результаты запросов

PECL CUBRID >= 8.3.0; отдельное согласование версий PHP/CCI/сервера. · cubrid

cubrid_fetch_row(resource $result, int $type = 0): array|false|null

Получить значения в порядке SELECT для последовательного экспорта.

Базовая запись

cubrid_fetch_row(resource $result, int $type = 0): array|false|null

В справочной записи resource — открытый request успешно выполненного SELECT, а не соединение $db и не PHP-массив. Знак | перечисляет варианты возврата; это не выполняемая декларация PHP 7.4. Все функции этой страницы представлены в PHP Manual как PECL CUBRID >= 8.3.0. Совместимость PHP, расширения, CCI и сервера проверяют отдельно; закреплённый учебный профиль описан во введении.

Индексы начинаются с 0 и соответствуют порядку выбранных столбцов, а не порядку полей полной таблицы. SELECT sku,title,qty даёт [артикул, название, остаток]. Если изменить SELECT на qty,sku, прежнее обращение $row[0] будет означать уже количество. У строки нет ключа title: нужен индекс 1 либо другая функция fetch.

Применение 1: строка CSV с согласованными заголовками

// $csv — уже открытый поток, SELECT возвращает sku,title,qty.
$row = cubrid_fetch_row($request);
if ($row === null) { throw new RuntimeException('Экспорт не прочитан'); }
if ($row !== false) { fputcsv($csv, $row, ';', '"', ''); }

В самостоятельном экспорте получается CAB-167;Кабель;0. fputcsv формирует корректные разделители и кавычки; простой implode не заменяет CSV-формат, если значения содержат разделитель или перевод строки. Числовые ключи удобны, потому что повторных именованных копий в строке нет.

Применение 2: сопоставить поле и его текущую длину

$row = cubrid_fetch_row($request);
if (is_array($row)) {
    $lengths = cubrid_fetch_lengths($request);
    if ($lengths === false) { throw new RuntimeException('Размеры недоступны'); }
    echo $row[1].': '.$lengths[1].' байт';
}

В ограничении обмена данными обе позиции 1 относятся к одному title: «Кабель: 12 байт». Сначала нужен успешный fetch, затем длины именно этой строки. Для перемотки перед новым обходом служит cubrid_data_seek.

Нельзя без проверки разыменовывать false на конце результата. Полный цикл различает null/предупреждение, нормальный EOF и настоящий массив. Получать все строки огромной таблицы ради последующего отбора в PHP не требуется: отбор и порядок задаются SQL, а эта функция лишь читает уже выбранное. LOB-параметр не делает автоматический файл или HTTP-ответ.

• PHP Manual: cubrid_fetch_row
• Native CUBRID 11.2.0.0002: точная реализация
• CUBRID: CCI и результаты запросов

PECL CUBRID >= 8.3.0; отдельное согласование версий PHP/CCI/сервера. · cubrid

cubrid_fetch_object(resource $result [, string $class_name [, array $params [, int $type]]]): object|false|null

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

Базовая запись

cubrid_fetch_object(resource $result [, string $class_name [, array $params [, int $type]]]): object|false|null

В справочной записи resource — открытый request успешно выполненного SELECT, а не соединение $db и не PHP-массив. Знак | перечисляет варианты возврата; это не выполняемая декларация PHP 7.4. Все функции этой страницы представлены в PHP Manual как PECL CUBRID >= 8.3.0. Совместимость PHP, расширения, CCI и сервера проверяют отдельно; закреплённый учебный профиль описан во введении.

Квадратные скобки в сигнатуре обозначают необязательные группы аргументов и не копируются в вызов. Для stdClass запись $item->title читает свойство. Пользовательский класс заранее объявляется, поля в учебном профиле объявлены нетипизированными: числовые данные драйвера ещё могут быть строками. Полученный объект — снимок строки; присваивание его свойству не выполняет UPDATE.

Применение 1: небольшой предпросмотр без собственного класса

$item = cubrid_fetch_object($request);
if ($item === null) { throw new RuntimeException('Предпросмотр не прочитан'); }
if ($item !== false) { echo $item->title; }
// Первый товар примера: Кабель.

В предпросмотре над списком это удобная запись одного объекта. Однако fetch уже продвинул курсор: для полного списка, включающего этот же товар, программа явно возвращается data_seek(0). stdClass не добавляет методов проверки остатка и не знает устройство склада.

Применение 2: объект этикетки с дополнительным префиксом

// CatalogLabel167 заранее объявлен в полном проекте.
$label = cubrid_fetch_object($request, CatalogLabel167::class, ['Склад']);
if (!($label instanceof CatalogLabel167)) {
    throw new RuntimeException('Этикетка не получена');
}
echo $label->caption();
// Склад: Кабель / CAB-167

В полном классе этикетки constructor получает только строку «Склад». Порядок в проверенной версии драйвера: сначала заполнение свойств строкой, затем вызов конструктора. Поэтому constructor видит title=Кабель, но может сам его перезаписать. Мы сохраняем prefix отдельно, не маскируя данные. Если модель требует проверки и преобразования всех полей в конструкторе, проще прочитать массив и явно выполнить new с нужными аргументами.

PHP Manual также показывает короткие LOB-формы, которые поддерживает закреплённый исходник: fetch_object($request, CUBRID_LOB); fetch_object($request, ClassName::class, CUBRID_LOB); либо полная форма с массивом params и четвёртым флагом. Они не означают, что любой int является именем класса. Несуществующий класс, неверный массив аргументов, недостающие обязательные аргументы или исключение конструктора — отдельные PHP-ошибки; не сводите их к EOF. Передача params классу без конструктора также не является полезной формой. Для неизвестных SQL-имён используйте явные aliases и простую модель чтения, а не произвольную гидратацию сложного доменного объекта.

• PHP Manual: cubrid_fetch_object
• Native CUBRID 11.2.0.0002: точная реализация
• CUBRID: CCI и результаты запросов

PECL CUBRID >= 8.3.0; отдельное согласование версий PHP/CCI/сервера. · cubrid

cubrid_data_seek(resource $result, int $row_number): bool

Перейти к строке результата по позиции от нуля перед следующим fetch.

Базовая запись

cubrid_data_seek(resource $result, int $row_number): bool

В справочной записи resource — открытый request успешно выполненного SELECT, а не соединение $db и не PHP-массив. Знак | перечисляет варианты возврата; это не выполняемая декларация PHP 7.4. Все функции этой страницы представлены в PHP Manual как PECL CUBRID >= 8.3.0. Совместимость PHP, расширения, CCI и сервера проверяют отдельно; закреплённый учебный профиль описан во введении.

Функция не возвращает сам массив. В закреплённом исходнике она преобразует внешний offset в offset+1 для CCI с origin FIRST. Поэтому нулевая позиция API означает первую строку. Пустой результат и выход за границу требуют отдельной обработки; произвольное большое число не создаёт строку и не превращается в поиск по id.

Применение 1: вернуть первую строку после предпросмотра

if (cubrid_data_seek($request, 0) !== true) {
    throw new RuntimeException('Начало списка недоступно');
}
$first = cubrid_fetch_row($request);

В предпросмотре каталога это сохраняет Кабель в полном списке. Без перехода второй fetch увидел бы Зажим. Если предпросмотр вообще не нужен, проще не делать лишнего первого fetch: курсор не требуется перематывать после каждой строки.

Применение 2: перейти к целому ряду после чтения отдельных ячеек

// result() раньше читал ячейки в произвольных строках.
if (cubrid_data_seek($request, 0) !== true) {
    throw new RuntimeException('Строка отчёта недоступна');
}
$row = cubrid_fetch_array($request, CUBRID_ASSOC);

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

Нужно определить порядок ещё в SQL: без ORDER BY «первая строка» не является устойчивой бизнес-позицией. data_seek не делает ORDER BY, LIMIT или повторную выборку актуальных изменений. Для большой таблицы используйте серверную страницу и устойчивый ключ сортировки. Не рассчитывайте, что старый request останется пригоден после close_request, повторного execute или другой границы его жизненного цикла. Отличающиеся аргументы относительного перемещения описаны в cubrid_move_cursor.

• PHP Manual: cubrid_data_seek
• Native CUBRID 11.2.0.0002: точная реализация
• CUBRID: CCI и результаты запросов

PECL CUBRID >= 8.3.0; отдельное согласование версий PHP/CCI/сервера. · cubrid

cubrid_move_cursor(resource $req_identifier, int $offset, int $origin = CUBRID_CURSOR_CURRENT): bool

Переместить курсор относительно начала, текущей позиции или конца результата.

Базовая запись

cubrid_move_cursor(resource $req_identifier, int $offset, int $origin = CUBRID_CURSOR_CURRENT): bool

В справочной записи resource — открытый request успешно выполненного SELECT, а не соединение $db и не PHP-массив. Знак | перечисляет варианты возврата; это не выполняемая декларация PHP 7.4. Все функции этой страницы представлены в PHP Manual как PECL CUBRID >= 8.3.0. Совместимость PHP, расширения, CCI и сервера проверяют отдельно; закреплённый учебный профиль описан во введении.

Применение 1: крайние позиции ограниченного отчёта

if (cubrid_move_cursor($request, 1, CUBRID_CURSOR_LAST) !== true) {
    throw new RuntimeException('Последняя позиция недоступна');
}
$last = cubrid_fetch_row($request); // ["90", "Коробка"] в нашем отчёте.

В списке трёх товаров крайние позиции известны благодаря ORDER BY id и LIMIT 3. Этот приём подходит для повторного просмотра уже полученного малого отчёта, а не для запроса последнего товара всей базы: последнюю запись базы лучше выбрать отдельным ORDER BY ... DESC LIMIT 1.

Применение 2: снова прочитать только что показанную строку

// Успешный fetch первой строки уже передвинул курсор ко второй.
if (cubrid_move_cursor($request, -1, CUBRID_CURSOR_CURRENT) !== true) {
    throw new RuntimeException('Предыдущая позиция недоступна');
}
$sameAgain = cubrid_fetch_row($request); // Снова первая строка.

Это полезно для повторного форматирования одной строки в пределах той же выборки. Не вычитайте 1 вслепую до первого чтения: позиция должна быть известна. Самостоятельный пример показывает соседний случай CURRENT,0: после первого fetch он читает уже Зажим. В отдельной подготовке закреплённого профиля CURRENT,-1 после fetch действительно повторяет только что прочитанную строку.

На исторической странице PHP Manual есть текст о возврате CUBRID_NO_MORE_DATA при выходе за диапазон, хотя сигнатура и раздел возвратов указывают bool. В 11.2.0.0002 исходник вызывает cci_cursor и превращает отрицательный результат в false с диагностикой; подготовка подтвердила именно false/-20005, а не специальное целое значение. Не сравнивайте результат с выдуманной успешной «пустой строкой». После неудачи выберите допустимую позицию явно или завершите чтение. Курсор не переносится между разными request.

Если нужна абсолютная позиция от нуля, используйте cubrid_data_seek: другой отсчёт: первая строка задаётся 0, а не сочетанием FIRST и 1. Не переносите число offset между двумя API без изменения его смысла.

• PHP Manual: cubrid_move_cursor
• Native CUBRID 11.2.0.0002: точная реализация
• CUBRID: CCI и результаты запросов

PECL CUBRID >= 8.3.0; отдельное согласование версий PHP/CCI/сервера. · cubrid

cubrid_result(resource $result, int $row, int|string $field = 0): string|null|false

Получить одну конкретную ячейку небольшого результата.

Базовая запись

cubrid_result(resource $result, int $row, int|string $field = 0): string|null|false

В справочной записи resource — открытый request успешно выполненного SELECT, а не соединение $db и не PHP-массив. Знак | перечисляет варианты возврата; это не выполняемая декларация PHP 7.4. Все функции этой страницы представлены в PHP Manual как PECL CUBRID >= 8.3.0. Совместимость PHP, расширения, CCI и сервера проверяют отдельно; закреплённый учебный профиль описан во введении.

Когда результат содержит AS product_label, обращаться нужно к product_label. Для соединений таблиц не полагайтесь на одинаковое title из двух источников: явные разные aliases проще переносить и проверять. Если выбирается table.field, используйте фактическое имя источника/поля метаданных, а не произвольный текст пользователя. Эта функция не интерполирует название поля в новый SQL, но всё равно нуждается в осмысленном разрешённом поле отчёта.

Применение 1: название для шапки малого отчёта

$title = cubrid_result($request, 0, 'product_label');
if ($title === false) { throw new RuntimeException('Название недоступно'); }
echo $title === null ? 'Без названия' : $title;

В табличном отчёте получается Кабель. Третий аргумент можно заменить позицией 1 только при известном SELECT id,title AS product_label,qty,note. По умолчанию вернулся бы id первого столбца — строка "10", а не название.

Применение 2: решение по отсутствующему примечанию

$note = cubrid_result($request, 0, 'note');
if ($note === false) { throw new RuntimeException('Примечание не прочитано'); }
$caption = $note === null ? 'Не заполнено' : ($note === '' ? 'Пустой текст' : $note);

Для второй строки того же примера note равно "", поэтому это «Пустой текст», а первая строка получает «Не заполнено». Ноль qty надо обрабатывать как ноль, не как отказ. Такое различение важно при редактировании формы: «не задано» и «очистить поле» могут быть разными действиями.

Обращение меняет общий курсор. В проверенной версии драйвера после result($r,1,...) следующий fetch читает ту же вторую строку, а не третью; последовательный цикл лучше начинать явным data_seek. Не используйте result в двойном цикле всех строк и столбцов там, где достаточно одного fetch на ряд. Если пользователю нужен товар id90, запрос WHERE id=? надёжнее поиска «строки 90». Отсутствующая строка в проверенном профиле даёт false/code0, неизвестное поле — false/-20013. Сам null ошибкой не является.

Когда нужны все поля одного товара, удобнее прочитать целую именованную строку. После обращений к разным ячейкам сначала задайте известную позицию через cubrid_data_seek, затем выполните один fetch; так имена полей и текущая строка остаются согласованными.

• PHP Manual: cubrid_result
• Native CUBRID 11.2.0.0002: точная реализация
• CUBRID: CCI и результаты запросов

PECL CUBRID >= 8.3.0; отдельное согласование версий PHP/CCI/сервера. · cubrid

cubrid_fetch_lengths(resource $result): array|false

Измерить байтовые длины полей только что прочитанной строки.

Базовая запись

cubrid_fetch_lengths(resource $result): array|false

В справочной записи resource — открытый request успешно выполненного SELECT, а не соединение $db и не PHP-массив. Знак | перечисляет варианты возврата; это не выполняемая декларация PHP 7.4. Все функции этой страницы представлены в PHP Manual как PECL CUBRID >= 8.3.0. Совместимость PHP, расширения, CCI и сервера проверяют отдельно; закреплённый учебный профиль описан во введении.

Обычные текстовые значения в UTF-8 измеряются в байтах переданной строки. Это не предел VARCHAR, не число записей и не размер страницы хранения. Для числового значения "1200" измеряется представление в четыре байта, а не размер SQL INTEGER в памяти. NULL и пустой текст в проверенном профиле оба дают длину 0, поэтому длина не заменяет проверку самого значения.

Применение 1: лимит в байтах внешней системы

$row = cubrid_fetch_row($request);
if (is_array($row)) {
    $sizes = cubrid_fetch_lengths($request);
    if ($sizes === false) { throw new RuntimeException('Длины недоступны'); }
    $accepted = $sizes[1] <= 10;
    // Кабель: 12 байт → false; CABLE: 5 байт → true.
}

В полном сценарии обмена исходные названия сохраняются. Неподходящее значение направляется на исправление; побайтовое отрезание русского слова может повредить UTF-8 и не объяснит оператору, что произошло. Если правило задано в символах, нужен инструмент для соответствующей единицы, а не этот байтовый массив.

Применение 2: диагностика неожиданно большого текстового поля

$row = cubrid_fetch_array($request, CUBRID_ASSOC);
if (is_array($row)) {
    $sizes = cubrid_fetch_lengths($request);
    if ($sizes === false) { throw new RuntimeException('Размеры неизвестны'); }
    // SELECT sku,title,qty,note: note имеет позицию 3.
    $noteBytes = $sizes[3];
    $isAbsent = $row['note'] === null;
}

Именованный доступ к note не меняет числовой индекс массива длин. В той же проверке данных обмена null и "" имеют по 0 байт, но isAbsent отличает их. В журнале можно сохранить размер и признак отсутствия, не копируя чувствительное содержимое; это полезнее предположения «VARCHAR(160) означает, что в каждой записи 160 байт». Максимальная ширина разобрана отдельно в cubrid_field_len.

В 11.2.0.0002 до первого успешного fetch массив длин может быть выделен, но ещё не заполнен: отсутствие false не доказывает достоверность значений. Эта опасная последовательность не используется в примерах. После EOF память текущих длин очищается, наблюдён false/-30003. После data_seek сначала прочитайте новую строку и лишь затем измеряйте её; результат cubrid_result не следует подменять успешным обычным fetch для этого договора. Для BLOB/CLOB PHP Manual прямо указывает cubrid_lob_size. Размер полного CSV/JSON с кавычками, разделителями и кодированием измеряйте после сериализации отдельно.

• PHP Manual: cubrid_fetch_lengths
• Native CUBRID 11.2.0.0002: точная реализация
• CUBRID: CCI и результаты запросов