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

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

cubrid_prepare(resource $conn_identifier, string $prepare_stmt, int $option = 0): resource|false

Фильтр каталога должен меняться от запроса пользователя, но текст SELECT остаётся понятным и контролируемым. prepare отделяет этот шаблон от его значений. Результат — ресурс подготовленного запроса: с ним можно связать параметры, выполнить SQL и прочитать найденные строки.

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

cubrid_prepare(resource $conn_identifier, string $prepare_stmt, int $option = 0): resource|false

Это справочная сигнатура, а не строка для выполнения. resource обозначает ресурс расширения; знак | перечисляет возможные виды результата. Метка PECL CUBRID 8.3.0 относится к версии расширения, не к PHP 8.3. Для запуска используется отдельный профиль native CUBRID, описанный в README проектов; основной PHP сайта не меняется.

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

$request = cubrid_prepare($db,
    'SELECT id, title, qty FROM products WHERE sku = ?');
if ($request === false) { throw new RuntimeException('Поиск не подготовлен'); }
try {
    if (!cubrid_bind($request, 1, 'CAB-01', 'string') ||
        cubrid_execute($request) !== true) {
        throw new RuntimeException('Поиск не выполнен');
    }
    $item = cubrid_fetch_assoc($request);
    if ($item === null) { throw new RuntimeException('Ошибка чтения'); }
    // $item === false: артикул не найден; массив: поля товара.
} finally {
    cubrid_close_request($request);
    $request = null;
}

В контекстном фрагменте products уже создана, а $db открыт. CAB-01 передаётся как строковое значение, даже если в нём есть знаки SQL. Первая позиция означает первый ?, а не номер столбца таблицы. Полный проект двух фильтров показывает ту же последовательность с двумя параметрами и видимыми результатами Розетка 8000 / Молоток 25000.

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

$request = cubrid_prepare($db,
    'UPDATE products SET qty = qty - ? WHERE id = ? AND qty >= ?');
if ($request === false) { throw new RuntimeException('Списание не подготовлено'); }
// Маркеры 1 и 3 получают количество, маркер 2 — id товара.
// Выполнение и affected_rows определят, было ли принято списание.

Подготовка сама не уменьшит остаток. Самостоятельное списание передаёт 2/1/2, выполняет запрос и получает остаток 3. Следующая попытка 4/1/4 использует тот же подготовленный ресурс и изменяет 0 строк. Все параметры привязываются заново явно: изменение PHP-переменной само по себе не является вызовом bind.

Маркеры предназначены для значений, а не частей синтаксиса. SELECT ? вернёт переданную величину, а не выберет колонку с таким именем. Для разных столбцов сортировки используйте разрешённое соответствие вроде name → title и price → price_cents; значение посетителя не вставляют напрямую в SQL. Имена собственных таблиц в полных проектах формирует и проверяет лабораторный helper, а не HTTP-параметр.

Подготовка не создаёт таблицу, не проверяет бизнес-правила и не делает запрос автоматически оптимальным. До следующего выполнения дочитайте либо корректно освободите предыдущий результат по правилам драйвера. После cubrid_close_request prepare вызывается заново для нового request. Соседние шаги: cubrid_bind, cubrid_execute, cubrid_fetch_assoc.

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

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

cubrid_bind(resource $req_identifier, int $bind_index, mixed $bind_value, string $bind_value_type = "string"): bool

Название с апострофом, максимальная цена и отсутствие заметки должны попасть в нужные места SQL как данные. bind связывает одно значение с одной позицией уже подготовленного запроса. Он не выполняет команду: для этого нужен execute.

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

cubrid_bind(resource $req_identifier, int $bind_index, mixed $bind_value, string $bind_value_type = "string"): bool

Это справочная сигнатура, а не строка для выполнения. resource обозначает ресурс расширения; знак | перечисляет возможные виды результата. Метка PECL CUBRID 8.3.0 относится к версии расширения, не к PHP 8.3. Для запуска используется отдельный профиль native CUBRID, описанный в README проектов; основной PHP сайта не меняется.

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

В режиме shard документация требует указывать тип параметра. В исходнике 11.2.0.0002 также есть INT, SHORT, BIGINT, DATETIME и другие внутренние соответствия. Не выводите их имена из SQL наугад: например, строка integer встречается в описании метаданных, но не является именем bind в его таблице типов. Проекты используют документированные string/number/null, а общий helper может использовать подтверждённый int для значений PHP int.

Применение 1: категория и цена из фильтра

