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

<?php
declare(strict_types=1);
require __DIR__.'/lab.php';

$config = x145Config();
$session = mysql_xdevapi\getSession($config['uri']);
$schema = null;
$owned = [];
$removed = [];
$rows = $checks = $observations = [];
try {
    $schema = $session->getSchema($config['schema']);
    if (!$schema->existsInDatabase()) {
        throw new RuntimeException('Учебная схема не существует: подготовьте её отдельно.');
    }
    $runtime = ['php'=>PHP_VERSION, 'extension'=>phpversion('mysql_xdevapi'),
        'server_version'=>$session->getServerVersion(), 'schema'=>$config['schema'],
        'host'=>$config['host'], 'port'=>$config['port']];
    $name = x145Name('catalog_publish');
    x145Qualified($schema, $name);
    $handle = $schema->getCollection($name);
    $existsBefore = $handle->existsInDatabase();
    if ($existsBefore) { throw new RuntimeException('Случайное имя коллекции уже занято.'); }
    $collection = $schema->createCollection($name);
    $owned[] = ['type'=>'COLLECTION', 'name'=>$name];
    $documents = [
        ['sku'=>'CABLE', 'name'=>'Кабель', 'price_kopecks'=>12000, 'state'=>'published'],
        ['sku'=>'LAMP', 'name'=>'Светильник', 'price_kopecks'=>89000, 'state'=>'published'],
    ];
    $command = $collection->add($documents[0])->add($documents[1]);
    $beforeExecute = $collection->find('true')->fields(['sku','name','price_kopecks','state'])->sort('sku ASC')->execute()->fetchAll();
    $receipt = $command->execute();
    $ids = $receipt->getGeneratedIds();
    $readById = [];
    foreach ($ids as $id) { $readById[] = $collection->getOne($id); }
    $saved = $collection->find('true')->fields(['_id','sku','name','price_kopecks','state'])->sort('sku ASC')->execute()->fetchAll();
    $idsSorted = $ids;
    $savedIds = array_column($saved, '_id');
    sort($idsSorted, SORT_STRING);
    sort($savedIds, SORT_STRING);
    $byIdSkus = array_column($readById, 'sku');
    sort($byIdSkus, SORT_STRING);
    $publicDocuments = [];
    foreach ($saved as $document) {
        $publicDocuments[] = ['sku'=>$document['sku'], 'name'=>$document['name'],
            'price_kopecks'=>$document['price_kopecks'], 'state'=>$document['state']];
    }
    $rows = [['Коллекция существовала до createCollection', $existsBefore],
        ['Карточек до execute', count($beforeExecute)], ['Сохранено карточек', count($saved)],
        ['Первый товар', $saved[0]['name']], ['Цена первого товара, коп.', $saved[0]['price_kopecks']],
        ['Второй товар', $saved[1]['name']], ['Цена второго товара, коп.', $saved[1]['price_kopecks']],
        ['Получено созданных ID', count($ids)], ['ID совпали с сохранёнными документами', $idsSorted === $savedIds]];
    $checks = ['handle_not_creation'=>$existsBefore === false, 'deferred_add'=>$beforeExecute === [],
        'saved_documents'=>$publicDocuments === $documents, 'generated_count'=>count($ids) === 2,
        'generated_nonempty'=>count(array_filter($ids, static fn($id)=>is_string($id) && $id !== '')) === 2,
        'generated_unique'=>count(array_unique($ids)) === 2, 'ids_match'=>$idsSorted === $savedIds,
        'read_by_id'=>$byIdSkus === ['CABLE','LAMP'], 'affected'=>$receipt->getAffectedItemsCount() === 2,
        'factory_types'=>$schema instanceof mysql_xdevapi\Schema && $collection instanceof mysql_xdevapi\Collection
            && $command instanceof mysql_xdevapi\CollectionAdd && $receipt instanceof mysql_xdevapi\Result];
    $observations = ['schema_class'=>get_debug_type($schema), 'handle_class'=>get_debug_type($handle),
        'collection_class'=>get_debug_type($collection), 'command_class'=>get_debug_type($command),
        'receipt_class'=>get_debug_type($receipt), 'existed_before'=>$existsBefore, 'input_documents'=>$documents,
        'before_execute'=>$beforeExecute, 'generated_ids'=>$ids, 'read_by_id'=>$readById,
        'saved_documents'=>$saved, 'public_documents'=>$publicDocuments, 'affected'=>$receipt->getAffectedItemsCount()];
} finally {
    try {
        if ($schema instanceof mysql_xdevapi\Schema) {
            $removed = x145Cleanup($schema, $owned);
        }
    } finally {
        $session->close();
    }
}
x145Report('mysql145-x-factory-catalog-publish', 'Создать каталог и сохранить две карточки с настоящими ID', $rows, $checks, $observations, $runtime, $owned, $removed);

