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

<?php
declare(strict_types=1);
require __DIR__.'/lab.php';
$session = null;
$config = null;
$owned = $tokens = $removed = $rows = $checks = [];
$observations = ['schema_absence_before'=>null, 'schema_absence_after'=>null];
$runtime = x146Runtime();
try {

    $config=x146Config();
    $session=mysql_xdevapi\getSession($config['uri']);
    $runtime=x146Runtime($session,$config);
    $observations['schema_absence_before']=x146Absence($session);
    if (in_array(false,$observations['schema_absence_before'],true)) {
        throw new RuntimeException('Одно из учебных имён занято; запуск прекращён без удаления.');
    }
    x146AssertVacant($session, X146_ALPHA);
    $alpha = $session->createSchema(X146_ALPHA);
    x146Register($session, X146_ALPHA, $owned, $tokens);
    $qualified = x146SchemaName(X146_ALPHA).'.products';
    $session->sql('CREATE TABLE '.$qualified
        .' (sku VARCHAR(20) PRIMARY KEY, product_name VARCHAR(60) NOT NULL, price_kopecks INT NOT NULL, stock INT NOT NULL) ENGINE=InnoDB')->execute();
    $session->sql('INSERT INTO '.$qualified.' (sku, product_name, price_kopecks, stock) VALUES (?, ?, ?, ?)')
        ->bind('CABLE')->bind('Кабель')->bind(12000)->bind(7)->execute();
    $saved = $session->sql('SELECT sku, product_name, price_kopecks, stock FROM '.$qualified.' WHERE sku = ?')
        ->bind('CABLE')->execute()->fetchOne();
    $duplicate = x146Failure(static fn() => $session->createSchema(X146_ALPHA));
    $codes = array_column($duplicate, 'code');
    $afterDuplicate = $session->sql('SELECT sku, product_name, price_kopecks, stock FROM '.$qualified.' WHERE sku = ?')
        ->bind('CABLE')->execute()->fetchOne();
    $rows = [['Создана учебная база', $alpha->getName()], ['Артикул сохранённого товара', $saved['sku']],
        ['Название из базы', $saved['product_name']], ['Цена, коп.', $saved['price_kopecks']], ['Остаток', $saved['stock']],
        ['Повторное создание отклонено', in_array(1007, $codes, true)],
        ['Товар сохранился после отказа', $afterDuplicate === $saved]];
    $checks = ['schema_object'=>$alpha instanceof mysql_xdevapi\Schema,
        'schema_name'=>$alpha->getName() === X146_ALPHA, 'schema_exists'=>$alpha->existsInDatabase(),
        'saved_product'=>$saved === ['sku'=>'CABLE','product_name'=>'Кабель','price_kopecks'=>12000,'stock'=>7],
        'duplicate_error'=>in_array(1007, $codes, true), 'duplicate_preserves_data'=>$afterDuplicate === $saved];
    $observations += ['schema_class'=>get_debug_type($alpha), 'created_schema'=>$alpha->getName(),
        'saved_product'=>$saved, 'duplicate_create'=>$duplicate, 'after_duplicate'=>$afterDuplicate];
} finally {
    if ($session instanceof mysql_xdevapi\Session) {
        try {
            $removed=x146Cleanup($session,$owned,$tokens,$removed);
            $observations['schema_absence_after']=x146Absence($session);
        } finally {$session->close();}
    }
}
$absentAfter = !in_array(false, $observations['schema_absence_after'], true);
$rows[] = ['Оба учебных имени свободны после запуска', $absentAfter];
$checks['schemas_absent_after'] = $absentAfter;
x146Report('mysql146-x-schema-lifecycle', 'Создать базу пробного импорта и перечитать сохранённый товар', $rows, $checks, $observations, $runtime, $owned, $removed);

Создана учебная база — phpmanualx146alpha
Артикул сохранённого товара — CABLE
Название из базы — Кабель
Цена, коп. — 12000
Остаток — 7
Повторное создание отклонено — да
Товар сохранился после отказа — да
Оба учебных имени свободны после запуска — да

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

