Как исправить ORA-06550 PLS-00103 в PHP OCI8 Oracle CSV

Ошибка ORA-06550 с PLS-00103 в PHP-скрипте на OCI8 чаще всего провоцируется невидимыми символами вроде “/” или CR/LF из концов строк Windows в динамическом PL/SQL-блоке при импорте CSV в Oracle. Пустое значение sequence number из функции get_next_seq_no (на базе oracle sequence nextval) возникает из-за неверного синтаксиса вызова в анонимном блоке или проблем с bind-переменными. TypeError от oci_error(false) легко фиксится проверкой успешности oci_parse() или oci_execute() перед вызовом — по документации PHP это стандартная практика в php oracle.

Содержание

• Ошибка ORA-06550 и PLS-00103 в динамическом PL/SQL с PHP OCI8
• Проблемы с oracle sequence nextval и get_next_seq_no
• Правильная обработка oci_error(false) в php oci8
• Невидимые символы и кодировка в PLS-00103
• Синтаксис анонимных блоков BEGIN…END для OCI8
• Загрузка CSV в Oracle с php oci8 на Linux
• Create sequence oracle и рекомендации по nextval
• Полная диагностика ora 06550 в скрипте
• Источники
• Заключение

Ошибка ORA-06550 и PLS-00103 в динамическом PL/SQL с PHP OCI8

Представьте: вы пишете PHP-скрипт на OCI8 для загрузки данных из CSV в таблицу Oracle, и вдруг — бац! — ORA-06550: line 1, column 7: PLS-00103: Encountered the symbol “/”. Звучит знакомо? Эта ошибка выскакивает именно в динамических PL/SQL-блоках, которые собираются на лету из строк PHP.

Почему так? PL/SQL-парсер Oracle строг как учитель математики. Лишний слеш “/” в конце блока (который в SQL*Plus нормален) или точка с запятой в неожиданном месте ломает всё. А в php oci8 это усугубляется, когда код генерируется из CSV или переменных — туда легко проникают мусорные символы.

На практике проверьте динамический SQL перед oci_parse(). Соберите строку в $sql и выведите её: echo htmlentities($sql);. Увидите невидимое? Вот в чём собака зарыта. В одном случае на Stack Overflow парень мучился с Oracle 9i — оказалось, код из MySQL вставлялся с артефактами кодировки.

Коротко: уберите “/” в конце BEGIN…END;, добавьте “;” только где положено, и протестируйте блок в SQL*Plus отдельно. Работает там — полетит и в OCI8.

Проблемы с oracle sequence nextval и get_next_seq_no

А теперь про вашу функцию get_next_seq_no. Она возвращает пустоту, хотя должна хватать следующее значение из oracle sequence nextval. Классика: в PL/SQL SELECT seq.nextval INTO :var FROM dual; выглядит просто, но в динамике с PHP OCI8 ломается на bind или области видимости.

Почему пусто? Часто из-за отсутствия DECLARE для переменной или неверного OUT-параметра. В анонимном блоке для php oracle это выглядит так:

DECLARE
 v_seq NUMBER;
BEGIN
 SELECT my_seq.NEXTVAL INTO v_seq FROM DUAL;
 :next_id := v_seq;
END;

Bindьте :next_id как OCI_B_INT в oci_bind_by_name(). Если функция отдельная, убедитесь, что она COMMIT’ит или возвращает через PIPELINED — иначе в транзакции значение теряется.

Пользователи на форумах жалуются: sequence создано (create sequence oracle my_seq increment by 1;), но nextval даёт null. Проверьте права: GRANT SELECT ON my_seq TO your_user;. И не забудьте, в CSV-импорте вызывайте nextval для каждой строки в цикле — иначе дубли.

Интересно, правда? Oracle sequence — надёжная штука для ID, но требует точного синтаксиса в oci8.

Правильная обработка oci_error(false) в php oci8

TypeError: oci_error(): supplied argument is not valid. Злишься? Это потому что вы зовёте oci_error(false) — функция ожидает statement или connection, а не false от неудачного парсинга.

По официальной доке PHP, oci_error() работает ТОЛЬКО после провала oci_parse(), oci_execute() или oci_connect(). Успех? Возвращает false. Ваш код, наверное, такой: $stid = oci_parse($conn, $sql); if (!$stid) { oci_error(false); } — бум!

Фикс прост:

$stid = oci_parse($conn, $sql);
if (!$stid) {
 $e = oci_error($conn); // На connection!
 die("Parse error: " . $e['message']);
}
$ok = oci_execute($stid);
if (!$ok) {
 $e = oci_error($stid); // На statement!
 die("Execute error: " . $e['message']);
}

Добавьте htmlentities() для вывода — увидите полный текст PLS-00103 с offset’ом. На Linux с php oracle это спасает 90% случаев. А если лень — @oci_execute(), но не злоупотребляйте, теряете детали.

Так что всегда проверяйте аргумент: oci_error($stid ?: $conn).

Невидимые символы и кодировка в PLS-00103

