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

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

$config = x143Config();
$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']];

    $configured = $session->getSchema($config['schema']);
    $missingName = x143Name('missing_schema');
    $missing = $session->getSchema($missingName);
    $default = $session->getDefaultSchema();
    $configuredExists = $configured->existsInDatabase();
    $missingExists = $missing->existsInDatabase();
    $namesMatch = $configured->getName() === $config['schema'];
    $missingNamePreserved = $missing->getName() === $missingName;
    $rows = [['Настроенная схема существует',$configuredExists ? 'да' : 'нет'],
        ['Имя объекта совпало с настройкой',$namesMatch ? 'да' : 'нет'],
        ['Объект несуществующей схемы получен',get_debug_type($missing)],
        ['Несуществующая схема найдена на сервере',$missingExists ? 'да' : 'нет'],
        ['Схема по умолчанию в учебном URI',$default === null ? 'не задана' : 'задана']];
    $checks = ['configured_schema_exists'=>$configuredExists && $namesMatch,
        'handle_does_not_create_schema'=>$missing instanceof mysql_xdevapi\Schema && !$missingExists && $missingNamePreserved,
        'default_schema_is_nullable'=>$default === null,
        'schema_implements_database_object'=>$configured instanceof mysql_xdevapi\DatabaseObject];
    $observations = ['configured_name'=>$configured->getName(),'missing_name'=>$missing->getName(),
        'configured_exists'=>$configuredExists,'missing_exists'=>$missingExists,
        'default_schema_type'=>get_debug_type($default),
        'default_schema_name'=>$default instanceof mysql_xdevapi\Schema ? $default->getName() : null];

} finally {
    try {
        if ($schema instanceof mysql_xdevapi\Schema) {
            $removed = x143Cleanup($schema, $owned);
        }
    } finally {
        $session->close();
    }
}

x143Report('mysql143-x-schema-handle-and-existence', 'Отличить имя схемы от существующей базы', $rows, $checks, $observations, $runtime, $owned, $removed);

Настроенная схема существует — да
Имя объекта совпало с настройкой — да
Объект несуществующей схемы получен — mysql_xdevapi\Schema
Несуществующая схема найдена на сервере — нет
Схема по умолчанию в учебном URI — не задана

CLI-программа использует отдельную учебную схему, создаёт только собственные объекты, выполняет запросы, сохраняет readback и очищает созданные объекты. result.html показывает итог, result.json — настоящие данные и типы. Это не HTTP-обработчик.

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

$config = x143Config();
$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']];

