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

<?php
declare(strict_types=1);
require __DIR__.'/lab.php';
$db=null;$owned=$removed=$rows=$checks=$observations=[];
try {
    $config=c170Config();$db=c170Connect();$runtime=c170Runtime($db);

    function selectedOid170($db,string $table,int $id): string {
        $q=cubrid_prepare($db,'SELECT id,title FROM '.$table.' WHERE id=?',CUBRID_INCLUDE_OID);
        if($q===false){throw new RuntimeException('Не подготовлен выбор записи');}
        try {
            if(!cubrid_bind($q,1,$id,'int')||!cubrid_execute($q)||cubrid_num_rows($q)!==1
                ||!cubrid_move_cursor($q,1,CUBRID_CURSOR_FIRST)){
                throw new RuntimeException('Нужна ровно одна доступная запись');
            }
            $oid=cubrid_current_oid($q);
            if(!is_string($oid)||$oid===''){throw new RuntimeException('Не получен OID');}
            return $oid;
        } finally {c170Release($q);}
    }
    function collection170($db,string $oid,string $attr): array {
        $value=cubrid_col_get($db,$oid,$attr);
        if($value===false){throw new RuntimeException('Не прочитана коллекция');}
        return $value;
    }
    function change170(bool $ok): void {
        if(!$ok){throw new RuntimeException('Изменение коллекции не выполнено');}
    }
    function sorted170(array $items): array {sort($items,SORT_STRING);return $items;}

    // Подготовка одного собственного списка; прикладные изменения идут ниже.
    function seedSequence170($db,array &$owned,string $label,string $title,array $items): array {
        $name=c170OwnName($db,$owned,'TABLE',$label);
        $table=c170Qualified($name);
        c170Ddl($db,'CREATE TABLE '.$table.' (id INT PRIMARY KEY,title VARCHAR(120),steps SEQUENCE(VARCHAR(80))) DONT_REUSE_OID');
        c170Commit($db);
        c170Command($db,'INSERT INTO '.$table.' (id,title,steps) VALUES (1,?,{})',[$title]);
        $oid=selectedOid170($db,$table,1);
        foreach($items as $index=>$value) {
            change170(cubrid_seq_insert($db,$oid,'steps',$index+1,$value));
        }
        c170Commit($db);
        return [$table,$oid];
    }
    function showSequence170(array $items): string {
        return implode(' → ',array_map(static function($value): string {
            return $value===null?'NULL':$value;
        },$items));
    }

    [$table,$oid]=seedSequence170($db,$owned,'seq_check','Заказ 17',['Принять заказ','Упаковать']);
    $before=collection170($db,$oid,'steps');
    $position=2;
    if($position<1 || $position>count($before)+1) {throw new RuntimeException('Позиция вне списка');}
    change170(cubrid_seq_insert($db,$oid,'steps',$position,"Проверить O'Reilly"));
    $inserted=collection170($db,$oid,'steps');
    change170(cubrid_seq_insert($db,$oid,'steps',count($inserted)+1,'Отправить'));
    c170Commit($db);
    $saved=collection170($db,$oid,'steps');

    // Ноль в API базы не означает первый элемент PHP-массива.
    $bad=c170Capture(static function() use ($db,$oid) {
        return cubrid_seq_insert($db,$oid,'steps',0,'Ошибочный шаг');
    });
    c170Rollback($db);
    $afterFailure=collection170($db,$oid,'steps');
    $title=c170Read($db,'SELECT title FROM '.$table.' WHERE id=?',[1])[0]['title'];
    $rows=[['Заказ',$title],['До',showSequence170($before)],['После вставки на позицию 2',showSequence170($inserted)],
        ['Сохранённый список',showSequence170($saved)],['Недопустимый индекс 0',$bad['code']],
        ['После отказа',showSequence170($afterFailure)]];
    $checks=['before'=> $before===['Принять заказ','Упаковать'],
        'insert_shift'=> $inserted===['Принять заказ',"Проверить O'Reilly",'Упаковать'],
        'append'=> $saved===['Принять заказ',"Проверить O'Reilly",'Упаковать','Отправить'],
        'utf8_apostrophe'=> $saved[1]==="Проверить O'Reilly",
        'zero_refused'=> $bad['value']===false && $bad['code']===-309 && $bad['facility']===1 && $bad['warning'] && $bad['message_present'],
        'saved_survives_failure'=> $afterFailure===$saved,'selected_order'=> $title==='Заказ 17'];
    $observations=['before'=>$before,'inserted'=>$inserted,'saved'=>$saved,'invalid_zero'=>$bad,'after_failure'=>$afterFailure];

} finally {
    if (is_resource($db)) {try {$removed=c170Cleanup($db,$owned);} finally {c170Close($db);}}
}