Коллекция существовала до createCollection — нет
Карточек до execute — 0
Сохранено карточек — 2
Первый товар — Кабель
Цена первого товара, коп. — 12000
Второй товар — Светильник
Цена второго товара, коп. — 89000
Получено созданных ID — 2
ID совпали с сохранёнными документами — да

Запускайте отдельным процессом PHP по README. Полный файл создаёт одну собственную коллекцию, выполняет показанные операции, перечитывает фактические документы и в finally удаляет только свой учебный объект. result.html показывает результат, result.json — документы и наблюдения, metrics.json — проверки.

<?php
declare(strict_types=1);
require __DIR__.'/lab.php';

$config = x145Config();
$session = mysql_xdevapi\getSession($config['uri']);
$schema = null;
$owned = [];
$removed = [];
$rows = $checks = $observations = [];
try {
    $schema = $session->getSchema($config['schema']);
    if (!$schema->existsInDatabase()) {
        throw new RuntimeException('Учебная схема не существует: подготовьте её отдельно.');
    }
    $runtime = ['php'=>PHP_VERSION, 'extension'=>phpversion('mysql_xdevapi'),
        'server_version'=>$session->getServerVersion(), 'schema'=>$config['schema'],
        'host'=>$config['host'], 'port'=>$config['port']];
    $name = x145OwnCollection($schema, $owned, 'filtered_feed');
    $collection = $schema->getCollection($name);
    $documents = [
        ['_id'=>'CABLE','sku'=>'CABLE','name'=>'Кабель','price_kopecks'=>12000,'stock'=>8,'state'=>'published'],
        ['_id'=>'LED','sku'=>'LED','name'=>'LED-лампа','price_kopecks'=>12000,'stock'=>3,'state'=>'published'],
        ['_id'=>'LAMP','sku'=>'LAMP','name'=>'Светильник','price_kopecks'=>89000,'stock'=>2,'state'=>'published'],
        ['_id'=>'DRAFT','sku'=>'DRAFT','name'=>'Новый товар','price_kopecks'=>9900,'stock'=>4,'state'=>'draft'],
        ['_id'=>'EMPTY','sku'=>'EMPTY','name'=>'Распроданный товар','price_kopecks'=>1000,'stock'=>0,'state'=>'published'],
    ];
    foreach ($documents as $document) { $collection->add($document)->execute(); }
    $command = $collection->find('state = :state AND stock > :minimum')
        ->fields(['sku','name','price_kopecks'])->sort('price_kopecks ASC','sku ASC')->limit(2)
        ->bind(['state'=>'published','minimum'=>0]);
    $result = $command->execute();
    $selected = $result->fetchAll();
    $emptyResult = $collection->find('state = :state AND stock > :minimum')
        ->fields(['sku','name','price_kopecks'])->bind(['state'=>'published','minimum'=>100])->execute();
    $empty = $emptyResult->fetchAll();
    $expected = [
        ['sku'=>'CABLE','name'=>'Кабель','price_kopecks'=>12000],
        ['sku'=>'LED','name'=>'LED-лампа','price_kopecks'=>12000],
    ];
    $fieldSets = [];
    foreach ($selected as $document) { $keys = array_keys($document); sort($keys, SORT_STRING); $fieldSets[] = $keys; }
    $rows = [['Всего карточек в учебном каталоге', $collection->count()], ['Карточек для витрины', count($selected)],
        ['Первый артикул', $selected[0]['sku']], ['Первое название', $selected[0]['name']], ['Первая цена, коп.', $selected[0]['price_kopecks']],
        ['Второй артикул', $selected[1]['sku']], ['Второе название', $selected[1]['name']], ['Вторая цена, коп.', $selected[1]['price_kopecks']],
        ['Только три нужных поля', $fieldSets === [['name','price_kopecks','sku'],['name','price_kopecks','sku']]],
        ['При остатке больше 100 карточек найдено', count($empty)]];
    $checks = ['source_count'=>$collection->count() === 5, 'selected_data'=>$selected == $expected,
        'stable_order'=>array_column($selected, 'sku') === ['CABLE','LED'],
        'projection'=>$fieldSets === [['name','price_kopecks','sku'],['name','price_kopecks','sku']],
        'excluded_rows'=>array_intersect(array_column($selected, 'sku'), ['DRAFT','EMPTY','LAMP']) === [],
        'empty_array'=>$empty === [], 'no_warnings'=>$result->getWarningsCount() === 0,
        'factory_types'=>$command instanceof mysql_xdevapi\CollectionFind && $result instanceof mysql_xdevapi\DocResult];
    $observations = ['input_documents'=>$documents, 'command_class'=>get_debug_type($command),
        'result_class'=>get_debug_type($result), 'selected_documents'=>$selected, 'field_sets'=>$fieldSets,
        'empty_result'=>$empty, 'warning_count'=>$result->getWarningsCount(),
        'selection'=>['state'=>'published','stock_greater_than'=>0,'order'=>['price_kopecks ASC','sku ASC'],'limit'=>2]];
} finally {
    try {
        if ($schema instanceof mysql_xdevapi\Schema) {
            $removed = x145Cleanup($schema, $owned);
        }
    } finally {
        $session->close();
    }
}
x145Report('mysql145-x-factory-filtered-feed', 'Получить две доступные карточки для витрины без выгрузки всего каталога', $rows, $checks, $observations, $runtime, $owned, $removed);

