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

PECL CUBRID >= 8.3.1; лаборатория PHP 7.4.33 · cubrid

cubrid_connect(string $host, int $port, string $dbname, string $userid = ?, string $passwd = ?, bool $new_link = false): resource|false

Чтобы экран получил товары, сначала нужен доступ к правильной базе через брокер. cubrid_connect создаёт непостоянное соединение и возвращает его ресурс. Получение ресурса ещё не означает, что таблица существует или SELECT уже выполнен.

Результат: ресурс соединения при успехе, false при невозможности подключиться. Проверяйте === false и немедленно сохраняйте диагностику. Адрес, брокер, имя базы, права, секрет и библиотека CCI — разные возможные причины отказа. Настройку соединения нельзя выводить целиком пользователю, особенно с паролем.

1. Открыть каталог для одного запроса

$db = cubrid_connect($host, $brokerPort, $database, $user, $password);
if ($db === false) { throw new RuntimeException("База недоступна"); }
// Теперь можно выполнить SELECT и получить ресурс запроса.

В полном первом каталоге после этого создаются два товара и выводятся количества 6 и 0. Функция соединения не возвращает эти строки напрямую; между соединением и HTML стоят SQL и fetch. Для чтения нужны только разрешённые приложению таблицы, а dba в архиве используется исключительно в отдельном стенде для собственной временной таблицы.

2. Отдельный link для независимой работы в том же процессе

$second = cubrid_connect($host, $brokerPort, $database, $user, $password, true);
if ($second === false) { throw new RuntimeException("Второе соединение не создано"); }
try { /* ограниченный запрос этой операции */ }
finally { cubrid_disconnect($second); }

Флаг имеет смысл, когда нельзя случайно разделить состояние прежнего link: например, явную транзакцию предыдущей операции. В восстановлении после отказа используются явно новые соединения с известными настройками. Это не программа распределённых транзакций и не доказательство поведения постоянного подключения; для нового процесса нужна отдельная граница исполнения.

В исходнике 11.2.0.0002 парсер также принимает седьмой строковый аргумент attr, отсутствующий в официальной шестипараметровой записи. Мы не превращаем это частное расширение исходника в переносимый контракт и не используем его в программах. Документированные свойства соединения показаны через cubrid_connect_with_url. Большие строки и неоднозначные разделители не надо подбирать методом проб; для сложного секрета отдельные аргументы URL-варианта яснее.

Функции доступны при загруженном native-расширении cubrid. Официальные отметки PECL ниже описывают историю появления API, а не совместимость DLL/so с любым современным PHP. Для этой главы выбран PHP 7.4.33 и модуль 11.2.0.0002; отдельную сборку не подставляют в PHP 8 и не используют для понижения версии сайта. Не называйте номер PECL версией языка PHP. Ошибки параметров вызова тоже могут сопровождаться PHP-предупреждением; корректный ресурс проверяют до последующих операций.

Связанные действия: выполнить SQL, закрыть link, сохранить код отказа.

• PHP Manual — cubrid_connect
• Закреплённый native driver

PECL CUBRID >= 8.3.1; лаборатория PHP 7.4.33 · cubrid

cubrid_connect_with_url(string $conn_url, string $userid = ?, string $passwd = ?, bool $new_link = false): resource|false

Конфигурации интеграции бывает нужна строка с адресом брокера, именем базы и ограничением ожидания. cubrid_connect_with_url разбирает специальный URL CUBRID. Он не скачивает веб-страницу и не выполняет переданный SQL.

1. Вход с ограниченным ожиданием и отдельным секретом

$url = "CUBRID:127.0.0.1:33165:phpmanual165:::?login_timeout=3000";
$db = cubrid_connect_with_url($url, $user, $password, true);

В рабочем сценарии URL после входа сохраняется и читается русский товар. Публичный результат показывает форму URL с placeholders, а не реальные реквизиты. Сравнение строк проверяет полезное действие; echo "connected" не обнаружило бы испорченное название.

2. Настроенный переход на резервный брокер

$url = "CUBRID:primary.example:33000:catalog:::?" .
    "alhosts=standby.example:33000&rctime=60&login_timeout=3000";
$db = cubrid_connect_with_url($url, $user, $password);

Это контекстная запись для уже настроенного HA-кластера, не запускаемый failover-тест нашей одиночной лаборатории. Имя primary.example и standby.example обозначают ваши реальные узлы после настройки. Резервирование требует доступной реплики, согласованных данных и политики повторов. Разбор входа и SQL-ошибки показывает базовую диагностику, но не выдаётся за проверку переключения кластера.