function locateObject(mysql_xdevapi\SchemaObject $object): array {
    $parent = $object->getSchema();
    if (!$parent instanceof mysql_xdevapi\Schema) {throw new RuntimeException('Не получена схема объекта.');}
    return ['name'=>$object->getName(), 'schema'=>$parent->getName()];
}

    $name = x143OwnCollection($schema,$owned,'object_graph');
    $catalog = $schema->getCollection($name);
    $catalog->add(['_id'=>'kept','sku'=>'LED','stock'=>5])->execute();
    $parent = $catalog->getSchema();
    if (!$parent instanceof mysql_xdevapi\Schema) {throw new RuntimeException('Не получена родительская схема.');}
    // Keep both wrappers alive until the outer cleanup is complete.
    $fromCollection = $catalog->getSession();
    $fromSchema = $parent->getSession();
    $sessionWrappers = [$fromCollection,$fromSchema];
    $location = locateObject($catalog);
    $fromCollectionSchema = $fromCollection->getSchema($config['schema']);
    $sameCatalog = $fromCollectionSchema->getCollection($name);
    $session->startTransaction();
    $transactionOpen = true;
    try {
        $catalog->add(['_id'=>'draft','sku'=>'CABLE','stock'=>2])->execute();
        $during = $sameCatalog->getOne('draft');
        $fromSchema->rollback();
        $transactionOpen = false;
    } finally {
        if ($transactionOpen) {$session->rollback();}
    }
    $afterRows = $catalog->find('_id = :id')->bind(['id'=>'draft'])->limit(1)->execute()->fetchAll();
    $after = $afterRows[0] ?? null;
    $kept = $catalog->getOne('kept');
    $rows = [['Объект коллекции',get_debug_type($catalog)],['Родительский объект',get_debug_type($parent)],
        ['Имя коллекции найдено через интерфейс',$location['name'] === $name ? 'да' : 'нет'],
        ['Черновик виден через полученный Session',$during['sku'] ?? 'не найден'],
        ['Черновик после rollback',$after === null ? 'не найден' : 'сохранился'],
        ['Ранее сохранённый товар',$kept['sku']]];
    $checks = ['object_graph_matches'=>$location === ['name'=>$name,'schema'=>$config['schema']]
            && $catalog instanceof mysql_xdevapi\SchemaObject && $catalog instanceof mysql_xdevapi\DatabaseObject,
        'wrapper_reads_same_transaction'=>($during['sku'] ?? null) === 'CABLE',
        'wrapper_rollback_is_shared'=>$afterRows === [] && $after === null && $kept['sku'] === 'LED',
        'session_wrappers_are_retained'=>count($sessionWrappers) === 2
            && $fromCollection instanceof mysql_xdevapi\Session && $fromSchema instanceof mysql_xdevapi\Session];
    $observations = ['location'=>$location,'during_transaction'=>$during,'after_rollback_rows'=>$afterRows,'after_rollback'=>$after,'kept'=>$kept,
        'original_session_object_id'=>spl_object_id($session),
        'collection_session_object_id'=>spl_object_id($fromCollection),
        'schema_session_object_id'=>spl_object_id($fromSchema)];

} finally {
    try {
        if ($schema instanceof mysql_xdevapi\Schema) {
            $removed = x143Cleanup($schema, $owned);
        }
    } finally {
        $session->close();
    }
}

x143Report('mysql143-x-collection-schema-session', 'Найти родителей коллекции и сохранить общую транзакцию', $rows, $checks, $observations, $runtime, $owned, $removed);

Объект коллекции — mysql_xdevapi\Collection
Родительский объект — mysql_xdevapi\Schema
Имя коллекции найдено через интерфейс — да
Черновик виден через полученный Session — CABLE
Черновик после rollback — не найден
Ранее сохранённый товар — LED

CLI-программа использует отдельную учебную схему, создаёт только собственные объекты, выполняет запросы, сохраняет readback и очищает созданные объекты. result.html показывает итог, result.json — настоящие данные и типы. Это не HTTP-обработчик.

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

$config = x143Config();
$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']];

    $activeName = x143OwnCollection($schema,$owned,'active_catalog');
    $archiveName = x143OwnCollection($schema,$owned,'archive_catalog');
    $tableName = x143OwnTable($session,$schema,$owned,'import_log','(id INT PRIMARY KEY, note VARCHAR(40)) ENGINE=InnoDB');
    $schema->getCollection($activeName)->add(['_id'=>'LED','sku'=>'LED'],['_id'=>'CABLE','sku'=>'CABLE'])->execute();
    $schema->getCollection($archiveName)->add(['_id'=>'OLD','sku'=>'OLD'])->execute();
    $collections = $schema->getCollections();
    $labels = [$activeName=>'Действующий каталог',$archiveName=>'Архив'];
    $listed = [];
    foreach ($labels as $collectionName=>$label) {
        $object = $collections[$collectionName] ?? null;
        if (!$object instanceof mysql_xdevapi\Collection) {throw new RuntimeException('Собственная коллекция отсутствует в списке.');}
        $parent = $object->getSchema();
        $listed[] = ['label'=>$label,'name'=>$object->getName(),'key'=>$collectionName,
            'schema'=>$parent instanceof mysql_xdevapi\Schema ? $parent->getName() : null,
            'documents'=>$object->count(),'type'=>get_debug_type($object)];
    }
    $tablePresent = $schema->getTable($tableName)->existsInDatabase();
    $tableIsCollection = array_key_exists($tableName,$collections);
    $rows = [['Действующий каталог: документов',$listed[0]['documents']],['Архив: документов',$listed[1]['documents']],
        ['Значения списка являются Collection',$listed[0]['type']],
        ['Обычная таблица журнала существует',$tablePresent ? 'да' : 'нет'],
        ['Журнал попал в список коллекций',$tableIsCollection ? 'да' : 'нет']];
    $checks = ['owned_collections_are_listed'=>count($listed) === 2 && $listed[0]['name'] === $activeName && $listed[1]['name'] === $archiveName,
        'names_are_array_keys'=>$listed[0]['name'] === $listed[0]['key'] && $listed[1]['name'] === $listed[1]['key'],
        'counts_are_documents_not_objects'=>$listed[0]['documents'] === 2 && $listed[1]['documents'] === 1,
        'table_is_not_collection'=>$tablePresent && !$tableIsCollection,
        'parents_match'=>$listed[0]['schema'] === $config['schema'] && $listed[1]['schema'] === $config['schema']];
    $observations = ['owned_collections'=>$listed,'owned_table_name'=>$tableName,
        'table_exists'=>$tablePresent,'table_is_listed_as_collection'=>$tableIsCollection];

} finally {
    try {
        if ($schema instanceof mysql_xdevapi\Schema) {
            $removed = x143Cleanup($schema, $owned);
        }
    } finally {
        $session->close();
    }
}