Всего карточек в учебном каталоге — 5
Карточек для витрины — 2
Первый артикул — CABLE
Первое название — Кабель
Первая цена, коп. — 12000
Второй артикул — LED
Второе название — LED-лампа
Вторая цена, коп. — 12000
Только три нужных поля — да
При остатке больше 100 карточек найдено — 0

Запускайте отдельным процессом PHP по README. Полный файл создаёт одну собственную коллекцию, выполняет показанные операции, перечитывает фактические документы и в finally удаляет только свой учебный объект. result.html показывает результат, result.json — документы и наблюдения, metrics.json — проверки.

<?php
declare(strict_types=1);
require __DIR__.'/lab.php';

$config = x145Config();
$session = mysql_xdevapi\getSession($config['uri']);
$schema = null;
$owned = [];
$removed = [];
$rows = $checks = $observations = [];
try {
    $schema = $session->getSchema($config['schema']);
    if (!$schema->existsInDatabase()) {
        throw new RuntimeException('Учебная схема не существует: подготовьте её отдельно.');
    }
    $runtime = ['php'=>PHP_VERSION, 'extension'=>phpversion('mysql_xdevapi'),
        'server_version'=>$session->getServerVersion(), 'schema'=>$config['schema'],
        'host'=>$config['host'], 'port'=>$config['port']];
    $name = x145OwnCollection($schema, $owned, 'change_review');
    $collection = $schema->getCollection($name);
    $documents = [
        ['_id'=>'LED','sku'=>'LED','name'=>'LED-лампа','price_kopecks'=>12000,'stock'=>3,'state'=>'draft'],
        ['_id'=>'CABLE','sku'=>'CABLE','name'=>'Кабель','price_kopecks'=>5000,'stock'=>8,'state'=>'published'],
    ];
    foreach ($documents as $document) { $collection->add($document)->execute(); }
    $before = $collection->getOne('LED');
    $neighborBefore = $collection->getOne('CABLE');
    $command = $collection->modify('_id = :id')->set('price_kopecks', 13500)->set('state', 'published')->bind(['id'=>'LED']);
    $prepared = $collection->getOne('LED');
    $receipt = $command->execute();
    $after = $collection->getOne('LED');
    $neighborAfter = $collection->getOne('CABLE');
    $missingReceipt = $collection->modify('_id = :id')->set('price_kopecks', 15000)->bind(['id'=>'MISSING'])->execute();
    $afterMissing = $collection->getOne('LED');
    $rows = [['Цена до подготовки, коп.', $before['price_kopecks']], ['Цена до execute, коп.', $prepared['price_kopecks']],
        ['Статус до execute', $prepared['state']], ['Цена после execute, коп.', $after['price_kopecks']],
        ['Статус после execute', $after['state']], ['Остаток сохранён', $after['stock']],
        ['Соседняя карточка не изменилась', $neighborAfter === $neighborBefore],
        ['Найдено для изменения LED', $receipt->getAffectedItemsCount()],
        ['Найдено для отсутствующего ID', $missingReceipt->getAffectedItemsCount()]];
    $checks = ['not_executed'=>$prepared === $before, 'price_saved'=>$after['price_kopecks'] === 13500,
        'published'=>$after['state'] === 'published', 'retained_fields'=>$after['sku'] === 'LED' && $after['name'] === 'LED-лампа' && $after['stock'] === 3,
        'neighbor_unchanged'=>$neighborBefore === $neighborAfter,
        'affected'=>$receipt->getAffectedItemsCount() === 1, 'missing_no_match'=>$missingReceipt->getAffectedItemsCount() === 0,
        'missing_no_insert'=>$collection->count() === 2 && $afterMissing === $after,
        'factory_types'=>$command instanceof mysql_xdevapi\CollectionModify && $receipt instanceof mysql_xdevapi\Result];
    $observations = ['before'=>$before, 'after_preparation'=>$prepared, 'after_execute'=>$after,
        'neighbor_before'=>$neighborBefore, 'neighbor_after'=>$neighborAfter,
        'command_class'=>get_debug_type($command), 'receipt_class'=>get_debug_type($receipt),
        'affected'=>$receipt->getAffectedItemsCount(), 'missing_affected'=>$missingReceipt->getAffectedItemsCount(), 'after_missing'=>$afterMissing];
} finally {
    try {
        if ($schema instanceof mysql_xdevapi\Schema) {
            $removed = x145Cleanup($schema, $owned);
        }
    } finally {
        $session->close();
    }
}
x145Report('mysql145-x-factory-change-review', 'Проверить карточку до и после команды публикации', $rows, $checks, $observations, $runtime, $owned, $removed);

