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;}

    $name=c170OwnName($db,$owned,'TABLE','product_tags');$t=c170Qualified($name);
    c170Ddl($db,'CREATE TABLE '.$t.' (id INT PRIMARY KEY,title VARCHAR(80),tags SET(VARCHAR(40))) DONT_REUSE_OID');
    c170Command($db,"INSERT INTO $t (id,title,tags) VALUES (?, ?, {'copper','indoor'})",[10,'Кабель']);
    c170Command($db,"INSERT INTO $t (id,title,tags) VALUES (?, ?, {'steel'})",[20,'Хомут']);
    c170Commit($db);
    $oid=selectedOid170($db,$t,10);
    $before=sorted170(collection170($db,$oid,'tags'));
    change170(cubrid_set_add($db,$oid,'tags','flexible'));
    $duplicate=cubrid_set_add($db,$oid,'tags','copper');change170($duplicate);
    $afterDuplicate=sorted170(collection170($db,$oid,'tags'));
    change170(cubrid_set_drop($db,$oid,'tags','indoor'));
    $series="Серия O'Reilly";
    change170(cubrid_set_add($db,$oid,'tags',$series));
    c170Commit($db);
    $saved=sorted170(collection170($db,selectedOid170($db,$t,10),'tags'));
    $size=cubrid_col_size($db,$oid,'tags');
    if($size===false){throw new RuntimeException('Размер набора не прочитан');}
    $neighbor=collection170($db,selectedOid170($db,$t,20),'tags');
    // PHP-массив — копия. Эта строка не вызывает ни одного изменения базы.
    $local=$saved;$local[]='local-only';
    $unchanged=sorted170(collection170($db,$oid,'tags'));
    c170Commit($db);
    $rows=[['Товар','Кабель'],['До изменения',implode(', ',$before)],
        ['После сохранения',implode(', ',$saved)],['Количество признаков',$size],
        ['Повторное добавление copper успешно',$duplicate],['Кириллица и апостроф сохранены',in_array($series,$saved,true)],
        ['Хомут не изменён',$neighbor===['steel']],['Изменение массива PHP не записалось',$unchanged===$saved]];
    $checks=['initial_members'=>$before===['copper','indoor'],'duplicate_success'=>$duplicate===true,
        'duplicate_not_multiplied'=>$afterDuplicate===['copper','flexible','indoor'],
        'saved_members'=>$saved===['copper','flexible',"Серия O'Reilly"],'saved_size'=>$size===3,
        'utf8_quote_roundtrip'=>in_array($series,$saved,true),'neighbor_unchanged'=>$neighbor===['steel'],
        'local_snapshot_not_write'=>$unchanged===$saved&&count($local)===4];
    $observations=['before'=>$before,'after_duplicate'=>$afterDuplicate,'saved'=>$saved,
        'size'=>$size,'neighbor'=>$neighbor,'php_copy'=>$local,'reread'=>$unchanged,
        'series_bytes'=>strlen($series),'series_sha256'=>hash('sha256',$series),
        'display_order'=>'SORT_STRING on a small copy; SET storage has no promised order'];

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

c170Report('cub170-product-tags','Признаки кабеля: добавить метку без дубля и убрать старую',$rows,$checks,$observations,$runtime,$owned,$removed);

Товар — Кабель
До изменения — copper, indoor
После сохранения — copper, flexible, Серия O'Reilly
Количество признаков — 3
Повторное добавление copper успешно — да
Кириллица и апостроф сохранены — да
Хомут не изменён — да
Изменение массива PHP не записалось — да