x143Report('mysql143-x-list-owned-collections', 'Получить список коллекций, а затем нужные сведения', $rows, $checks, $observations, $runtime, $owned, $removed);

Действующий каталог: документов — 2
Архив: документов — 1
Значения списка являются Collection — mysql_xdevapi\Collection
Обычная таблица журнала существует — да
Журнал попал в список коллекций — нет

CLI-программа использует отдельную учебную схему, создаёт только собственные объекты, выполняет запросы, сохраняет readback и очищает созданные объекты. result.html показывает итог, result.json — настоящие данные и типы. Это не HTTP-обработчик.

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

$config = x143Config();
$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 = x143OwnCollection($schema,$owned,'table_bridge');
    $catalog = $schema->getCollection($name);
    $catalog->add(['_id'=>'LED','sku'=>'LED','stock'=>5],['_id'=>'CABLE','sku'=>'CABLE','stock'=>2])->execute();
    $table = $schema->getCollectionAsTable($name);
    $before = $catalog->getOne('LED');
    $projection = ["JSON_UNQUOTE(JSON_EXTRACT(doc, '$.sku')) AS sku",
        "CAST(JSON_UNQUOTE(JSON_EXTRACT(doc, '$.stock')) AS UNSIGNED) AS stock"];
    $tableBefore = $table->select($projection)->where('_id = :id')->bind(['id'=>'LED'])->execute()->fetchOne();
    $catalog->modify('_id = :id')->set('stock',4)->bind(['id'=>'LED'])->execute();
    $tableAfter = $table->select($projection)->where('_id = :id')->bind(['id'=>'LED'])->execute()->fetchOne();
    $after = $catalog->getOne('LED');
    $other = $catalog->getOne('CABLE');
    $rows = [['Исходный документ: SKU',$before['sku']],['Исходный документ: остаток',$before['stock']],
        ['Table до изменения: остаток',$tableBefore['stock']],['Table после изменения: остаток',$tableAfter['stock']],
        ['Collection после изменения: остаток',$after['stock']],['Соседний товар: остаток',$other['stock']]];
    $checks = ['same_collection_name'=>$table->getName() === $catalog->getName(),
        'projection_matches_document'=>$tableBefore['sku'] === 'LED' && $tableBefore['stock'] === 5 && $before['stock'] === 5,
        'table_sees_document_change'=>$tableAfter['stock'] === 4 && $after['stock'] === 4,
        'neighbor_is_unchanged'=>$other['stock'] === 2,
        'bridge_returns_table'=>$table instanceof mysql_xdevapi\Table];
    $observations = ['collection_type'=>get_debug_type($catalog),'table_type'=>get_debug_type($table),
        'before_document'=>$before,'before_projection'=>$tableBefore,'after_document'=>$after,'after_projection'=>$tableAfter,
        'stock_sql_type'=>get_debug_type($tableAfter['stock']),'neighbor'=>$other];

} finally {
    try {
        if ($schema instanceof mysql_xdevapi\Schema) {
            $removed = x143Cleanup($schema, $owned);
        }
    } finally {
        $session->close();
    }
}