if (!cubrid_bind($request, 1, 'электрика', 'string')) {
    throw new RuntimeException('Не передана категория');
}
if (!cubrid_bind($request, 2, 10000, 'number')) {
    throw new RuntimeException('Не передана максимальная цена');
}

Для WHERE category = ? AND price_cents <= ? эти вызовы означают категорию «электрика» и предел 10000 копеек. Сама цена 10000 не становится частью текста SQL. Полный фильтр вернёт Розетку за 8000, затем повторит bind с другой категорией и ценой.

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

// Подготовлен UPDATE products SET note = ?, qty = ? WHERE id = ?.
if (!cubrid_bind($request, 1, null, 'null') ||
    !cubrid_bind($request, 2, 0, 'number') ||
    !cubrid_bind($request, 3, 1, 'number')) {
    throw new RuntimeException('Не переданы поля карточки');
}

Первый аргумент-значение отсутствует, второй равен нулю, третий выбирает конкретную запись. Это три разных назначения. В проекте с заметками дополнительно сохраняются пустая строка и четыре буквы NULL; обратное чтение показывает разницу. Если цель — пустая заметка, передают '' с типом string, а не null.

Не добавляйте кавычки или обратные слеши к bind-значению заранее: это изменит сами данные. Проверка допустимой длины, знака, диапазона, прав на карточку и кодировки остаётся отдельным шагом. Bind не защищает HTML-вывод и не интерпретирует оператор IS NULL из строки. Ошибку параметра обрабатывают до cubrid_execute; сохранённый request освобождают через cubrid_close_request.

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

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

cubrid_execute(resource $conn_identifier, string $sql, int $option = 0): resource|false
cubrid_execute(resource $req_identifier, int $option = 0): bool

Команда становится действием только при выполнении: фильтр начинает возвращать строки, UPDATE изменяет подходящие записи. У execute есть два режима. Их важно различать, иначе код попытается читать строку из true вместо ресурса запроса.

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

cubrid_execute(resource $conn_identifier, string $sql, int $option = 0): resource|false
cubrid_execute(resource $req_identifier, int $option = 0): bool

Это справочная сигнатура, а не строка для выполнения. resource обозначает ресурс расширения; знак | перечисляет возможные виды результата. Метка PECL CUBRID 8.3.0 относится к версии расширения, не к PHP 8.3. Для запуска используется отдельный профиль native CUBRID, описанный в README проектов; основной PHP сайта не меняется.

Применение 1: выполнить постоянный SELECT

$request = cubrid_execute($db,
    'SELECT id, title, qty FROM products WHERE id = 1');
if ($request === false) { throw new RuntimeException('Нет результата'); }
try {
    $item = cubrid_fetch_assoc($request);
    if ($item === null) { throw new RuntimeException('Ошибка чтения'); }
    // Здесь массив либо false, если id = 1 отсутствует.
} finally {
    cubrid_close_request($request);
    $request = null;
}

Фрагмент предполагает подготовленные products и $db. Он выбирает три поля одной строки. Если id приходит из формы, перейдите на prepare и bind; ручное добавление id в SQL не требуется. Полный путь от подключения до первой таблицы находится в первое подключение и диагностика.

Применение 2: выполнить подготовленное списание

$executed = cubrid_execute($request);
if ($executed !== true) { throw new RuntimeException('Списание не выполнено'); }
$changed = cubrid_affected_rows($request);
if ($changed === 0) {
    echo 'Ни одна строка не подошла под условие';
} elseif ($changed === 1) {
    echo 'Изменена одна карточка';
} else {
    throw new RuntimeException('Неожиданный результат изменения');
}

Запрос подготовлен как UPDATE с условием достаточного остатка. Во второй попытке полного проекта execute возвращает true, а changed — 0. Следовательно, успешный SQL нельзя приравнивать к принятому заказу. Подтверждение транзакции — отдельный шаг; execute не заменяет выбранную политику commit/rollback.

Опции, несколько команд и границы

При EXEC_QUERY_ALL ошибка в поздней команде не означает автоматический откат уже выполненных ранних команд. Не создавайте пакет произвольного пользовательского SQL и не называйте такой режим транзакцией. Для связанной бизнес-операции задайте явную транзакционную границу и обрабатывайте её отказ отдельно. В этих четырёх проектах ASYNC, OID и наборы нескольких SQL описаны как контракт, но не заявлены реально испытанными сценариями.

