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

PECL CUBRID >= 8.3.1; профиль PHP согласуется отдельно. · cubrid

cubrid_fetch_field(resource $result, int $field_offset = 0): object|false

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

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

cubrid_fetch_field(resource $result, int $field_offset = 0): object|false

Сигнатура справочная, не исполняемая строка PHP 7.4. resource — request запроса native cubrid; | перечисляет возможные результаты. Функция доступна с PECL CUBRID 8.3.1. Это версия расширения, не требование установить PHP 8.3.1. Отдельный лабораторный профиль и запуск приведены в README полных программ.

Несмотря на запись = 0 в краткой сигнатуре, пропуск аргумента имеет отдельный смысл: берётся следующее ещё не полученное поле. Явный индекс 0 выбирает первое поле и в закреплённом драйвере устанавливает следующую позицию на 1. Не считайте пропуск аргумента неизменным повтором первого столбца.

Применение 1: подсказка по выбранной колонке

$field = cubrid_fetch_field($request, 1);
if ($field === false) { throw new RuntimeException('Нет описания поля'); }
echo htmlspecialchars($field->name, ENT_QUOTES, 'UTF-8');
echo ' / ', htmlspecialchars($field->type, ENT_QUOTES, 'UTF-8');

Для SELECT sku,title,qty получится title / varchar. Полный паспорт экспорта добавляет отдельную field_len=120 и реальную строку Кабель / 0. Объект метаданных не читается вместо товара: за товаром обращаются отдельным fetch строки.

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

$count = cubrid_num_fields($request);
if ($count === false || $count < 0) { throw new RuntimeException('Нет количества полей'); }
$fields = [];
for ($i = 0; $i < $count; $i++) {
    $field = cubrid_fetch_field($request, $i);
    if ($field === false) { throw new RuntimeException('Нет описания'); }
    $fields[] = get_object_vars($field);
}

Сохранённый массив можно использовать в шапке таблицы и в диагностике формата без борьбы двух компонентов за общий указатель метаданных. Пример указателя демонстрирует, что явный и неявный fetch_field связаны, а товарный курсор независим. Обычный конец списка даёт false без ошибки, неверный явный индекс — false с предупреждением.

Не восстанавливайте полную схему базы из этого объекта. В подготовке SELECT id AS item_id сохранил not_null, но не выдал primary_key/unique_key, хотя исходный id был PRIMARY KEY. Наличие полезных метаданных не означает полноту DDL. Для правил ввода используйте явную политику приложения, для полной схемы — соответствующий каталог базы. Рядом cubrid_field_len, cubrid_field_flags и cubrid_field_seek.

• PHP Manual: cubrid_fetch_field
• Native CUBRID 11.2.0.0002

PECL CUBRID >= 8.3.0; профиль PHP согласуется отдельно. · cubrid

cubrid_field_flags(resource $result, int $field_offset): string|int|false

Прочитать признаки ограничения и индекса, не подменяя ими правила приложения.

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

cubrid_field_flags(resource $result, int $field_offset): string|int|false

Сигнатура справочная, не исполняемая строка PHP 7.4. resource — request запроса native cubrid; | перечисляет возможные результаты. Функция доступна с PECL CUBRID 8.3.0. Это версия расширения, не требование установить PHP 8.3.0. Отдельный лабораторный профиль и запуск приведены в README полных программ.

Применение 1: подсказка редактору об обязательности хранения

$flags = cubrid_field_flags($request, 3); // qty в выбранном списке
if (!is_string($flags)) { throw new RuntimeException('Флаги не прочитаны'); }
$tokens = $flags === '' ? [] : explode(' ', $flags);
$notNull = in_array('not_null', $tokens, true);
echo $notNull ? 'SQL NULL запрещён' : 'SQL NULL допустим';

В правилах карточки qty имеет NOT NULL, но 0 принимается. Пустое название отсекается отдельным требованием публикации, хотя схема хранения позволяет черновик. Флаг не превращает HTML required в полную серверную проверку и не определяет права редактирования.

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

