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

PECL CUBRID >= 8.3.0; совместимость PHP и драйвера проверяется отдельно. · cubrid

cubrid_fetch(resource $result, int $type = CUBRID_BOTH): mixed

После SQL нужно превратить конкретную строку в данные для экрана или файла. Кабель с остатком 0 может быть доступен по имени available, по позиции 2 или как свойство объекта. Меняется форма PHP-значения, а не число товаров и не содержимое базы.

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

cubrid_fetch(resource $result, int $type = CUBRID_BOTH): mixed

Это справочная сигнатура: resource означает ресурс расширения, а | перечисляет возможные виды результата. Её не нужно вставлять в example.php. Все шесть функций описаны с PECL CUBRID 8.3.0; это номер расширения, не требование PHP 8.3. Рабочие проекты используют отдельный профиль native CUBRID из README, без изменения PHP действующего сайта.

Применение 1: карточка с нулевым остатком

$item = cubrid_fetch($request, CUBRID_ASSOC);
$error = cubrid_error_code(); // до другой операции драйвера
if ($item === null || $error !== 0) {
    throw new RuntimeException('Карточка не прочитана');
}
if ($item === false) {
    echo 'Товар не найден';
} else {
    echo htmlspecialchars($item['item_title'], ENT_QUOTES, 'UTF-8');
    echo ' / остаток ', $item['available'];
}

Фрагмент предполагает SELECT title AS item_title, qty AS available ... WHERE id = ?. В первом проекте результат — Кабель / остаток 0. Проверка empty($item["available"]) здесь неверна как проверка существования товара: нулевой остаток является полезным значением. Для объекта ключи должны подходить в качестве имён свойств PHP; выражения вроде COUNT(*) снабжайте явным AS total.

Применение 2: строка для позиционного CSV

$fields = cubrid_fetch($request, CUBRID_NUM);
$error = cubrid_error_code();
if ($fields === null || $error !== 0) {
    throw new RuntimeException('Выгрузка прочитана не полностью');
}
if ($fields !== false) {
    fputcsv($stream, $fields, ';', '"', '');
}

Поток $stream уже открыт, а SELECT перечисляет только экспортируемые поля. Полный проект CSV формирует строку CAB-166;Кабель;12900;0 и сохраняет порядок четырёх полей. ASSOC удобен для адресного шаблона, NUM — для сопоставления с заголовками; BOTH без специального выбора ключей удвоит поля CSV.

Значения имён в JOIN могут совпасть. Записывайте уникальные AS, например item_title и category_title, иначе один ассоциативный ключ не представит два различных столбца. В закреплённом профиле INT приходит PHP-строкой; автоматическая типизация всего массива не является контрактом fetch. Отсутствие примечания проверяйте через array_key_exists либо property_exists, когда нужно отличить существующее поле с null от отсутствующего.

Документация различает false и null, но неправильный вид request нельзя диагностировать только этими значениями. В подготовке драйвер 11.2.0.0002 вернул false и код 0 при fetch для UPDATE, хотя строк там вообще не предполагалось. Поэтому функция применяется к известному успешному SELECT; при false/null сразу сохраняется код ошибки. Для обычного конца таких SELECT наблюдён false с кодом 0. Не вызывайте API на уже закрытом ресурсе ради проверки поведения. После чтения: cubrid_free_result и cubrid_close_request.

• PHP Manual: cubrid_fetch
• Исходник CUBRID 11.2.0.0002

PECL CUBRID >= 8.3.0; совместимость PHP и драйвера проверяется отдельно. · cubrid

cubrid_column_names(resource $req_identifier): array|false

Таблица на экране и выгрузка должны договориться, что означает каждое поле. Функция возвращает имена именно текущего SELECT, включая AS. Например, статья каталога имеет заголовки article, label, unit_cents, in_stock в точном порядке значений строки.

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

cubrid_column_names(resource $req_identifier): array|false

Это справочная сигнатура: resource означает ресурс расширения, а | перечисляет возможные виды результата. Её не нужно вставлять в example.php. Все шесть функций описаны с PECL CUBRID 8.3.0; это номер расширения, не требование PHP 8.3. Рабочие проекты используют отдельный профиль native CUBRID из README, без изменения PHP действующего сайта.

Применение 1: заголовок HTML-таблицы

$names = cubrid_column_names($request);
if ($names === false) { throw new RuntimeException('Нет заголовков'); }
echo '<tr>';
foreach ($names as $name) {
    echo '<th>', htmlspecialchars($name, ENT_QUOTES, 'UTF-8'), '</th>';
}
echo '</tr>';