x143Report('mysql143-x-collection-table-bridge', 'Прочитать один каталог через Collection и Table', $rows, $checks, $observations, $runtime, $owned, $removed);

Исходный документ: SKU — LED
Исходный документ: остаток — 5
Table до изменения: остаток — 5
Table после изменения: остаток — 4
Collection после изменения: остаток — 4
Соседний товар: остаток — 2

CLI-программа использует отдельную учебную схему, создаёт только собственные объекты, выполняет запросы, сохраняет readback и очищает созданные объекты. result.html показывает итог, result.json — настоящие данные и типы. Это не HTTP-обработчик.

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

$config = x143Config();
$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']];

function chooseReportField(string $choice): string {
    $allowed = ['price'=>'price_cents','stock'=>'stock'];
    if (!array_key_exists($choice,$allowed)) {
        throw new InvalidArgumentException('Неизвестный вариант отчёта.');
    }
    return $allowed[$choice];
}

    $name = x143OwnTable($session,$schema,$owned,'report_choice',
        '(id INT PRIMARY KEY, title VARCHAR(80) NOT NULL, price_cents INT NOT NULL, stock INT NOT NULL) ENGINE=InnoDB');
    $catalog = $schema->getTable($name);
    $catalog->insert(['id','title','price_cents','stock'])->values([1,"Maker's lamp",1250,5])->values([2,'Cable',300,2])->execute();
    $field = chooseReportField('price');
    $qualified = $session->quoteName($schema->getName()).'.'.$session->quoteName($name);
    $sql = 'SELECT '.$session->quoteName($field).' AS selected_value FROM '.$qualified
        .' WHERE '.$session->quoteName('title').' = ?';
    $found = $session->sql($sql)->bind("Maker's lamp")->execute()->fetchAll();
    $rejected = false;
    try {chooseReportField('password_hash');}
    catch (InvalidArgumentException $error) {$rejected = true;}
    $quoted = $session->quoteName('price`retail');
    $literal = $session->sql('SELECT ? AS selected_value')->bind('price_cents')->execute()->fetchOne();
    $rows = [['Разрешённый столбец',$field],['Цена найденной лампы в копейках',$found[0]['selected_value']],
        ['Найдено строк',count($found)],['Неизвестный вариант отклонён',$rejected ? 'да' : 'нет'],
        ['Обратная кавычка внутри имени',$quoted],['Если передать имя как значение',$literal['selected_value']]];
    $checks = ['allowlist_selects_expected_field'=>$field === 'price_cents',
        'quoted_value_is_bound'=>count($found) === 1 && $found[0]['selected_value'] === 1250,
        'unknown_identifier_is_rejected'=>$rejected,
        'backtick_is_escaped'=>$quoted === '`price``retail`',
        'placeholder_represents_value'=>$literal['selected_value'] === 'price_cents'];
    $observations = ['selected_field'=>$field,'sql_template'=>$sql,'matched_rows'=>$found,
        'invalid_choice_rejected'=>$rejected,'quoted_identifier'=>$quoted,'bound_literal'=>$literal];

} finally {
    try {
        if ($schema instanceof mysql_xdevapi\Schema) {
            $removed = x143Cleanup($schema, $owned);
        }
    } finally {
        $session->close();
    }
}

x143Report('mysql143-x-identifier-and-value', 'Отделить выбранный столбец от значения фильтра', $rows, $checks, $observations, $runtime, $owned, $removed);

Разрешённый столбец — price_cents
Цена найденной лампы в копейках — 1250
Найдено строк — 1
Неизвестный вариант отклонён — да
Обратная кавычка внутри имени — `price``retail`
Если передать имя как значение — price_cents