У prepare может быть успешный результат, а у execute — отказ из-за ограничений, типов, состояния сервера или отсутствующих bind. Сохраните код и сообщение сразу после отказа, затем освобождайте ресурсы. Повторный execute означает новое выполнение с возможными новыми изменениями: автоматически повторять списание после непонятного сетевого ответа опасно для бизнес-логики. Дальше: cubrid_affected_rows, cubrid_fetch_assoc, cubrid_close_request.

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

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

cubrid_affected_rows(resource $conn_identifier = ?): int|false
cubrid_affected_rows(resource $req_identifier = ?): int|false

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

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

cubrid_affected_rows(resource $conn_identifier = ?): int|false
cubrid_affected_rows(resource $req_identifier = ?): int|false

Это справочная сигнатура, а не строка для выполнения. resource обозначает ресурс расширения; знак | перечисляет возможные виды результата. Метка PECL CUBRID 8.3.0 относится к версии расширения, не к PHP 8.3. Для запуска используется отдельный профиль native CUBRID, описанный в README проектов; основной PHP сайта не меняется.

В исходнике 11.2.0.0002 даже вариант с request читает поля его соединения: sql_type и affected_rows. Поэтому сохраните счётчик сразу после успешного изменения, до SELECT, другой команды или переданной дальше работы. Request не является независимым архивом старого счётчика. Если execute вернул false, сначала разберите его отказ; счётчик предыдущей успешной операции не доказывает успех новой.

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

if (cubrid_execute($request) !== true) {
    throw new RuntimeException('UPDATE не выполнен');
}
$changed = cubrid_affected_rows($request); // сразу, до SELECT
if ($changed === 1) { $accepted = true; }
elseif ($changed === 0) { $accepted = false; }
else { throw new RuntimeException('Некорректный счётчик'); }

Для UPDATE products SET qty = qty - ? WHERE id = ? AND qty >= ? счётчик 1 означает подходящую карточку. В полном проекте значения 2/1/2 дают 1 и остаток 3, затем 4/1/4 дают 0 и прежние 3. Отсутствие самого id также даст 0: для понятного пользователю объяснения иногда нужен дополнительный адресный запрос.

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

if (cubrid_execute($editRequest) !== true) {
    throw new RuntimeException('Редактирование не выполнено');
}
$saved = cubrid_affected_rows($db);
if ($saved !== 1) {
    throw new RuntimeException('Ожидалось изменение одной карточки');
}

Здесь editRequest был подготовлен с WHERE id = ?, а $db — его соединение. Три редактирования заметок проверяют каждый счётчик до следующего SQL, затем отдельно читают сохранённые title/note/qty. Число 1 не доказывает, что выбраны правильные поля или правильный id: полезное обратное чтение остаётся способом проверить именно результат задачи.

Не используйте affected_rows для подсчёта SELECT, для числа видимых элементов интерфейса или как единственное доказательство commit. В запросе без WHERE можно изменить много строк корректным SQL, но ошибочной бизнес-логикой. Не переносите сюда без проверки особенности «найденных» и «изменённых» строк другого драйвера; пример строится на однозначных переходах 5 → 3 и отсутствии подходящей строки. Соседние функции: cubrid_execute, cubrid_fetch_assoc и cubrid_error_code.

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

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

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

SELECT уже определил, какие строки нужны экрану. fetch_assoc берёт одну из них и делает доступной как PHP-массив с именованными ячейками. Например, item_title содержит «Кабель», а available — нулевой остаток, который всё равно нужно показать.

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

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

Это справочная сигнатура, а не строка для выполнения. resource обозначает ресурс расширения; знак | перечисляет возможные виды результата. Метка PECL CUBRID 8.3.0 относится к версии расширения, не к PHP 8.3. Для запуска используется отдельный профиль native CUBRID, описанный в README проектов; основной PHP сайта не меняется.

Применение 1: карточка по известному id

$item = cubrid_fetch_assoc($request);
if ($item === false) {
    echo 'Товар не найден';
} elseif ($item === null) {
    throw new RuntimeException('Не удалось получить карточку');
} else {
    echo htmlspecialchars($item['title'], ENT_QUOTES, 'UTF-8');
    echo ' / остаток ', (int)$item['qty'];
}

request относится к SELECT title, qty ... WHERE id = ?. После проверки вида результата читаются конкретные ячейки. Преобразование qty в int подходит ограниченному INT-остатку нашей схемы. Не применяйте такой cast ко всем значениям: точный DECIMAL, большой идентификатор и дата требуют своих правил. HTML-экранирование названия относится к выводу; bind решает другую задачу.