Предварительный SELECT явно задаёт доступные экрану столбцы; этот цикл не выбирает все поля таблицы. Даже если фильтр не нашёл товары, названия полей результата остаются полезны: интерфейс может показать структуру и сообщение «ничего не найдено». Пустая страница отдельно показывает ноль строк при трёх полях.

Применение 2: защитить порядок обменного файла

$names = cubrid_column_names($request);
$required = ['article', 'label', 'unit_cents', 'in_stock'];
if ($names !== $required) {
    throw new RuntimeException('SELECT не соответствует формату выгрузки');
}
fputcsv($stream, $names, ';', '"', '');
// Следующие записи читаются с CUBRID_NUM в том же порядке.

В полном проекте получается заголовок article;label;unit_cents;in_stock, затем две конкретные товарные строки. Сравнение имён защищает от незаметной перестановки цены и остатка при изменении SELECT. Это контракт нашего формата, а не проверка всех свойств таблицы.

AS меняет имя поля результата, не DDL таблицы. При JOIN выбирайте явные уникальные псевдонимы: повторяющиеся id не станут уникальными сами. Имена метаданных не являются разрешением вставлять их из внешнего запроса в произвольный SQL. Если пользователь выбирает сортировку или колонки, сопоставляйте выбор со своим разрешённым набором. Для SQL-типа берите cubrid_column_types, для количества — cubrid_num_cols; они описывают те же позиции.

• PHP Manual: cubrid_column_names
• Исходник CUBRID 11.2.0.0002

PECL CUBRID >= 8.3.0; совместимость PHP и драйвера проверяется отдельно. · cubrid

cubrid_column_types(resource $req_identifier): array|false

В отчёте цена, остаток и артикул выглядят как текст, но имеют разный смысл. Метаданные позволяют понять SQL-тип выбранных полей и проверить формат выгрузки. Они не превращают каждую строку PHP в автоматически правильное число.

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

cubrid_column_types(resource $req_identifier): array|false

Это справочная сигнатура: resource означает ресурс расширения, а | перечисляет возможные виды результата. Её не нужно вставлять в example.php. Все шесть функций описаны с PECL CUBRID 8.3.0; это номер расширения, не требование PHP 8.3. Рабочие проекты используют отдельный профиль native CUBRID из README, без изменения PHP действующего сайта.

В нашем SELECT получаются varchar, varchar, integer, integer. В закреплённом исходнике также предусмотрены char/nchar/varnchar, bit/varbit, numeric, smallint, monetary, float/double, date/time/timestamp/datetime, bigint, object, blob/clob, enum и записи коллекционных типов. Формат приходит от драйвера. Это не полный паспорт поля: функция не даёт отдельные precision, scale, nullable, значение по умолчанию или ограничения ключа.

Применение 1: форматировать известные поля карточки

$names = cubrid_column_names($request);
$types = cubrid_column_types($request);
if ($names === false || $types === false || count($names) !== count($types)) {
    throw new RuntimeException('Нет описания полей');
}
$position = array_search('in_stock', $names, true);
if ($position === false || $types[$position] !== 'integer') {
    throw new RuntimeException('Остаток должен быть INT');
}
// После получения NUM-строки:
$displayQuantity = (int)$fields[$position];

Здесь cast допустим для ограниченного INT-остатка нашей схемы, включая 0. Для денежного numeric/decimal такой подход нельзя механически заменить на float: точность и масштаб нужно выбрать по задаче. Артикул VARCHAR "0012" остаётся строкой, иначе потеряет ведущие нули. SQL NULL также обрабатывается до форматирования значения, а не превращается в пустое число.

Применение 2: проверить схему строк CSV

$types = cubrid_column_types($request);
$expected = ['varchar', 'varchar', 'integer', 'integer'];
if ($types !== $expected) {
    throw new RuntimeException('Типы выгрузки изменились');
}
// Теперь строки экспортируются без неявной переделки всех значений.

Проект с метаданными показывает одновременно SQL integer и PHP string у нулевого остатка. Проверка сравнивает согласованный формат четырёх столбцов. Она не сертифицирует правильность бизнес-данных и не гарантирует одинаковые строки типов у всех версий расширения.

Не выводите коллекции, LOB и даты через универсальный «всё в строку» без выбранного представления. Для неизвестного типа полезнее явно отказаться от неподдержанного экспорта, чем получить незаметно испорченный файл. Позиции связываются через cubrid_column_names и cubrid_num_cols; данные берутся через cubrid_fetch. Метаданные относятся к выбранным выражениям, поэтому CAST и вычисления SQL могут изменить тип результата относительно исходной колонки.