Функции доступны при загруженном native-расширении cubrid. Официальные отметки PECL ниже описывают историю появления API, а не совместимость DLL/so с любым современным PHP. Для этой главы выбран PHP 7.4.33 и модуль 11.2.0.0002; отдельную сборку не подставляют в PHP 8 и не используют для понижения версии сайта. Не называйте номер PECL версией языка PHP. Ошибки параметров вызова тоже могут сопровождаться PHP-предупреждением; корректный ресурс проверяют до последующих операций.

Следующий шаг: где сохранить пояснение отказа и как закрыть соединение.

• PHP Manual — cubrid_connect_with_url
• Закреплённый native driver

PECL CUBRID >= 8.3.0; лаборатория PHP 7.4.33 · cubrid

cubrid_disconnect(resource $conn_identifier = ?): bool

Когда отчёт уже получен, процессу больше не нужен доступ к базе. cubrid_disconnect закрывает соединение и относящиеся к нему ещё не закрытые request handles. Результирующая HTML-таблица уже является обычными данными PHP; ей не требуется держать ресурс базы открытым.

1. Освободить ресурсы после чтения экрана

try {
    // Выполнить ограниченный SELECT и собрать обычный массив строк.
} finally {
    cubrid_close_request($request);
    cubrid_disconnect($db);
    $request = null;
    $db = null;
}

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

2. Явно закончить изменения, затем закрыть link

try {
    // Проверенные INSERT/UPDATE в режиме autocommit off.
    if (!cubrid_commit($db)) { throw new RuntimeException("Commit не выполнен"); }
} finally {
    cubrid_disconnect($db);
    $db = null;
}

Закрытие не подменяет решение «сохранить или отменить». При неудачной записи в прикладном коде нужна явная rollback-ветвь и её проверка, а не допущение о судьбе данных после disconnect. В восстановлении SQL-чтения текущая неудачная работа явно отменяется; собственная таблица очищается отдельно. Более содержательные изменения остатков находятся в параметризованном каталоге.

Функции доступны при загруженном native-расширении cubrid. Официальные отметки PECL ниже описывают историю появления API, а не совместимость DLL/so с любым современным PHP. Для этой главы выбран PHP 7.4.33 и модуль 11.2.0.0002; отдельную сборку не подставляют в PHP 8 и не используют для понижения версии сайта. Не называйте номер PECL версией языка PHP. Ошибки параметров вызова тоже могут сопровождаться PHP-предупреждением; корректный ресурс проверяют до последующих операций.

Не закрывайте случайное default-подключение, если в программе несколько link. Для одноразового ресурса эта функция не является гарантией поведения cubrid_pconnect: постоянные подключения требуют отдельного анализа. Карточка запросов: cubrid_close_request.

• PHP Manual — cubrid_disconnect
• Закреплённый native driver

PECL CUBRID >= 8.3.0; лаборатория PHP 7.4.33 · cubrid

cubrid_error_code(): int

При отказе нужен устойчивый номер, который можно сохранить в журнале и сопоставить с конкретной версией драйвера. cubrid_error_code возвращает последний код ошибки CUBRID API; вызов не принимает ни ресурс, ни номер запроса.

1. Отдельно зарегистрировать отказ входа

if ($db === false) {
    $failure = ["stage" => "connect", "code" => cubrid_error_code(),
        "facility" => cubrid_error_code_facility()];
}

В контролируемом восстановлении это запись authentication_failure. Номер не выводится как пароль и не превращается в «нет товаров». Функция code не лечит вход: необходимо исправить причину настройки или реквизитов.

2. Отличить ошибку SQL от успешной пустой выборки

$request = cubrid_execute($db, $sql);
if ($request === false) {
    $failure = ["stage" => "query", "code" => cubrid_error_code()];
    // Не выдавать этот отказ за пустой список товаров.
}

Тот же полный сценарий намеренно использует отсутствующий столбец, сохраняет отдельный sql_failure, а затем читает Переходник — 5 корректным запросом. Сравнивать код с количеством строк бессмысленно; пустой успешный SELECT определяется чтением результата. fetch_assoc возвращает отдельные сигналы для строки, конца и ошибки.

Функции доступны при загруженном native-расширении cubrid. Официальные отметки PECL ниже описывают историю появления API, а не совместимость DLL/so с любым современным PHP. Для этой главы выбран PHP 7.4.33 и модуль 11.2.0.0002; отдельную сборку не подставляют в PHP 8 и не используют для понижения версии сайта. Не называйте номер PECL версией языка PHP. Ошибки параметров вызова тоже могут сопровождаться PHP-предупреждением; корректный ресурс проверяют до последующих операций.