c170Report('cub170-checklist-insert','Добавить проверку перед упаковкой, не потеряв остальные шаги',$rows,$checks,$observations,$runtime,$owned,$removed);

Заказ — Заказ 17
До — Принять заказ → Упаковать
После вставки на позицию 2 — Принять заказ → Проверить O'Reilly → Упаковать
Сохранённый список — Принять заказ → Проверить O'Reilly → Упаковать → Отправить
Недопустимый индекс 0 — -309
После отказа — Принять заказ → Проверить O'Reilly → Упаковать → Отправить

Распакуйте весь ZIP; порядок запуска и создание отдельного стенда описаны в README.txt. example.php содержит операции урока, lab.php — подключение, создание только собственных таблиц и очистку. result.html показывает итог, result.json — исходные наблюдения. В finally удаляется только созданная этим запуском таблица. Это реальный CLI-проект с CUBRID, не PHP-обработчик публичного сайта.

<?php
declare(strict_types=1);
require __DIR__.'/lab.php';
$db=null;$owned=$removed=$rows=$checks=$observations=[];
try {
    $config=c170Config();$db=c170Connect();$runtime=c170Runtime($db);

    function selectedOid170($db,string $table,int $id): string {
        $q=cubrid_prepare($db,'SELECT id,title FROM '.$table.' WHERE id=?',CUBRID_INCLUDE_OID);
        if($q===false){throw new RuntimeException('Не подготовлен выбор записи');}
        try {
            if(!cubrid_bind($q,1,$id,'int')||!cubrid_execute($q)||cubrid_num_rows($q)!==1
                ||!cubrid_move_cursor($q,1,CUBRID_CURSOR_FIRST)){
                throw new RuntimeException('Нужна ровно одна доступная запись');
            }
            $oid=cubrid_current_oid($q);
            if(!is_string($oid)||$oid===''){throw new RuntimeException('Не получен OID');}
            return $oid;
        } finally {c170Release($q);}
    }
    function collection170($db,string $oid,string $attr): array {
        $value=cubrid_col_get($db,$oid,$attr);
        if($value===false){throw new RuntimeException('Не прочитана коллекция');}
        return $value;
    }
    function change170(bool $ok): void {
        if(!$ok){throw new RuntimeException('Изменение коллекции не выполнено');}
    }
    function sorted170(array $items): array {sort($items,SORT_STRING);return $items;}

    // Подготовка одного собственного списка; прикладные изменения идут ниже.
    function seedSequence170($db,array &$owned,string $label,string $title,array $items): array {
        $name=c170OwnName($db,$owned,'TABLE',$label);
        $table=c170Qualified($name);
        c170Ddl($db,'CREATE TABLE '.$table.' (id INT PRIMARY KEY,title VARCHAR(120),steps SEQUENCE(VARCHAR(80))) DONT_REUSE_OID');
        c170Commit($db);
        c170Command($db,'INSERT INTO '.$table.' (id,title,steps) VALUES (1,?,{})',[$title]);
        $oid=selectedOid170($db,$table,1);
        foreach($items as $index=>$value) {
            change170(cubrid_seq_insert($db,$oid,'steps',$index+1,$value));
        }
        c170Commit($db);
        return [$table,$oid];
    }
    function showSequence170(array $items): string {
        return implode(' → ',array_map(static function($value): string {
            return $value===null?'NULL':$value;
        },$items));
    }

    [$table,$oid]=seedSequence170($db,$owned,'seq_route','Маршрут 8',['Склад','Клиент','Склад']);
    $before=collection170($db,$oid,'steps');
    $position=2;
    if($position<1 || $position>count($before)) {throw new RuntimeException('Нет остановки для замены');}
    change170(cubrid_seq_put($db,$oid,'steps',$position,"Пункт O'Reilly"));
    c170Commit($db);
    $saved=collection170($db,$oid,'steps');

    // Диагностика поведения API: индекс 5 при длине 3 создаёт промежуток.
    change170(cubrid_seq_put($db,$oid,'steps',5,'Ошибочная остановка'));
    $gap=collection170($db,$oid,'steps');
    c170Rollback($db);
    $restored=collection170($db,$oid,'steps');
    $rows=[['До',showSequence170($before)],['После замены позиции 2',showSequence170($saved)],
        ['Проверка API: запись на позицию 5',showSequence170($gap)],['После rollback',showSequence170($restored)],
        ['Остановок в принятом маршруте',count($restored)]];
    $checks=['before'=> $before===['Склад','Клиент','Склад'],
        'replace_keeps_size'=> $saved===['Склад',"Пункт O'Reilly",'Склад'] && count($saved)===3,
        'utf8_apostrophe'=> $saved[1]==="Пункт O'Reilly",
        'gap_observed'=> $gap===['Склад',"Пункт O'Reilly",'Склад',null,'Ошибочная остановка'],
        'rollback_restores'=> $restored===$saved];
    $observations=['before'=>$before,'saved'=>$saved,'discarded_gap'=>$gap,'restored'=>$restored];

} finally {
    if (is_resource($db)) {try {$removed=c170Cleanup($db,$owned);} finally {c170Close($db);}}
}