• PHP Manual: cubrid_column_types
• Исходник CUBRID 11.2.0.0002

PECL CUBRID >= 8.3.0; совместимость PHP и драйвера проверяется отдельно. · cubrid

cubrid_num_cols(resource $result): int|false

Нужно знать, сколько ячеек должно быть в каждой строке отчёта. Функция считает поля результата SELECT: выбор четырёх нужных колонок даёт 4 даже у таблицы с семью колонками. Ноль товаров не отменяет описание выбранных полей.

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

cubrid_num_cols(resource $result): int|false

Это справочная сигнатура: resource означает ресурс расширения, а | перечисляет возможные виды результата. Её не нужно вставлять в example.php. Все шесть функций описаны с PECL CUBRID 8.3.0; это номер расширения, не требование PHP 8.3. Рабочие проекты используют отдельный профиль native CUBRID из README, без изменения PHP действующего сайта.

Применение 1: проверить ширину экспортируемой строки

$width = cubrid_num_cols($request);
if ($width === false || $width !== 4) {
    throw new RuntimeException('Ожидалось четыре поля выгрузки');
}
$fields = cubrid_fetch($request, CUBRID_NUM);
$error = cubrid_error_code();
if ($fields === null || $error !== 0) { throw new RuntimeException('Ошибка чтения'); }
if ($fields !== false && count($fields) !== $width) {
    throw new RuntimeException('Нарушен порядок полей');
}

В проекте CSV это article, label, unit_cents и in_stock. Для BOTH сравнивать count(row) с шириной нельзя: четыре SQL-поля могут дать восемь ключей PHP. Для позиционного формата сознательно выбран NUM.

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

$width = cubrid_num_cols($request);
$count = cubrid_num_rows($request);
if ($width === false || $count === false) {
    throw new RuntimeException('Нет размера результата');
}
if ($count === 0) {
    echo '<tr><td colspan="', $width, '">Товары не найдены</td></tr>';
}

Для синхронного SELECT id, title, qty ... WHERE qty < 0 самостоятельная программа получает три колонки и ноль строк. colspan использует количество выбранных полей, а не число товаров. Заголовки можно получить независимо через cubrid_column_names.

Функция предназначена для SELECT. В подготовке закреплённый драйвер вернул false, код -30002 и facility 4 при передаче request UPDATE. Такая ошибка не означает «в UPDATE ноль колонок»; для количества изменённых строк нужен cubrid_affected_rows. Количество физически объявленных полей таблицы — другая задача метаданных схемы, а не число текущего результата.

• PHP Manual: cubrid_num_cols
• Исходник CUBRID 11.2.0.0002

PECL CUBRID >= 8.3.0; совместимость PHP и драйвера проверяется отдельно. · cubrid

cubrid_num_rows(resource $result): int|false

Подпись «показано 2 из 3» состоит из двух разных чисел. num_rows даёт размер выполненной страницы LIMIT 2; общий размер подходящего каталога вычисляется отдельным COUNT с тем же условием. Так PHP получает только данные текущего экрана.

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

cubrid_num_rows(resource $result): int|false

Это справочная сигнатура: resource означает ресурс расширения, а | перечисляет возможные виды результата. Её не нужно вставлять в example.php. Все шесть функций описаны с PECL CUBRID 8.3.0; это номер расширения, не требование PHP 8.3. Рабочие проекты используют отдельный профиль native CUBRID из README, без изменения PHP действующего сайта.

Применение 1: подписать выбранную страницу

// request: SELECT id, title, qty FROM products
//          WHERE qty > 0 ORDER BY id LIMIT 2
$shown = cubrid_num_rows($request);
if ($shown === false || $shown < 0) {
    throw new RuntimeException('Размер страницы неизвестен');
}
echo 'На этой странице: ', $shown;

Результат полного проекта содержит Розетку и Клемму. Изолента тоже имеет остаток, но не входит в первые две строки ORDER BY id. Получать все товары и затем считать/сортировать их в PHP для этой подписи не нужно.

Применение 2: отличить COUNT-значение от числа его строк

$countRequest = cubrid_execute($db,
    'SELECT COUNT(*) AS total FROM products WHERE qty > 0');
if ($countRequest === false) { throw new RuntimeException('Нет счётчика'); }
try {
    $resultRows = cubrid_num_rows($countRequest); // 1
    $row = cubrid_fetch($countRequest, CUBRID_ASSOC);
    if (!is_array($row)) { throw new RuntimeException('Нет поля total'); }
    $total = (int)$row['total'];                 // 3 в нашем наборе
} finally {
    cubrid_close_request($countRequest);
    $countRequest = null;
}