CLI-программа использует отдельную учебную схему, создаёт только собственные объекты, выполняет запросы, сохраняет readback и очищает созданные объекты. result.html показывает итог, result.json — настоящие данные и типы. Это не HTTP-обработчик.

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

$config = x143Config();
$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']];

    $temporaryName = x143OwnCollection($schema,$owned,'finished_import');
    $keptName = x143OwnCollection($schema,$owned,'kept_catalog');
    $temporary = $schema->getCollection($temporaryName);
    $kept = $schema->getCollection($keptName);
    $temporary->add(['_id'=>'import1','status'=>'completed'])->execute();
    $kept->add(['_id'=>'LED','sku'=>'LED','stock'=>5])->execute();
    $before = $temporary->existsInDatabase();
    $exactOwned = in_array(['type'=>'COLLECTION','name'=>$temporaryName],$owned,true);
    if (!$exactOwned) {throw new RuntimeException('Удаляемый объект не принадлежит этому примеру.');}
    $firstReturn = $schema->dropCollection($temporaryName);
    $after = $temporary->existsInDatabase();
    $dropWarnings = [];
    set_error_handler(function (int $severity, string $message) use (&$dropWarnings): bool {
        if ($severity === E_WARNING && str_contains($message,'[1051]')) {
            $dropWarnings[] = ['severity'=>$severity,'message'=>$message,'server_code'=>1051];
            return true;
        }
        return false;
    });
    try {$secondReturn = $schema->dropCollection($temporaryName);}
    finally {restore_error_handler();}
    $neighbor = $kept->getOne('LED');
    $rows = [['Временная коллекция до удаления',$before ? 'есть' : 'нет'],
        ['Результат первого dropCollection',$firstReturn ? 'true' : 'false'],
        ['Временная коллекция после удаления',$after ? 'есть' : 'нет'],
        ['Результат повторного удаления',$secondReturn === false ? 'false' : 'другой'],
        ['Код предупреждения повторного удаления',$dropWarnings[0]['server_code'] ?? null],
        ['Соседний каталог сохранён',$kept->existsInDatabase() ? 'да' : 'нет'],
        ['Товар соседнего каталога',$neighbor['sku']],['Остаток соседнего товара',$neighbor['stock']]];
    $checks = ['only_owned_collection_is_dropped'=>$exactOwned && $before && !$after,
        'drop_returns_success'=>$firstReturn === true,
        'neighbor_is_preserved'=>$kept->existsInDatabase() && $neighbor['sku'] === 'LED' && $neighbor['stock'] === 5,
        'repeated_drop_does_not_recreate'=>$temporary->existsInDatabase() === false,
        'repeated_drop_reports_absence'=>$secondReturn === false && count($dropWarnings) === 1 && $dropWarnings[0]['server_code'] === 1051];
    $observations = ['dropped_name'=>$temporaryName,'first_return'=>$firstReturn,'first_return_type'=>get_debug_type($firstReturn),
        'second_return'=>$secondReturn,'second_return_type'=>get_debug_type($secondReturn),'second_warnings'=>$dropWarnings,
        'kept_name'=>$keptName,'neighbor'=>$neighbor,'before'=>$before,'after'=>$after];

} finally {
    try {
        if ($schema instanceof mysql_xdevapi\Schema) {
            $removed = x143Cleanup($schema, $owned);
        }
    } finally {
        $session->close();
    }
}

x143Report('mysql143-x-owned-collection-lifecycle', 'Удалить временную коллекцию и сохранить соседний каталог', $rows, $checks, $observations, $runtime, $owned, $removed);

Временная коллекция до удаления — есть
Результат первого dropCollection — true
Временная коллекция после удаления — нет
Результат повторного удаления — false
Код предупреждения повторного удаления — 1051
Соседний каталог сохранён — да
Товар соседнего каталога — LED
Остаток соседнего товара — 5

CLI-программа использует отдельную учебную схему, создаёт только собственные объекты, выполняет запросы, сохраняет readback и очищает созданные объекты. result.html показывает итог, result.json — настоящие данные и типы. Это не HTTP-обработчик.