c170Report('cub170-route-replace','Исправить одну остановку маршрута и увидеть опасность далёкой позиции',$rows,$checks,$observations,$runtime,$owned,$removed);

До — Склад → Клиент → Склад
После замены позиции 2 — Склад → Пункт O'Reilly → Склад
Проверка API: запись на позицию 5 — Склад → Пункт O'Reilly → Склад → NULL → Ошибочная остановка
После rollback — Склад → Пункт O'Reilly → Склад
Остановок в принятом маршруте — 3

Распакуйте весь ZIP; порядок запуска и создание отдельного стенда описаны в README.txt. example.php содержит операции урока, lab.php — подключение, создание только собственных таблиц и очистку. result.html показывает итог, result.json — исходные наблюдения. В finally удаляется только созданная этим запуском таблица. Это реальный CLI-проект с CUBRID, не PHP-обработчик публичного сайта.

<?php
declare(strict_types=1);
require __DIR__.'/lab.php';
$db=null;$owned=$removed=$rows=$checks=$observations=[];
try {
    $config=c170Config();$db=c170Connect();$runtime=c170Runtime($db);

    function selectedOid170($db,string $table,int $id): string {
        $q=cubrid_prepare($db,'SELECT id,title FROM '.$table.' WHERE id=?',CUBRID_INCLUDE_OID);
        if($q===false){throw new RuntimeException('Не подготовлен выбор записи');}
        try {
            if(!cubrid_bind($q,1,$id,'int')||!cubrid_execute($q)||cubrid_num_rows($q)!==1
                ||!cubrid_move_cursor($q,1,CUBRID_CURSOR_FIRST)){
                throw new RuntimeException('Нужна ровно одна доступная запись');
            }
            $oid=cubrid_current_oid($q);
            if(!is_string($oid)||$oid===''){throw new RuntimeException('Не получен OID');}
            return $oid;
        } finally {c170Release($q);}
    }
    function collection170($db,string $oid,string $attr): array {
        $value=cubrid_col_get($db,$oid,$attr);
        if($value===false){throw new RuntimeException('Не прочитана коллекция');}
        return $value;
    }
    function change170(bool $ok): void {
        if(!$ok){throw new RuntimeException('Изменение коллекции не выполнено');}
    }
    function sorted170(array $items): array {sort($items,SORT_STRING);return $items;}

    // Подготовка одного собственного списка; прикладные изменения идут ниже.
    function seedSequence170($db,array &$owned,string $label,string $title,array $items): array {
        $name=c170OwnName($db,$owned,'TABLE',$label);
        $table=c170Qualified($name);
        c170Ddl($db,'CREATE TABLE '.$table.' (id INT PRIMARY KEY,title VARCHAR(120),steps SEQUENCE(VARCHAR(80))) DONT_REUSE_OID');
        c170Commit($db);
        c170Command($db,'INSERT INTO '.$table.' (id,title,steps) VALUES (1,?,{})',[$title]);
        $oid=selectedOid170($db,$table,1);
        foreach($items as $index=>$value) {
            change170(cubrid_seq_insert($db,$oid,'steps',$index+1,$value));
        }
        c170Commit($db);
        return [$table,$oid];
    }
    function showSequence170(array $items): string {
        return implode(' → ',array_map(static function($value): string {
            return $value===null?'NULL':$value;
        },$items));
    }

    [$table,$oid]=seedSequence170($db,$owned,'seq_remove','Маршрут 9',['Склад','Клиент','Склад','Сервис']);
    $before=collection170($db,$oid,'steps');
    $position=3;
    if($position<1 || $position>count($before) || $before[$position-1]!=='Склад') {
        throw new RuntimeException('Позиция уже не соответствует выбранному заезду');
    }
    change170(cubrid_seq_drop($db,$oid,'steps',$position));
    c170Commit($db);
    $saved=collection170($db,$oid,'steps');
    $badPosition=count($saved)+1;
    $bad=c170Capture(static function() use ($db,$oid,$badPosition) {
        return cubrid_seq_drop($db,$oid,'steps',$badPosition);
    });
    c170Rollback($db);
    $afterFailure=collection170($db,$oid,'steps');
    $rows=[['До',showSequence170($before)],['Удалённая позиция',$position],['После удаления',showSequence170($saved)],
        ['Новая позиция сервиса',3],['Удаление несуществующей позиции 4',$bad['code']],['После отказа',showSequence170($afterFailure)]];
    $checks=['before'=> $before===['Склад','Клиент','Склад','Сервис'],
        'one_occurrence'=> $saved===['Склад','Клиент','Сервис'],
        'shift_left'=> $saved[2]==='Сервис',
        'missing_refused'=> $bad['value']===false && $bad['code']===-309 && $bad['facility']===1 && $bad['warning'] && $bad['message_present'],
        'failure_keeps_saved'=> $afterFailure===$saved];
    $observations=['before'=>$before,'removed_position'=>$position,'saved'=>$saved,'invalid_position'=>$bad,'after_failure'=>$afterFailure];

} finally {
    if (is_resource($db)) {try {$removed=c170Cleanup($db,$owned);} finally {c170Close($db);}}
}