$flags = cubrid_field_flags($request, 0); // sku
if (!is_string($flags)) { throw new RuntimeException('Нет описания sku'); }
$isUnique = in_array('unique_key', explode(' ', $flags), true);
echo $isUnique ? 'Повтор артикула ограничен схемой' : 'Признак не сообщён';

Паспорт экспорта получает unique_key для обычного sku. Это полезная подсказка до импорта, но фактическая вставка всё равно проверяет результат ограничения. Из отсутствия флага нельзя выводить отсутствие ограничения у исходной таблицы: AS/выражения и способ получения метаданных имеют значение.

Это строковые слова, а не числа для побитового &. Порядок слов не должен быть бизнес-условием: ищите отдельный токен. При отказе сначала сохраните код и сообщение, затем закрывайте request. Для nullable/ключей объекта cubrid_fetch_field отдельно учтите известные ограничения primary_key/multiple_key. Флаги не заменяют сведения CHECK, список разрешённых статусов, диапазон остатков или защиту от параллельных изменений.

• PHP Manual: cubrid_field_flags
• Native CUBRID 11.2.0.0002

PECL CUBRID >= 8.3.0; профиль PHP согласуется отдельно. · cubrid

cubrid_field_len(resource $result, int $field_offset): int|false

Узнать типовую ширину поля отдельно от длины конкретного значения.

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

cubrid_field_len(resource $result, int $field_offset): int|false

Сигнатура справочная, не исполняемая строка PHP 7.4. resource — request запроса native cubrid; | перечисляет возможные результаты. Функция доступна с PECL CUBRID 8.3.0. Это версия расширения, не требование установить PHP 8.3.0. Отдельный лабораторный профиль и запуск приведены в README полных программ.

Для VARCHAR драйвер берёт precision описания: в нашей схеме title даёт 120. Для INT используется типовая текстовая ширина 11, хотя сам INTEGER хранится в 4 байтах и имеет собственный диапазон. Для NUMERIC закреплённая реализация прибавляет 2 к precision на знак и разделитель; в подготовке NUMERIC(10,2) дал 12. Для коллекционных типов используется внутренняя граница представления набора. Поэтому число нельзя всегда называть байтами памяти либо максимальным допустимым значением.

Применение 1: описать ожидаемую ширину экспортного поля

$name = cubrid_field_name($request, 1);
$type = cubrid_field_type($request, 1);
$width = cubrid_field_len($request, 1);
if (!is_string($name) || !is_string($type) || $width === false) {
    throw new RuntimeException('Нет описания ширины');
}
echo $name, ' / ', $type, ' / ', $width; // title / varchar / 120

Такой паспорт помогает согласовать поле с принимающей системой. Он не доказывает, что все текущие названия имеют 120 знаков. Самостоятельный пример показывает отдельные значения артикула, названия и нулевого остатка рядом с описанием.

Применение 2: разобрать расхождение ширины и реальных байтов

$declaredWidth = cubrid_field_len($request, 2); // title
$row = cubrid_fetch_assoc($request);
if ($declaredWidth === false || !is_array($row)) {
    throw new RuntimeException('Нет названия или описания');
}
echo 'Ширина поля: ', $declaredWidth, "\n";
echo 'Байты значения: ', strlen($row['title']), "\n";

В сценарии карточки выход — 120 и 12 для слова Кабель. VARCHAR задаёт символьную вместимость схемы; strlen PHP измеряет байты конкретной строки UTF-8. Для длины текущих полученных полей также существует cubrid_fetch_lengths. Не делите любое число метаданных на 2, 3 или 4 ради угаданной кодировки.

Не устанавливайте qty <= field_len(qty): 11 не является ограничением количества товаров. Не переносите значение в HTML maxlength без понимания типа и символьной проверки; диапазоны и требования задаются отдельно. Свойство fetch_field.max_length в этом драйвере имеет другое фактическое поведение — всегда 0 — и не заменяет функцию. Для полного паспорта используйте cubrid_field_type вместе с описанием схемы.

• PHP Manual: cubrid_field_len
• Native CUBRID 11.2.0.0002