<?php
declare(strict_types=1);
require __DIR__.'/lab.php';
$session = null;
$config = null;
$owned = $tokens = $removed = $rows = $checks = [];
$observations = ['schema_absence_before'=>null, 'schema_absence_after'=>null];
$runtime = x146Runtime();
try {

    $config=x146Config();
    $session=mysql_xdevapi\getSession($config['uri']);
    $runtime=x146Runtime($session,$config);
    $observations['schema_absence_before']=x146Absence($session);
    if (in_array(false,$observations['schema_absence_before'],true)) {
        throw new RuntimeException('Одно из учебных имён занято; запуск прекращён без удаления.');
    }
    $setup = [
        X146_ALPHA=>['sku'=>'ALPHA-BOX','stock'=>3],
        X146_BETA=>['sku'=>'BETA-BOX','stock'=>11],
    ];
    foreach ($setup as $name=>$product) {
        x146AssertVacant($session, $name);
        $created = $session->createSchema($name);
        x146Register($session, $name, $owned, $tokens);
        $qualified = x146SchemaName($name).'.inventory';
        $session->sql('CREATE TABLE '.$qualified.' (sku VARCHAR(20) PRIMARY KEY, stock INT NOT NULL) ENGINE=InnoDB')->execute();
        $session->sql('INSERT INTO '.$qualified.' (sku, stock) VALUES (?, ?)')->bind($product['sku'])->bind($product['stock'])->execute();
    }
    $all = $session->getSchemas();
    $byName = $ownObjects = [];
    foreach ($all as $key=>$schemaObject) {
        $name = $schemaObject->getName();
        if (!in_array($name, X146_SCHEMAS, true)) { continue; }
        $byName[$name] = $schemaObject;
        $ownObjects[] = ['key'=>$key, 'key_type'=>get_debug_type($key),
            'class'=>get_debug_type($schemaObject), 'name'=>$name];
    }
    $names = array_keys($byName);
    sort($names, SORT_STRING);
    $selected = $byName[X146_BETA];
    $qualified = x146SchemaName($selected->getName()).'.inventory';
    $selectedProduct = $session->sql('SELECT sku, stock FROM '.$qualified.' WHERE sku = ?')
        ->bind('BETA-BOX')->execute()->fetchOne();
    $alphaProduct = $session->sql('SELECT sku, stock FROM '.x146SchemaName(X146_ALPHA).'.inventory WHERE sku = ?')
        ->bind('ALPHA-BOX')->execute()->fetchOne();
    $objectTypesOk = true;
    foreach ($byName as $schemaObject) { $objectTypesOk = $objectTypesOk && $schemaObject instanceof mysql_xdevapi\Schema; }
    $rows = [['Доступных учебных баз', count($names)], ['Первое имя после сортировки', $names[0]],
        ['Второе имя после сортировки', $names[1]], ['Выбрана база', $selected->getName()],
        ['Артикул из выбранной базы', $selectedProduct['sku']], ['Остаток в beta', $selectedProduct['stock']],
        ['Остаток отдельной карточки alpha', $alphaProduct['stock']], ['getSchemas вернул объекты Schema', $objectTypesOk]];
    $checks = ['array_result'=>is_array($all), 'own_names'=>$names === [X146_ALPHA, X146_BETA],
        'objects'=>$objectTypesOk && count($ownObjects) === 2,
        'selected_name'=>$selected->getName() === X146_BETA,
        'selected_product'=>$selectedProduct === ['sku'=>'BETA-BOX','stock'=>11],
        'separate_alpha'=>$alphaProduct === ['sku'=>'ALPHA-BOX','stock'=>3]];
    $observations += ['getschemas_container'=>get_debug_type($all), 'own_schema_objects'=>$ownObjects,
        'sorted_own_names'=>$names, 'selected_schema'=>$selected->getName(),
        'selected_product'=>$selectedProduct, 'alpha_product'=>$alphaProduct];
} finally {
    if ($session instanceof mysql_xdevapi\Session) {
        try {
            $removed=x146Cleanup($session,$owned,$tokens,$removed);
            $observations['schema_absence_after']=x146Absence($session);
        } finally {$session->close();}
    }
}
$absentAfter = !in_array(false, $observations['schema_absence_after'], true);
$rows[] = ['Оба учебных имени свободны после запуска', $absentAfter];
$checks['schemas_absent_after'] = $absentAfter;
x146Report('mysql146-x-schema-directory', 'Показать две доступные учебные базы и открыть запись из выбранной', $rows, $checks, $observations, $runtime, $owned, $removed);

Доступных учебных баз — 2
Первое имя после сортировки — phpmanualx146alpha
Второе имя после сортировки — phpmanualx146beta
Выбрана база — phpmanualx146beta
Артикул из выбранной базы — BETA-BOX
Остаток в beta — 11
Остаток отдельной карточки alpha — 3
getSchemas вернул объекты Schema — да
Оба учебных имени свободны после запуска — да

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