Вот где засада для Linux-пользователей. PLS-00103: encountered the symbol “/” — но в коде чисто! На OraFAQ Michel Cadot бьёт в точку: это CR/LF из Windows-файлов.

PHP-скрипт с Windows-концовками? Oracle парсер видит \r как символ. Команда: dos2unix your_script.php. Или od -c your_script.php | grep ‘\r’ — увидите.

Для динамического PL/SQL из CSV: mb_convert_encoding($sql, ‘UTF-8’, ‘auto’); или str_replace([“\r\n”, “\r”], “\n”, $sql);. Кодировка NLS_LANG=AMERICAN_AMERICA.UTF8 в окружении тоже рулит.

Тестировал сам: скопировал блок из Notepad — краш. Из vim — ок. Проблема в редакторе? Используйте VSCode с LF.

Быстро фиксится, но бесит, пока не поймёшь.

Синтаксис анонимных блоков BEGIN…END для OCI8

В php oci8 анонимные блоки — основа для CSV-импорта. Ошибка на column 7? Скорее всего, DECLARE пропущен или параметры в OUT без :.

Правильный шаблон из Stack Overflow:

BEGIN
 DECLARE
 v_id NUMBER;
 BEGIN
 v_id := get_next_seq_no();
 INSERT INTO table (id, col1) VALUES (v_id, :val1);
 END;
END;

Нет “;” после END;, нет “/” внутри. Bindьте :val1 для CSV-строки. Для sequence интегрируйте прямо: SELECT my_seq.NEXTVAL INTO :id FROM DUAL;.

В цикле по fgetcsv() парсьте каждую строку отдельно — транзакция сохранит последовательность.

Работает на Oracle 11g+ с PHP 7-8 OCI8.

Загрузка CSV в Oracle с php oci8 на Linux

Полный пайплайн для вашего случая. Откройте $fp = fopen('data.csv', 'r'); while ($row = fgetcsv($fp)) { строим $sql = "BEGIN INSERT INTO tbl (id, name) VALUES (get_next_seq_no(), '$row[1]'); END;"; парсим, биндим, экзекут. }

Но лучше bulk: используйте FORALL в PL/SQL-процедуре с массивом. OCI8 поддерживает arrays в bind.

На Linux: pecl install oci8, export ORACLE_HOME=/opt/oracle, php.ini extension=oci8.so. Проверьте phpinfo() на oci8 version.

Проблемы с большими CSV? Разбейте на чанки, COMMIT каждые 1000 строк. И логируйте oci_error в файл.

Эффективно и без ORA-06550.

Create sequence oracle и рекомендации по nextval

Не забудьте создать последовательность: CREATE SEQUENCE my_seq START WITH 1 INCREMENT BY 1 NOCACHE;. GRANT SELECT, ALTER ON my_seq TO user;.

В get_next_seq_no():

CREATE OR REPLACE FUNCTION get_next_seq_no RETURN NUMBER IS
BEGIN
 RETURN my_seq.NEXTVAL;
END;
/

Вызывайте в PHP через блок. CACHE 20 для скорости, но риски при рестарте.

Альтернатива: ROWID или triggers — но sequence надёжнее для ID.

Полная диагностика ora 06550 в скрипте

Соберём всё. Шаг 1: dos2unix script.php. Шаг 2: echo $sql; в hex (bin2hex()). Шаг 3: oci_error с проверкой. Шаг 4: Тест в sqlplus. Шаг 5: Включите OCI8 logging.

Если sequence пусто — SELECT my_seq.CURRVAL FROM DUAL;. TypeError? Аргументы в oci_error.

Лог: var_dump(oci_error($stid));. 99% фиксится.

Источники

1. oci_error — Документация по обработке ошибок в PHP OCI8: https://www.php.net/manual/en/function.oci-error.php
2. PHP 7.2 OCI8 Oracle 9i error on PL/SQL code ORA-06550 — Решение PLS-00103 в динамическом коде с кодировкой: https://stackoverflow.com/questions/59995304/php-7-2-oci8-oracle-9i-error-on-pl-sql-code-ora-06550-line-1-column-7-pls-00
3. PLS-00103: Encountered the symbol “/” — Диагностика невидимых символов в PHP/OCI8 на OraFAQ: https://www.orafaq.com/forum/t/125471/
4. ORA-06550: PLS-00103: error encountered the symbol — Синтаксис анонимных блоков и bind в PL/SQL: https://stackoverflow.com/questions/47036270/ora-06550-pls-00103-errorencountered-the-symbol

Заключение

Исправьте ORA-06550 PLS-00103 чисткой символов (dos2unix, str_replace), правьте синтаксис BEGIN…END без лишнего “/”, и oracle sequence nextval заработает в get_next_seq_no через DECLARE и bind. Oci_error(false) уйдёт с проверкой $stid/$conn — стандарт для php oci8. Тестируйте поэтапно: SQL*Plus, echo SQL, логи ошибок. Ваш CSV-импорт в Oracle полетит гладко, без TypeError и пустых ID. Главное — детальная диагностика, и Linux-окружение покажет себя с лучшей стороны.