PECL CUBRID >= 8.3.0; профиль PHP согласуется отдельно. · cubrid

cubrid_field_name(resource $result, int $field_offset): string|false

Прочитать имя или псевдоним выбранной позиции SELECT.

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

cubrid_field_name(resource $result, int $field_offset): string|false

Сигнатура справочная, не исполняемая строка PHP 7.4. resource — request запроса native cubrid; | перечисляет возможные результаты. Функция доступна с PECL CUBRID 8.3.0. Это версия расширения, не требование установить PHP 8.3.0. Отдельный лабораторный профиль и запуск приведены в README полных программ.

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

$count = cubrid_num_fields($request);
if ($count === false || $count < 0) { throw new RuntimeException('Нет полей'); }
$headers = [];
for ($i = 0; $i < $count; $i++) {
    $name = cubrid_field_name($request, $i);
    if (!is_string($name)) { throw new RuntimeException('Имя не прочитано'); }
    $headers[] = $name;
}

В каталоге полей это sku, title, qty в порядке будущей записи. Индекс относится к списку SELECT, а не к постоянному номеру колонки в CREATE TABLE. Перестановка SELECT меняет эти позиции. Для всех имён сразу можно использовать cubrid_column_names.

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

// SELECT title AS display_title, qty AS available FROM products ...
$label = cubrid_field_name($request, 0);
if ($label !== 'display_title') {
    throw new RuntimeException('Формат карточки изменился');
}
$item = cubrid_fetch_assoc($request);
if (!is_array($item)) { throw new RuntimeException('Нет карточки'); }
echo htmlspecialchars($item[$label], ENT_QUOTES, 'UTF-8');

Происхождение полей показывает display_title со значением Кабель и отдельно известное приложению исходное имя title. Функция не сообщает mysqli orgname и не разбирает SQL обратно. У выражения имя может быть его AS; поэтому читабельные уникальные псевдонимы лучше неоднозначных ключей JOIN.

Метаданные не делают произвольные имена от посетителя безопасными SQL-идентификаторами. Структуру запроса выбирают по разрешённой карте, значения связывают через bind. В исходнике 11.2.0.0002 также имеется ветка -1 для не-SELECT после проверки индекса, хотя краткий раздел возвратов страницы перечисляет только string/false. Мы проверяем is_string и применяем функцию к известному SELECT, не к UPDATE или закрытому request.

• PHP Manual: cubrid_field_name
• Native CUBRID 11.2.0.0002

PECL CUBRID >= 8.3.0; профиль PHP согласуется отдельно. · cubrid

cubrid_field_seek(resource $result, int $field_offset = 0): bool

Выбрать следующее описание колонки без перемещения товарных строк.

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

cubrid_field_seek(resource $result, int $field_offset = 0): bool

Сигнатура справочная, не исполняемая строка PHP 7.4. resource — request запроса native cubrid; | перечисляет возможные результаты. Функция доступна с PECL CUBRID 8.3.0. Это версия расширения, не требование установить PHP 8.3.0. Отдельный лабораторный профиль и запуск приведены в README полных программ.

Меняется указатель описаний полей. Товарные строки не перемещаются. Значение по умолчанию 0 возвращает описание к первому полю. Для трёх колонок индекс 3 уже недопустим, даже если в таблице тысячи товарных строк.

Применение 1: подсказка по выбранному столбцу

if (cubrid_field_seek($request, 1) !== true) {
    throw new RuntimeException('Второго поля нет');
}
$field = cubrid_fetch_field($request);
if ($field === false) { throw new RuntimeException('Описание не прочитано'); }
echo $field->name; // title для SELECT sku,title,qty

В полном сценарии после перехода к позиции 2 получается qty. Это полезно, когда компонент показывает справку по выбранной пользователем колонке: индекс предварительно сверяется с разрешённым диапазоном num_fields.

Применение 2: повторный заголовок после обхода данных

if (cubrid_field_seek($request) !== true) {
    throw new RuntimeException('Нет начального поля');
}
$first = cubrid_fetch_field($request);
if ($first === false) { throw new RuntimeException('Нет описания'); }
// first описывает sku; товарный курсор остаётся на прежнем месте.