Цена до подготовки, коп. — 12000
Цена до execute, коп. — 12000
Статус до execute — draft
Цена после execute, коп. — 13500
Статус после execute — published
Остаток сохранён — 3
Соседняя карточка не изменилась — да
Найдено для изменения LED — 1
Найдено для отсутствующего ID — 0

Запускайте отдельным процессом PHP по README. Полный файл создаёт одну собственную коллекцию, выполняет показанные операции, перечитывает фактические документы и в finally удаляет только свой учебный объект. result.html показывает результат, result.json — документы и наблюдения, metrics.json — проверки.

<?php
declare(strict_types=1);
require __DIR__.'/lab.php';

$config = x145Config();
$session = mysql_xdevapi\getSession($config['uri']);
$schema = null;
$owned = [];
$removed = [];
$rows = $checks = $observations = [];
try {
    $schema = $session->getSchema($config['schema']);
    if (!$schema->existsInDatabase()) {
        throw new RuntimeException('Учебная схема не существует: подготовьте её отдельно.');
    }
    $runtime = ['php'=>PHP_VERSION, 'extension'=>phpversion('mysql_xdevapi'),
        'server_version'=>$session->getServerVersion(), 'schema'=>$config['schema'],
        'host'=>$config['host'], 'port'=>$config['port']];
    $name = x145OwnCollection($schema, $owned, 'draft_removal');
    $collection = $schema->getCollection($name);
    $documents = [
        ['_id'=>'OLD-A','sku'=>'OLD-A','state'=>'draft','updated'=>'2025-10-01'],
        ['_id'=>'OLD-B','sku'=>'OLD-B','state'=>'draft','updated'=>'2025-12-15'],
        ['_id'=>'NEW','sku'=>'NEW','state'=>'draft','updated'=>'2026-10-01'],
        ['_id'=>'KEEP','sku'=>'KEEP','state'=>'published','updated'=>'2024-01-01'],
        ['_id'=>'ARCHIVE','sku'=>'ARCHIVE','state'=>'archived','updated'=>'2024-01-01'],
    ];
    foreach ($documents as $document) { $collection->add($document)->execute(); }
    $before = $collection->find('true')->sort('sku ASC')->execute()->fetchAll();
    $cutoff = '2026-01-01';
    $candidateResult = $collection->find('state = :state AND updated < :cutoff')
        ->fields(['sku','updated'])->sort('sku ASC')->limit(2)->bind(['state'=>'draft','cutoff'=>$cutoff])->execute();
    $candidates = $candidateResult->fetchAll();
    $command = $collection->remove('state = :state AND updated < :cutoff')
        ->sort('sku ASC')->limit(2)->bind(['state'=>'draft','cutoff'=>$cutoff]);
    $prepared = $collection->find('true')->sort('sku ASC')->execute()->fetchAll();
    $receipt = $command->execute();
    $remaining = $collection->find('true')->sort('sku ASC')->execute()->fetchAll();
    $preserved = [];
    foreach ($before as $document) {
        if (!in_array($document['sku'], ['OLD-A','OLD-B'], true)) { $preserved[] = $document; }
    }
    $rows = [['До удаления карточек', count($before)], ['Предпросмотр кандидатов', implode(', ', array_column($candidates, 'sku'))],
        ['До execute карточек', count($prepared)], ['Удалено карточек', $receipt->getAffectedItemsCount()],
        ['После удаления карточек', count($remaining)], ['Остались артикулы', implode(', ', array_column($remaining, 'sku'))],
        ['Опубликованный товар сохранён', $collection->getOne('KEEP')['state'] === 'published'],
        ['Свежий черновик сохранён', $collection->getOne('NEW')['state'] === 'draft'],
        ['Оставшиеся документы не изменены', $remaining === $preserved]];
    $checks = ['preview_ids'=>array_column($candidates, 'sku') === ['OLD-A','OLD-B'],
        'deferred_remove'=>$prepared === $before, 'affected'=>$receipt->getAffectedItemsCount() === 2,
        'remaining_ids'=>array_column($remaining, 'sku') === ['ARCHIVE','KEEP','NEW'],
        'preserved_documents'=>$remaining === $preserved, 'count_after'=>count($remaining) === 3,
        'factory_types'=>$command instanceof mysql_xdevapi\CollectionRemove && $receipt instanceof mysql_xdevapi\Result];
    $observations = ['cutoff'=>$cutoff, 'before'=>$before, 'candidates'=>$candidates,
        'after_preparation'=>$prepared, 'remaining'=>$remaining, 'command_class'=>get_debug_type($command),
        'receipt_class'=>get_debug_type($receipt), 'affected'=>$receipt->getAffectedItemsCount(),
        'selection'=>['state'=>'draft','updated_before'=>$cutoff,'order'=>'sku ASC','limit'=>2]];
} finally {
    try {
        if ($schema instanceof mysql_xdevapi\Schema) {
            $removed = x145Cleanup($schema, $owned);
        }
    } finally {
        $session->close();
    }
}
x145Report('mysql145-x-factory-draft-removal', 'Удалить только устаревшие черновики и показать оставшиеся карточки', $rows, $checks, $observations, $runtime, $owned, $removed);

До удаления карточек — 5
Предпросмотр кандидатов — OLD-A, OLD-B
До execute карточек — 5
Удалено карточек — 2
После удаления карточек — 3
Остались артикулы — ARCHIVE, KEEP, NEW
Опубликованный товар сохранён — да
Свежий черновик сохранён — да
Оставшиеся документы не изменены — да

Запускайте отдельным процессом PHP по README. Полный файл создаёт одну собственную коллекцию, выполняет показанные операции, перечитывает фактические документы и в finally удаляет только свой учебный объект. result.html показывает результат, result.json — документы и наблюдения, metrics.json — проверки.