Распакуйте весь 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;}

    $name=c170OwnName($db,$owned,'TABLE','kit_parts');$t=c170Qualified($name);
    c170Ddl($db,'CREATE TABLE '.$t.' (id INT PRIMARY KEY,title VARCHAR(80),parts MULTISET(VARCHAR(40))) DONT_REUSE_OID');
    c170Command($db,"INSERT INTO $t (id,title,parts) VALUES (?, ?, {'washer','washer','bolt'})",[10,'Монтажный комплект']);
    c170Commit($db);$oid=selectedOid170($db,$t,10);
    $initial=sorted170(collection170($db,$oid,'parts'));
    change170(cubrid_set_add($db,$oid,'parts','washer'));
    $packed=sorted170(collection170($db,$oid,'parts'));$packedSize=cubrid_col_size($db,$oid,'parts');
    change170(cubrid_set_drop($db,$oid,'parts','washer'));
    $afterOne=sorted170(collection170($db,$oid,'parts'));
    change170(cubrid_set_drop($db,$oid,'parts','bolt'));
    $missing=cubrid_set_drop($db,$oid,'parts','nut');change170($missing);
    c170Commit($db);
    $saved=sorted170(collection170($db,selectedOid170($db,$t,10),'parts'));
    $savedSize=cubrid_col_size($db,$oid,'parts');
    if($packedSize===false||$savedSize===false){throw new RuntimeException('Размер комплекта не прочитан');}
    $counts=array_count_values($saved);c170Commit($db);
    $rows=[['До комплектации',implode(', ',$initial)],['После добавления шайбы',implode(', ',$packed)],
        ['Деталей после добавления',$packedSize],['После извлечения одной шайбы',implode(', ',$afterOne)],
        ['Сохранённый комплект',implode(', ',$saved)],['Осталось шайб',$counts['washer']??0],
        ['Всего деталей',$savedSize],['Удаление отсутствующей nut успешно',$missing]];
    $checks=['initial_duplicates'=>$initial===['bolt','washer','washer'],
        'multiset_add_keeps_repeat'=>$packed===['bolt','washer','washer','washer'],'four_packed'=>$packedSize===4,
        'one_occurrence_removed'=>$afterOne===['bolt','washer','washer'],'bolt_removed'=>$saved===['washer','washer'],
        'two_actual_items'=>$savedSize===2,'one_kind_two_instances'=>count($counts)===1&&($counts['washer']??0)===2,
        'missing_drop_success'=>$missing===true];
    $observations=['initial'=>$initial,'packed'=>$packed,'after_one_drop'=>$afterOne,'saved'=>$saved,
        'saved_size'=>$savedSize,'counts_by_value'=>$counts,'missing_drop'=>$missing,
        'business_meaning'=>'Each repeated washer represents one physical piece; no guaranteed storage order'];

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

c170Report('cub170-kit-multiset','Комплект крепежа: считать все детали и вынуть только одну шайбу',$rows,$checks,$observations,$runtime,$owned,$removed);

До комплектации — bolt, washer, washer
После добавления шайбы — bolt, washer, washer, washer
Деталей после добавления — 4
После извлечения одной шайбы — bolt, washer, washer
Сохранённый комплект — washer, washer
Осталось шайб — 2
Всего деталей — 2
Удаление отсутствующей nut успешно — да

Распакуйте весь 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;}

    $name=c170OwnName($db,$owned,'TABLE','state');$t=c170Qualified($name);
    c170Ddl($db,'CREATE TABLE '.$t.' (id INT PRIMARY KEY,title VARCHAR(80),tags SET(VARCHAR(40)),plain VARCHAR(40)) DONT_REUSE_OID');
    c170Command($db,"INSERT INTO $t (id,title,tags,plain) VALUES (?, ?, NULL, ?)",[10,'Не заполнено','обычный текст']);
    c170Command($db,"INSERT INTO $t (id,title,tags,plain) VALUES (?, ?, {}, ?)",[20,'Подтверждено: меток нет','обычный текст']);
    c170Command($db,"INSERT INTO $t (id,title,tags,plain) VALUES (?, ?, {NULL}, ?)",[30,'Нужна правка элемента','обычный текст']);
    c170Commit($db);$states=[];
    $selected=c170Read($db,"SELECT id,title,CASE WHEN tags IS NULL THEN 1 ELSE 0 END AS collection_is_null FROM $t WHERE id IN (10,20,30) ORDER BY id LIMIT 3");
    foreach($selected as $record){
        $oid=selectedOid170($db,$t,(int)$record['id']);
        $get=c170Capture(static function()use($db,$oid){return cubrid_col_get($db,$oid,'tags');});
        $size=c170Capture(static function()use($db,$oid){return cubrid_col_size($db,$oid,'tags');});
        if($get['value']===false||$get['warning']||$size['value']===false||$size['warning']){c170Failure('Состояние не прочитано');}
        $status=(int)$record['collection_is_null']===1?'не заполнено':($size['value']===0?'подтверждено: меток нет':'требуется заполнить один элемент');
        $states[]=['id'=>(int)$record['id'],'sql_null'=>(int)$record['collection_is_null']===1,
            'items'=>$get['value'],'size'=>$size['value'],'status'=>$status];
    }
    $oid=selectedOid170($db,$t,10);
    $wrong=c170Capture(static function()use($db,$oid){return cubrid_col_get($db,$oid,'missing170');});
    $scalar=c170Capture(static function()use($db,$oid){return cubrid_col_size($db,$oid,'plain');});
    // These controlled refusals are diagnostics, not empty collections.
    c170Rollback($db);
    $rows=[['SQL NULL',$states[0]['status'].'; размер '.$states[0]['size']],
        ['Пустая коллекция {}',$states[1]['status'].'; размер '.$states[1]['size']],
        ['Коллекция {NULL}',$states[2]['status'].'; размер '.$states[2]['size']],
        ['Массивы первых двух одинаковы',$states[0]['items']===$states[1]['items']],
        ['Неизвестный атрибут: код',$wrong['code']],['Обычная строка вместо коллекции: код',$scalar['code']]];
    $checks=['three_bounded_records'=>count($states)===3,'null_is_unknown'=>$states[0]['sql_null']&&$states[0]['items']===[]&&$states[0]['size']===-1,
        'empty_is_known'=>!$states[1]['sql_null']&&$states[1]['items']===[]&&$states[1]['size']===0,
        'one_null_is_one'=>!$states[2]['sql_null']&&$states[2]['items']===[null]&&$states[2]['size']===1,
        'get_alone_loses_distinction'=>$states[0]['items']===$states[1]['items'],
        'unknown_attribute_refused'=>$wrong['value']===false&&$wrong['code']===-202&&$wrong['facility']===1&&$wrong['warning']&&$wrong['message_present'],
        'scalar_refused'=>$scalar['value']===false&&$scalar['code']===-10020&&$scalar['facility']===2&&$scalar['warning']&&$scalar['message_present']];
    $observations=['states'=>$states,'wrong_attribute'=>$wrong,'not_collection'=>$scalar,
        'nullable_form_policy'=>'SQL NULL unknown; empty collection explicitly no tags; NULL member needs correction'];

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