COUNT(*) здесь не выгружает SELECT *: сервер вычисляет число подходящих строк и отдаёт один результат с total. Даже если total равен 0, агрегат без GROUP BY возвращает одну строку. У COUNT с группировкой строк будет столько, сколько групп; нельзя обобщать наблюдение на все агрегатные запросы.

Сохраните одинаковые условия WHERE и привязанные значения в запросе списка и подсчёта. Два отдельных запроса под конкурентными изменениями не обещают один снимок; для такой гарантии требуется осознанный транзакционный режим. Если интерфейсу нужна только кнопка «ещё», иногда достаточно получить page_size + 1 строку без отдельного общего COUNT.

Версионное различие сохранено явно: официальный PHP Manual описывает -1 для не-SELECT. Закреплённый исходник 11.2.0.0002 вместо этого сообщает ошибку типа SQL и возвращает false. В реальной подготовке UPDATE дал false / -30002 / facility 4. Не стройте обработчик только на сравнении с -1. Для UPDATE используйте cubrid_affected_rows, а для пустого синхронного SELECT проекта наблюдены 0 и нормальный EOF без ошибки.

• PHP Manual: cubrid_num_rows
• Исходник CUBRID 11.2.0.0002

PECL CUBRID >= 8.3.0; совместимость PHP и драйвера проверяется отдельно. · cubrid

cubrid_free_result(resource $req_identifier): bool

Предпросмотр уже не нужен, а подготовленный шаблон ещё пригодится для нового фильтра. Функция освобождает клиентский буфер чтения результата; затем можно явно выполнить следующий запрос. Окончательное закрытие request остаётся отдельной обязанностью.

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

cubrid_free_result(resource $req_identifier): bool

Это справочная сигнатура: resource означает ресурс расширения, а | перечисляет возможные виды результата. Её не нужно вставлять в example.php. Все шесть функций описаны с PECL CUBRID 8.3.0; это номер расширения, не требование PHP 8.3. Рабочие проекты используют отдельный профиль native CUBRID из README, без изменения PHP действующего сайта.

В закреплённом драйвере вызывается cci_fetch_buffer_clear, а сам PHP-ресурс request здесь не удаляется. Это отличается от cubrid_close_request. Наличие живого ресурса само по себе не доказывает пригодность конкретного следующего вызова, поэтому самостоятельный проект проверяет настоящее повторное execute и новую строку.

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

if (cubrid_free_result($request) !== true) {
    throw new RuntimeException('Предыдущий буфер не освобождён');
}
if (!cubrid_bind($request, 1, 5, 'number') ||
    cubrid_execute($request) !== true) {
    throw new RuntimeException('Новый фильтр не выполнен');
}
$item = cubrid_fetch($request, CUBRID_ASSOC);
if (!is_array($item)) { throw new RuntimeException('Нет ожидаемой карточки'); }

Шаблон заранее подготовлен как SELECT id,title,qty ... WHERE qty >= ? ORDER BY id LIMIT 2. Полный сценарий сначала читает Кабель / 0, затем очищает старый буфер, связывает порог 5 и получает Клемму / 7. Сохранённый массив первой карточки остаётся обычным значением PHP. Очистка буфера не редактирует его и не удаляет товар.

Применение 2: закончить экспорт и закрыть запрос

try {
    // Здесь читаются строки известного SELECT и записываются в CSV.
    if (cubrid_free_result($request) !== true) {
        throw new RuntimeException('Буфер экспорта не освобождён');
    }
} finally {
    if (is_resource($request)) {
        cubrid_close_request($request);
        $request = null;
    }
}

Это вариант явного разделения сроков жизни: строки уже преобразованы в файл, буфер больше не нужен, а request окончательно закрывается при выходе. В проекте CSV промежуточный free_result не обязателен: там request сразу закрывается в finally. Не нужно добавлять оба вызова механически в каждый фрагмент ради количества функций.

free_result не равен отмене SQL на сервере, перемотке курсора, закрытию соединения, commit или rollback. После очистки не рассчитывайте продолжить прежнее чтение в конкретной позиции без проверенного контракта; здесь новый bind/execute явно создаёт новый результат. Примеры не измеряют число освобождённых байтов, расход всей серверной памяти или выигрыш времени. Для записей судьба данных определяется транзакцией, а не освобождением fetch-буфера.

• PHP Manual: cubrid_free_result
• Исходник CUBRID 11.2.0.0002