c170Report('cub170-duplicate-stop-drop','Удалить один повторный заезд, сохранив первый',$rows,$checks,$observations,$runtime,$owned,$removed);

До — Склад → Клиент → Склад → Сервис
Удалённая позиция — 3
После удаления — Склад → Клиент → Сервис
Новая позиция сервиса — 3
Удаление несуществующей позиции 4 — -309
После отказа — Склад → Клиент → Сервис

Распакуйте весь ZIP; порядок запуска и создание отдельного стенда описаны в README.txt. example.php содержит операции урока, lab.php — подключение, создание только собственных таблиц и очистку. result.html показывает итог, result.json — исходные наблюдения. В finally удаляется только созданная этим запуском таблица. Это реальный CLI-проект с CUBRID, не PHP-обработчик публичного сайта.

<?php
declare(strict_types=1);
require __DIR__.'/lab.php';
$db=null;$owned=$removed=$rows=$checks=$observations=[];
try {
    $config=c170Config();$db=c170Connect();$runtime=c170Runtime($db);

    function selectedOid170($db,string $table,int $id): string {
        $q=cubrid_prepare($db,'SELECT id,title FROM '.$table.' WHERE id=?',CUBRID_INCLUDE_OID);
        if($q===false){throw new RuntimeException('Не подготовлен выбор записи');}
        try {
            if(!cubrid_bind($q,1,$id,'int')||!cubrid_execute($q)||cubrid_num_rows($q)!==1
                ||!cubrid_move_cursor($q,1,CUBRID_CURSOR_FIRST)){
                throw new RuntimeException('Нужна ровно одна доступная запись');
            }
            $oid=cubrid_current_oid($q);
            if(!is_string($oid)||$oid===''){throw new RuntimeException('Не получен OID');}
            return $oid;
        } finally {c170Release($q);}
    }
    function collection170($db,string $oid,string $attr): array {
        $value=cubrid_col_get($db,$oid,$attr);
        if($value===false){throw new RuntimeException('Не прочитана коллекция');}
        return $value;
    }
    function change170(bool $ok): void {
        if(!$ok){throw new RuntimeException('Изменение коллекции не выполнено');}
    }
    function sorted170(array $items): array {sort($items,SORT_STRING);return $items;}

    // Подготовка одного собственного списка; прикладные изменения идут ниже.
    function seedSequence170($db,array &$owned,string $label,string $title,array $items): array {
        $name=c170OwnName($db,$owned,'TABLE',$label);
        $table=c170Qualified($name);
        c170Ddl($db,'CREATE TABLE '.$table.' (id INT PRIMARY KEY,title VARCHAR(120),steps SEQUENCE(VARCHAR(80))) DONT_REUSE_OID');
        c170Commit($db);
        c170Command($db,'INSERT INTO '.$table.' (id,title,steps) VALUES (1,?,{})',[$title]);
        $oid=selectedOid170($db,$table,1);
        foreach($items as $index=>$value) {
            change170(cubrid_seq_insert($db,$oid,'steps',$index+1,$value));
        }
        c170Commit($db);
        return [$table,$oid];
    }
    function showSequence170(array $items): string {
        return implode(' → ',array_map(static function($value): string {
            return $value===null?'NULL':$value;
        },$items));
    }

    [$table,$oid]=seedSequence170($db,$owned,'seq_reorder','Упаковочный лист',['Сборка','Проверка','Маркировка','Упаковка']);
    // Один редактор: блокируем выбранную запись, затем читаем актуальный список.
    change170(cubrid_lock_write($db,$oid));
    $before=collection170($db,$oid,'steps');
    $from=3;$to=2;
    if($from<1 || $from>count($before) || $to<1 || $to>count($before)) {
        throw new RuntimeException('Неверная позиция переноса');
    }
    $value=$before[$from-1];
    change170(cubrid_seq_drop($db,$oid,'steps',$from));
    $intermediate=collection170($db,$oid,'steps');
    // Решение отменено до вставки: половина переноса не должна сохраниться.
    c170Rollback($db);
    $cancelled=collection170($db,$oid,'steps');
    c170Commit($db);

    change170(cubrid_lock_write($db,$oid));
    $fresh=collection170($db,$oid,'steps');
    if($fresh!==$before) {throw new RuntimeException('Список изменился: обновите форму');}
    change170(cubrid_seq_drop($db,$oid,'steps',$from));
    change170(cubrid_seq_insert($db,$oid,'steps',$to,$value));
    $preview=collection170($db,$oid,'steps');
    if($preview!==['Сборка','Маркировка','Проверка','Упаковка']) {
        throw new RuntimeException('Не получен согласованный порядок');
    }
    c170Commit($db);
    $saved=collection170($db,$oid,'steps');
    $rows=[['Исходный порядок',showSequence170($before)],['Промежуточно после drop(3)',showSequence170($intermediate)],
        ['Отмена переноса',showSequence170($cancelled)],['После drop(3) и insert(2)',showSequence170($saved)],
        ['Число шагов после сохранения',count($saved)]];
    $checks=['before'=> $before===['Сборка','Проверка','Маркировка','Упаковка'],
        'intermediate'=> $intermediate===['Сборка','Проверка','Упаковка'],
        'cancel_restores_all'=> $cancelled===$before,
        'fresh_comparison'=> $fresh===$before,
        'atomic_order'=> $saved===['Сборка','Маркировка','Проверка','Упаковка'] && $saved===$preview,
        'same_items'=> count($saved)===count($before) && sorted170($saved)===sorted170($before)];
    $observations=['before'=>$before,'intermediate_not_committed'=>$intermediate,'cancelled'=>$cancelled,'fresh'=>$fresh,'saved'=>$saved];

} finally {
    if (is_resource($db)) {try {$removed=c170Cleanup($db,$owned);} finally {c170Close($db);}}
}

c170Report('cub170-sequence-reorder','Перенести маркировку перед проверкой: отменить пробу и сохранить целое изменение',$rows,$checks,$observations,$runtime,$owned,$removed);

Исходный порядок — Сборка → Проверка → Маркировка → Упаковка
Промежуточно после drop(3) — Сборка → Проверка → Упаковка
Отмена переноса — Сборка → Проверка → Маркировка → Упаковка
После drop(3) и insert(2) — Сборка → Маркировка → Проверка → Упаковка
Число шагов после сохранения — 4

Распакуйте весь ZIP; порядок запуска и создание отдельного стенда описаны в README.txt. example.php содержит операции урока, lab.php — подключение, создание только собственных таблиц и очистку. result.html показывает итог, result.json — исходные наблюдения. В finally удаляется только созданная этим запуском таблица. Это реальный CLI-проект с CUBRID, не PHP-обработчик публичного сайта.