<?php
declare(strict_types=1);
require __DIR__.'/lab.php';
$session = null;
$config = null;
$owned = $tokens = $removed = $rows = $checks = [];
$observations = ['schema_absence_before'=>null, 'schema_absence_after'=>null];
$runtime = x146Runtime();
try {

    $config=x146Config();
    $session=mysql_xdevapi\getSession($config['uri']);
    $runtime=x146Runtime($session,$config);
    $observations['schema_absence_before']=x146Absence($session);
    if (in_array(false,$observations['schema_absence_before'],true)) {
        throw new RuntimeException('Одно из учебных имён занято; запуск прекращён без удаления.');
    }
    foreach ([X146_ALPHA, X146_BETA] as $name) {
        x146AssertVacant($session, $name);
        $created = $session->createSchema($name);
        x146Register($session, $name, $owned, $tokens);
        $qualified = x146SchemaName($name).'.import_receipts';
        $session->sql('CREATE TABLE '.$qualified.' (code VARCHAR(20) PRIMARY KEY, items INT NOT NULL) ENGINE=InnoDB')->execute();
        $session->sql('INSERT INTO '.$qualified.' (code, items) VALUES (?, ?)')
            ->bind($name === X146_ALPHA ? 'TRIAL' : 'KEEP')->bind($name === X146_ALPHA ? 2 : 9)->execute();
    }
    $betaSql = 'SELECT code, items FROM '.x146SchemaName(X146_BETA).'.import_receipts WHERE code = ?';
    $betaBefore = $session->sql($betaSql)->bind('KEEP')->execute()->fetchOne();
    x146AssertOwned($session, X146_ALPHA, $owned, $tokens);
    $firstDrop = $session->dropSchema(X146_ALPHA);
    x146MarkRemoved($session, X146_ALPHA, $removed);
    $alphaAbsent = !$session->getSchema(X146_ALPHA)->existsInDatabase();
    x146AssertVacant($session, X146_ALPHA);
    $warnings = [];
    set_error_handler(static function(int $level, string $message) use (&$warnings): bool {
        if ($level !== E_WARNING || !str_contains($message, "cannot drop schema 'phpmanualx146alpha'")) {
            return false;
        }
        $warnings[] = ['level'=>$level, 'message'=>x146SafeMessage($message)];
        return true;
    });
    try { $secondDrop = $session->dropSchema(X146_ALPHA); }
    finally { restore_error_handler(); }
    $betaAfter = $session->sql($betaSql)->bind('KEEP')->execute()->fetchOne();
    $betaStillExists = $session->getSchema(X146_BETA)->existsInDatabase();
    $rows = [['Первое удаление alpha', $firstDrop], ['Alpha отсутствует после первого удаления', $alphaAbsent],
        ['Повторное удаление отсутствующей alpha', $secondDrop], ['Перехвачено ожидаемых предупреждений', count($warnings)],
        ['Уровень предупреждения', $warnings[0]['level']], ['Beta пока существует', $betaStillExists],
        ['Код квитанции в beta', $betaAfter['code']], ['Позиций в квитанции beta', $betaAfter['items']],
        ['Квитанция beta не изменилась', $betaAfter === $betaBefore]];
    $checks = ['first_drop'=>$firstDrop === true, 'alpha_absent'=>$alphaAbsent,
        'second_drop'=>$secondDrop === false, 'expected_warning'=>count($warnings) === 1 && $warnings[0]['level'] === E_WARNING
            && str_contains($warnings[0]['message'], "cannot drop schema 'phpmanualx146alpha'"),
        'beta_exists'=>$betaStillExists, 'beta_readback'=>$betaAfter === ['code'=>'KEEP','items'=>9],
        'beta_unchanged'=>$betaBefore === $betaAfter, 'one_removed_before_finally'=>count($removed) === 1];
    $observations += ['first_drop'=>$firstDrop, 'alpha_absent_after_first'=>$alphaAbsent,
        'second_drop'=>$secondDrop, 'expected_missing_warnings'=>$warnings,
        'beta_before'=>$betaBefore, 'beta_after'=>$betaAfter, 'beta_exists_before_finally'=>$betaStillExists];
} finally {
    if ($session instanceof mysql_xdevapi\Session) {
        try {
            $removed=x146Cleanup($session,$owned,$tokens,$removed);
            $observations['schema_absence_after']=x146Absence($session);
        } finally {$session->close();}
    }
}
$absentAfter = !in_array(false, $observations['schema_absence_after'], true);
$rows[] = ['Оба учебных имени свободны после запуска', $absentAfter];
$checks['schemas_absent_after'] = $absentAfter;
x146Report('mysql146-x-schema-cleanup-boundaries', 'Повторить удаление alpha и сохранить соседнюю beta', $rows, $checks, $observations, $runtime, $owned, $removed);