Не фиксируйте старые номера из примеров PHP.net как обязательные для всех серверов и причин. Сохранённый код связывают с этапом, runtime и уровнем ошибки. Для текста есть cubrid_error_msg.

• PHP Manual — cubrid_error_code
• Закреплённый native driver

PECL CUBRID >= 8.3.0; лаборатория PHP 7.4.33 · cubrid

cubrid_error_msg(): string

Текст ошибки помогает разработчику понять, какой объект, запрос или настройка вызвали отказ. cubrid_error_msg возвращает пояснение сохранённой ошибки CUBRID API без аргументов. Это диагностический текст, который может содержать детали вашей инфраструктуры.

1. Диагностика неправильно настроенной интеграции

if ($db === false) {
    $code = cubrid_error_code();
    $message = cubrid_error_msg();
    $publicStatus = "Подключение к каталогу не выполнено";
    // $message предназначен для закрытой диагностики, не HTML посетителя.
}

В программе отказа входа вместо исходного текста в открытый result.json включён message_present. Это позволяет показать, что диагностика была получена, не публикуя секретные подробности. Полный приватный журнал реального приложения должен иметь свою политику доступа и срок хранения.

2. Сохранить причину до следующей SQL-команды

$request = cubrid_execute($db, $sql);
if ($request === false) {
    $details = ["code" => cubrid_error_code(),
        "facility" => cubrid_error_code_facility(),
        "message" => cubrid_error_msg()];
    // Теперь можно выполнять rollback и отдельное исправленное действие.
}

Это защищает сообщение от перезаписи успешным служебным запросом. В том же сценарии SQL-отказ и исправленный SELECT существуют отдельно. Нельзя анализировать message только после успешной повторной выборки и утверждать, что прежней ошибки не было.

Функции доступны при загруженном native-расширении cubrid. Официальные отметки PECL ниже описывают историю появления API, а не совместимость DLL/so с любым современным PHP. Для этой главы выбран PHP 7.4.33 и модуль 11.2.0.0002; отдельную сборку не подставляют в PHP 8 и не используют для понижения версии сайта. Не называйте номер PECL версией языка PHP. Ошибки параметров вызова тоже могут сопровождаться PHP-предупреждением; корректный ресурс проверяют до последующих операций.

Не разрабатывайте бизнес-правила на поиске одного английского слова в сообщении: версии и формулировки меняются. Для классификации сначала используйте этап, код и facility, а текст — для объяснения и поиска причины. См. cubrid_error_code и cubrid_error_code_facility.

• PHP Manual — cubrid_error_msg
• Закреплённый native driver

PECL CUBRID >= 8.3.0; лаборатория PHP 7.4.33 · cubrid

cubrid_error_code_facility(): int

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

1. Отчёт интеграции с указанием слоя отказа

if ($db === false) {
    $diagnostic = ["operation" => "catalog-connect",
        "facility" => cubrid_error_code_facility(),
        "code" => cubrid_error_code()];
}

В полном восстановлении вход и SQL имеют отдельные records. Facility не подменяет код: разные причины могут относиться к одному слою, а доступность брокера не гарантирует успешного запроса к таблице.

2. Добавить понятное имя слоя без магических чисел

$labels = [CUBRID_FACILITY_DBMS => "сервер базы",
    CUBRID_FACILITY_CAS => "CAS брокера",
    CUBRID_FACILITY_CCI => "клиент CCI",
    CUBRID_FACILITY_CLIENT => "PHP-модуль"];
$level = cubrid_error_code_facility();
$label = isset($labels[$level]) ? $labels[$level] : "нет известной категории";

Так можно дополнить закрытый журнал импорта или диагностику каталога. Константы читаются понятнее чисел 1/2/3/4 и принадлежат установленному расширению. Не показывайте отдельный facility успешного запроса как «ошибку нулевого уровня»: сначала нужен установленный отказ самой операции. Переход к параметрам запроса добавляет ещё один важный этап — подготовку и привязку значений.

Функции доступны при загруженном native-расширении cubrid. Официальные отметки PECL ниже описывают историю появления API, а не совместимость DLL/so с любым современным PHP. Для этой главы выбран PHP 7.4.33 и модуль 11.2.0.0002; отдельную сборку не подставляют в PHP 8 и не используют для понижения версии сайта. Не называйте номер PECL версией языка PHP. Ошибки параметров вызова тоже могут сопровождаться PHP-предупреждением; корректный ресурс проверяют до последующих операций.

Связанные инструменты: точный код и поясняющий текст. Эта классификация не является универсальным кодом HTTP и не должна без преобразования становиться статусом ответа сайта.

• PHP Manual — cubrid_error_code_facility
• Закреплённый native driver