Программа читает Кабель, работает с описаниями, затем читает Клемму. Это подтверждает независимость указателей. У пустого SELECT также можно прочитать описание title: отсутствие товаров не означает отсутствие колонок. Для перемещения строк используйте cubrid_data_seek или cubrid_move_cursor, учитывая их собственные правила.

Явный fetch_field(request,0) сам меняет следующий индекс на 1. Если несколько функций должны независимо перечитывать описания, сохраните их один раз в PHP-массив или передавайте владение request явно. Ошибочный offset в примере даёт false с кодом -20013/facility3, затем допустимый seek восстанавливает позицию. Проверять закрытый ресурс таким вызовом не требуется и небезопасно для старого расширения.

• PHP Manual: cubrid_field_seek
• Native CUBRID 11.2.0.0002

PECL CUBRID >= 8.3.0; профиль PHP согласуется отдельно. · cubrid

cubrid_field_table(resource $result, int $field_offset): string|int|false

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

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

cubrid_field_table(resource $result, int $field_offset): string|int|false

Сигнатура справочная, не исполняемая строка PHP 7.4. resource — request запроса native cubrid; | перечисляет возможные результаты. Функция доступна с PECL CUBRID 8.3.0. Это версия расширения, не требование установить PHP 8.3.0. Отдельный лабораторный профиль и запуск приведены в README полных программ.

Применение 1: объяснить происхождение поля отчёта

$table = cubrid_field_table($request, 1);
$name = cubrid_field_name($request, 1);
if (!is_string($table) || !is_string($name)) {
    throw new RuntimeException('Происхождение не прочитано');
}
echo htmlspecialchars($name, ENT_QUOTES, 'UTF-8'), ' / ';
echo $table === '' ? 'выражение без таблицы в метаданных'
    : htmlspecialchars($table, ENT_QUOTES, 'UTF-8');

В проекте редактора alias display_title по-прежнему связан с собственной таблицей, а вычисленная double_price не сообщает таблицу. Пользователь видит Кабель и 25800, а разработчик понимает, почему эти два поля нельзя автоматически редактировать одинаково.

Применение 2: диагностический перечень источников JOIN

$count = cubrid_num_fields($request);
if ($count === false || $count < 0) { throw new RuntimeException('Нет полей'); }
$sources = [];
for ($i = 0; $i < $count; $i++) {
    $origin = cubrid_field_table($request, $i);
    if (!is_string($origin)) { throw new RuntimeException('Нет источника'); }
    $sources[$i] = $origin;
}

Такой перечень помогает закрытому административному инструменту объяснить сложный SELECT. Он не превращается в автоматический UPDATE: две роли одной таблицы в self-JOIN могут сообщить одинаковое физическое имя, а вычисления и представления требуют отдельного договора. Для отображения берите cubrid_field_name, для разрешённых правок — собственную карту полей и права пользователя.

Пустой источник, false и -1 различаются строго. Имя базы/таблицы не является личным названием товара; на публичном экране обычно показывают подпись приложения, а технические имена оставляют диагностике. Совместимое имя функции с MySQL не гарантирует свойства orgtable/orgname из другого API. Ни table, ни flags не доказывают, что конкретный пользователь имеет право писать в исходную таблицу.

• PHP Manual: cubrid_field_table
• Native CUBRID 11.2.0.0002

PECL CUBRID >= 8.3.0; профиль PHP согласуется отдельно. · cubrid

cubrid_field_type(resource $result, int $field_offset): string|int|false

Узнать SQL-тип конкретного поля для понятного описания или формата.

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

cubrid_field_type(resource $result, int $field_offset): string|int|false

Сигнатура справочная, не исполняемая строка PHP 7.4. resource — request запроса native cubrid; | перечисляет возможные результаты. Функция доступна с PECL CUBRID 8.3.0. Это версия расширения, не требование установить PHP 8.3.0. Отдельный лабораторный профиль и запуск приведены в README полных программ.