Первое удаление alpha — да
Alpha отсутствует после первого удаления — да
Повторное удаление отсутствующей alpha — нет
Перехвачено ожидаемых предупреждений — 1
Уровень предупреждения — 2
Beta пока существует — да
Код квитанции в beta — KEEP
Позиций в квитанции beta — 9
Квитанция beta не изменилась — да
Оба учебных имени свободны после запуска — да

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

<?php
declare(strict_types=1);
require __DIR__.'/lab.php';
$session = null;
$config = null;
$owned = $tokens = $removed = $rows = $checks = [];
$observations = ['schema_absence_before'=>null, 'schema_absence_after'=>null];
$runtime = x146Runtime();
try {

    $config=x146Config();
    $session=mysql_xdevapi\getSession($config['uri']);
    $runtime=x146Runtime($session,$config);
    $observations['schema_absence_before']=x146Absence($session);
    if (in_array(false,$observations['schema_absence_before'],true)) {
        throw new RuntimeException('Одно из учебных имён занято; запуск прекращён без удаления.');
    }
    $available = method_exists($session, 'listClients');
    $firstId = $session->sql('SELECT CONNECTION_ID() AS id')->execute()->fetchOne()['id'];
    $second = mysql_xdevapi\getSession($config['uri']);
    try {
        $secondId = $second->sql('SELECT CONNECTION_ID() AS id')->execute()->fetchOne()['id'];
        $processRows = $session->sql('SHOW PROCESSLIST')->execute()->fetchAll();
        $ownRows = [];
        foreach ($processRows as $row) {
            if (in_array($row['Id'], [$firstId, $secondId], true)) {
                $ownRows[] = ['id'=>$row['Id'], 'user'=>$row['User'], 'command'=>$row['Command']];
            }
        }
    } finally { $secondClosed = $second->close(); }
    $idsFromProcess = array_column($ownRows, 'id');
    $ownIds = [$firstId, $secondId];
    sort($idsFromProcess, SORT_NUMERIC);
    sort($ownIds, SORT_NUMERIC);
    $afterClose = $session->sql('SELECT 1 AS alive')->execute()->fetchOne();
    $rows = [['Метод listClients доступен', $available], ['Открыто собственных Session', count($ownIds)],
        ['SQL connection ID различаются', $firstId !== $secondId],
        ['Тип первого SQL ID', get_debug_type($firstId)], ['Тип второго SQL ID', get_debug_type($secondId)],
        ['Собственных строк найдено в PROCESSLIST', count($ownRows)],
        ['Строки соответствуют двум полученным ID', $idsFromProcess === $ownIds],
        ['Вторая Session закрыта', $secondClosed], ['Первая Session отвечает после закрытия второй', $afterClose['alive']]];
    $checks = ['capability_profile'=>$available === false, 'two_ids'=>is_int($firstId) && is_int($secondId) && $firstId > 0 && $secondId > 0 && $firstId !== $secondId,
        'own_process_rows'=>count($ownRows) === 2 && $idsFromProcess === $ownIds,
        'same_account'=>count(array_unique(array_column($ownRows, 'user'))) === 1,
        'second_closed'=>$secondClosed === true, 'first_alive'=>$afterClose === ['alive'=>1], 'no_schemas_created'=>$owned === []];
    $observations += ['listclients_available'=>$available, 'alternative'=>'SQL CONNECTION_ID plus filtered own SHOW PROCESSLIST rows; not listClients output',
        'connection_ids'=>[$firstId,$secondId], 'id_types'=>[get_debug_type($firstId),get_debug_type($secondId)],
        'own_process_rows'=>$ownRows, 'second_closed'=>$secondClosed, 'after_second_close'=>$afterClose];
} finally {
    if ($session instanceof mysql_xdevapi\Session) {
        try {
            $removed=x146Cleanup($session,$owned,$tokens,$removed);
            $observations['schema_absence_after']=x146Absence($session);
        } finally {$session->close();}
    }
}
$absentAfter = !in_array(false, $observations['schema_absence_after'], true);
$rows[] = ['Оба учебных имени свободны после запуска', $absentAfter];
$checks['schemas_absent_after'] = $absentAfter;
x146Report('mysql146-x-client-capabilities', 'Проверить доступный API и увидеть два собственных соединения', $rows, $checks, $observations, $runtime, $owned, $removed);

Метод listClients доступен — нет
Открыто собственных Session — 2
SQL connection ID различаются — да
Тип первого SQL ID — int
Тип второго SQL ID — int
Собственных строк найдено в PROCESSLIST — 2
Строки соответствуют двум полученным ID — да
Вторая Session закрыта — да
Первая Session отвечает после закрытия второй — 1
Оба учебных имени свободны после запуска — да

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