c170Report('cub170-collection-state','Форма заполнения: не перепутать неизвестный набор, пустой набор и NULL-элемент',$rows,$checks,$observations,$runtime,$owned,$removed);

SQL NULL — не заполнено; размер -1
Пустая коллекция {} — подтверждено: меток нет; размер 0
Коллекция {NULL} — требуется заполнить один элемент; размер 1
Массивы первых двух одинаковы — да
Неизвестный атрибут: код — -202
Обычная строка вместо коллекции: код — -10020

Распакуйте весь 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;}

    $name=c170OwnName($db,$owned,'TABLE','membership');$t=c170Qualified($name);
    c170Ddl($db,'CREATE TABLE '.$t.' (id INT PRIMARY KEY,title VARCHAR(80),tags SET(VARCHAR(40))) DONT_REUSE_OID');
    c170Command($db,"INSERT INTO $t (id,title,tags) VALUES (?, ?, {'pickup'})",[10,'Шкаф']);
    c170Command($db,"INSERT INTO $t (id,title,tags) VALUES (?, ?, {'pickup'})",[20,'Полка']);
    c170Commit($db);
    $oid=selectedOid170($db,$t,10);$original=collection170($db,$oid,'tags');
    change170(cubrid_set_add($db,$oid,'tags','delivery-only'));
    $preview=sorted170(collection170($db,$oid,'tags'));
    $conflict=in_array('pickup',$preview,true)&&in_array('delivery-only',$preview,true);
    if(!$conflict){throw new RuntimeException('Ожидался конфликт правил выдачи');}
    c170Rollback($db);
    $afterCancel=collection170($db,selectedOid170($db,$t,10),'tags');
    // A new allowed choice is validated before the two writes.
    $requested='delivery-only';$allowed=['pickup','delivery-only'];
    if(!in_array($requested,$allowed,true)){throw new InvalidArgumentException('Неизвестный способ выдачи');}
    $oid=selectedOid170($db,$t,10);
    try{
        change170(cubrid_set_drop($db,$oid,'tags','pickup'));
        change170(cubrid_set_add($db,$oid,'tags',$requested));
        $candidate=collection170($db,$oid,'tags');
        if($candidate!==['delivery-only']){throw new RuntimeException('Неверный итоговый набор');}
        c170Commit($db);
    }catch(Throwable $failure){c170Rollback($db);throw $failure;}
    $saved=collection170($db,selectedOid170($db,$t,10),'tags');
    $neighbor=collection170($db,selectedOid170($db,$t,20),'tags');c170Commit($db);
    $rows=[['Исходный способ выдачи',implode(', ',$original)],['Предпросмотр',implode(', ',$preview)],
        ['Конфликт обнаружен',$conflict],['После отмены',implode(', ',$afterCancel)],
        ['Сохранённый способ для шкафа',implode(', ',$saved)],['Способ для полки',implode(', ',$neighbor)]];
    $checks=['original_pickup'=>$original===['pickup'],'preview_conflict'=>$preview===['delivery-only','pickup']&&$conflict,
        'rollback_restored'=>$afterCancel===$original,'requested_allowed'=>in_array($requested,$allowed,true),
        'saved_new_policy'=>$saved===['delivery-only'],'no_removed_pickup'=>!in_array('pickup',$saved,true),
        'neighbor_unchanged'=>$neighbor===['pickup']];
    $observations=['original'=>$original,'preview'=>$preview,'after_rollback'=>$afterCancel,
        'saved'=>$saved,'neighbor'=>$neighbor,'allowed_values'=>$allowed,
        'policy'=>'pickup and delivery-only are mutually exclusive for this item'];

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

c170Report('cub170-membership-save','Изменение способов выдачи: отменить противоречивый набор и сохранить корректный',$rows,$checks,$observations,$runtime,$owned,$removed);

Исходный способ выдачи — pickup
Предпросмотр — delivery-only, pickup
Конфликт обнаружен — да
После отмены — pickup
Сохранённый способ для шкафа — delivery-only
Способ для полки — pickup

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