Краткое описание PHP Manual приводит общие слова int/real/string, но его же пример и закреплённый type2str используют SQL-имена вроде char/varchar/integer. Выводите фактическую строку типа и сверяйте договор своего профиля. Это не gettype уже полученного PHP-значения и не команда преобразования.

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

$type = cubrid_field_type($request, 2); // qty в SELECT sku,title,qty
if (!is_string($type)) { throw new RuntimeException('Нет SQL-типа'); }
echo 'Остаток хранится как ', $type; // integer

Паспорт трёх полей показывает varchar для артикула и названия, integer для остатка. Товарная строка при этом возвращает qty как PHP-строку "0". Тип SQL позволяет осмысленно выбрать формат, но не оправдывает преобразование всех числоподобных артикулов в int.

Применение 2: проверить ожидаемый контракт цены

$type = cubrid_field_type($request, $pricePosition);
if ($type !== 'integer') {
    throw new RuntimeException('В этом отчёте ожидается целая цена в копейках');
}
// Форматирование выбирается по согласованной модели денег, не по одному имени поля.

В расчёте двойной цены источник price_cents и выражение умножения намеренно ограничены небольшими целыми копейками. Для DECIMAL/numeric нужно сохранить точность, а не механически перейти на float. Вычисление или CAST может дать тип, отличный от исходного поля; метаданные относятся к результату.

Закреплённый драйвер знает также smallint/bigint, float/double, monetary, date/time/timestamp/datetime, bit/varbit, nchar/varnchar, blob/clob, object, enum и коллекционные формы set/multiset/sequence. Само распознавание типа не реализует обработку LOB или коллекций за приложение. Длину интерпретируют вместе с типом через cubrid_field_len, а все типы сразу доступны через cubrid_column_types.

• PHP Manual: cubrid_field_type
• Native CUBRID 11.2.0.0002

PECL CUBRID >= 8.3.0; профиль PHP согласуется отдельно. · cubrid

cubrid_num_fields(resource $result): int|false

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

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

cubrid_num_fields(resource $result): int|false

Сигнатура справочная, не исполняемая строка PHP 7.4. resource — request запроса native cubrid; | перечисляет возможные результаты. Функция доступна с PECL CUBRID 8.3.0. Это версия расширения, не требование установить PHP 8.3.0. Отдельный лабораторный профиль и запуск приведены в README полных программ.

Применение 1: ограничить обход паспорта полей

$count = cubrid_num_fields($request);
if ($count === false || $count < 0) {
    throw new RuntimeException('Нет полей SELECT');
}
for ($i = 0; $i < $count; $i++) {
    $name = cubrid_field_name($request, $i);
    if (!is_string($name)) { throw new RuntimeException('Имя не прочитано'); }
    echo $i, ': ', $name, "\n";
}

Для экспортного списка выход содержит 0: sku, 1: title, 2: qty. Условие i < count не допускает лишнюю позицию 3. Если передали prepare, запрос должен относиться к корректному SELECT с доступным описанием; полный проект использует явно выполненный запрос.

Применение 2: сохранить структуру пустого экрана

$count = cubrid_num_fields($emptyRequest);
if ($count === false || $count < 0) {
    throw new RuntimeException('Нет описания результата');
}
echo 'Столбцов в пустом списке: ', $count; // 3
// Отсутствие товарных строк проверяется отдельно через fetch или num_rows.

Пустая выборка оставляет sku/title/qty доступными для заголовка, даже когда ни один id не подходит. Описание можно показать без фиктивной товарной строки. Указать ширину исходной таблицы 7 вместо выбранной ширины 3 было бы ошибкой.

Соседний cubrid_num_cols решает похожую задачу, но их ошибочные возвраты нельзя механически уравнивать: в закреплённом исходнике num_fields возвращает -1 для не-SELECT, num_cols — false. Оба результата необходимо проверять. Размер страницы относится к cubrid_num_rows, а число всех подходящих записей — к отдельному COUNT в SQL. Наличие полей не означает, что SELECT нашёл товары.

• PHP Manual: cubrid_num_fields
• Native CUBRID 11.2.0.0002