Применение 2: вывести ограниченную страницу

while (true) {
    $item = cubrid_fetch_assoc($request);
    if ($item === false) { break; }
    if ($item === null) { throw new RuntimeException('Страница прочитана не полностью'); }
    echo htmlspecialchars($item['item_title'], ENT_QUOTES, 'UTF-8');
    echo ' / ', (int)$item['available'], "\n";
}

Перед циклом проект страниц выполняет SELECT id AS item_id, title AS item_title, qty AS available ... ORDER BY id LIMIT 2. Цикл не выбирает и не сортирует весь каталог: он преобразует уже готовую небольшую страницу. false заканчивает чтение именно этого результата, а не означает, что во всей таблице больше нет товаров.

Одинаковые имена колонок в JOIN не дают двух разных ключей одного ассоциативного массива. Задавайте понятные уникальные AS, например product_title и category_title, и обращайтесь к ним точно. SQL NULL сохраняется как null в ячейке: array_key_exists проверяет наличие ключа, а isset дополнительно отсекает null. В сохранённых заметках показаны null, '' и 'NULL' отдельно; числовой 0 также не равен отсутствию строки.

Каждый fetch продвигает текущую позицию. Повторный вызов не возвращает прежнюю карточку; для сохранения используйте уже полученный массив. Получение очередной порции не означает, что драйвер/сервер вообще ничего не буферизуют, поэтому размер ответа ограничивают самим SQL. Ошибка в середине чтения означает неполный результат, её нельзя превратить в обычное окончание цикла. После работы нужен cubrid_close_request; формат LOB и его lifetime рассматриваются отдельным блоком CUBRID.

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

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

cubrid_close_request(resource $req_identifier): bool

После чтения страницы её запрос больше не нужен. close_request освобождает дескриптор и связанную память, сохраняя возможность выполнить другие SQL по тому же соединению. Это особенно важно для повторных запросов и фоновых обработчиков, где нельзя бесконечно накапливать открытые результаты.

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

cubrid_close_request(resource $req_identifier): bool

Это справочная сигнатура, а не строка для выполнения. resource обозначает ресурс расширения; знак | перечисляет возможные виды результата. Метка PECL CUBRID 8.3.0 относится к версии расширения, не к PHP 8.3. Для запуска используется отдельный профиль native CUBRID, описанный в README проектов; основной PHP сайта не меняется.

Функция является псевдонимом cubrid_close_prepare. Она закрывает request, а не connection, не подтверждает транзакцию и не удаляет таблицу. Для снятия бизнес-результата сначала выполните affected_rows либо прочитайте нужные строки, затем освобождайте request. В закреплённом исходнике есть низкоуровневая работа с ресурсом без полной проверки произвольного значения; проекты не вызывают эту функцию для false/null либо повторно закрытого значения.

Применение 1: закончить страницу, оставить соединение

$closed = cubrid_close_request($request);
$request = null;
if ($closed !== true) { throw new RuntimeException('Запрос не освобождён'); }
$nextRequest = cubrid_execute($db,
    'SELECT title, qty FROM products WHERE id = 4');
if ($nextRequest === false) { throw new RuntimeException('Нет следующей карточки'); }
// Прочитать nextRequest и освободить его отдельно.

В полном проекте закрываются оба страничных запроса, затем отдельный SELECT по тому же $db возвращает Молоток / 2. Таким образом, человек видит различие между закрытием результата и отключением от базы. Присваивание null убирает локальную ссылку на уже освобождённый ресурс; оно не заменяет сам close.

Применение 2: убрать подготовленный фильтр даже при ошибке

$request = null;
try {
    $request = cubrid_prepare($db,
        'SELECT title FROM products WHERE category = ?');
    if ($request === false) { throw new RuntimeException('Нет запроса'); }
    // Bind, execute и обработка строк находятся здесь.
} finally {
    if (is_resource($request)) {
        cubrid_close_request($request);
        $request = null;
    }
}

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

Нельзя проверить закрытие повторным fetch или вторым close: это использование недействительного ресурса. Если ещё нужен SQL, подготовьте новый request. Когда закончена вся работа и транзакционная политика выполнена, вызовите cubrid_disconnect. Частичное освобождение буфера через другой API не следует считать взаимозаменяемым с закрытием подготовленного handle. Рядом: cubrid_prepare, cubrid_execute, cubrid_fetch_assoc.

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