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

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

use MongoDB\Collection;
use MongoDB\BSON\Binary;
use MongoDB\Driver\ClientEncryption;
use MongoDB\Driver\Exception\EncryptionException;

runFieldLesson('mongodb132-field-stored-views', 'Одна запись для склада и для курьера', ['Представление', 'Заказ', 'Состояние', 'Инструкция'],
    function (Collection $orders, ClientEncryption $crypto, Binary $keyId, string $uri, string $vault): array {
        $note = 'Окно учебной выдачи № 2';
        $sealed = randomField($crypto, $keyId, $note);
        $receipt = $orders->insertOne(['_id' => 'D-701', 'status' => 'К выдаче', 'note' => $sealed]);
        $stored = $orders->findOne(['_id' => 'D-701']);
        if (!isSealed($stored['note'])) {
            throw new UnexpectedValueException('Expected a sealed field');
        }
        $storageLabel = 'Binary, подтип '.$stored['note']->getType();
        $instruction = $crypto->decrypt($stored['note']);
        $checks['one_insert'] = $receipt->getInsertedCount() === 1;
        $checks['raw_read_binary'] = $stored['note'] instanceof Binary;
        $checks['stored_subtype_six'] = $stored['note']->getType() === 6;
        $checks['status_readable'] = $stored['status'] === 'К выдаче';
        $checks['note_restored'] = $instruction === $note;
        $rows = [['Склад', $stored['_id'], $stored['status'], $storageLabel],
                 ['Курьер', $stored['_id'], $stored['status'], $instruction]];
        return [$rows, $checks, 'Заказ '.$stored['_id'].' · '.$instruction];
    }
);

Заказ D-701 · Окно учебной выдачи № 2

В архиве есть field-lab.php, который создаёт локальные ключи и учебные коллекции и очищает их после опыта. HTML содержит только явно выбранные сведения.

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

use MongoDB\Collection;
use MongoDB\BSON\Binary;
use MongoDB\Driver\ClientEncryption;
use MongoDB\Driver\Exception\EncryptionException;

runFieldLesson('mongodb132-field-random-notes', 'Одинаковая инструкция в двух разных заказах', ['Наблюдение', 'Результат'],
    function (Collection $orders, ClientEncryption $crypto, Binary $keyId, string $uri, string $vault): array {
        $note = 'Учебная рампа Б';
        $first = randomField($crypto, $keyId, $note);
        $second = randomField($crypto, $keyId, $note);
        $orders->insertMany([['_id' => 'D-711', 'note' => $first], ['_id' => 'D-712', 'note' => $second]]);
        $a = $orders->findOne(['_id' => 'D-711'])['note'];
        $b = $orders->findOne(['_id' => 'D-712'])['note'];
        $sameCipher = $a == $b;
        $plainA = $crypto->decrypt($a);
        $plainB = $crypto->decrypt($b);
        $another = randomField($crypto, $keyId, $note);
        $matches = $orders->countDocuments(['note' => $another]);
        $checks['two_stored'] = $orders->countDocuments([]) === 2;
        $checks['both_sealed'] = isSealed($a) && isSealed($b);
        $checks['ciphertexts_differ'] = !$sameCipher;
        $checks['both_restore_note'] = $plainA === $note && $plainB === $note;
        $checks['fresh_token_does_not_match'] = $matches === 0;
        return [[['Совпали сохранённые Binary', $sameCipher], ['Совпали расшифрованные инструкции', $plainA === $plainB],
                 ['Найдено по новому случайному значению', $matches]], $checks, 'Два заказа с одной инструкцией · '.$plainA];
    }
);

Два заказа с одной инструкцией · Учебная рампа Б

В архиве есть field-lab.php, который создаёт локальные ключи и учебные коллекции и очищает их после опыта. HTML содержит только явно выбранные сведения.

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

use MongoDB\Collection;
use MongoDB\BSON\Binary;
use MongoDB\Driver\ClientEncryption;
use MongoDB\Driver\Exception\EncryptionException;

runFieldLesson('mongodb132-field-exact-match', 'Найти заказы по точному внешнему коду', ['Условие поиска', 'Совпадений', 'Номера'],
    function (Collection $orders, ClientEncryption $crypto, Binary $keyId, string $uri, string $vault): array {
        foreach (['D-721' => 'BOX-1273', 'D-722' => 'BOX-3008', 'D-723' => 'BOX-1273'] as $number => $code) {
            $orders->insertOne(['_id' => $number, 'externalCode' => matchField($crypto, $keyId, $code)]);
        }
        $wanted = 'BOX-1273';
        $plainHits = $orders->countDocuments(['externalCode' => $wanted]);
        $needle = matchField($crypto, $keyId, $wanted);
        $found = $orders->find(['externalCode' => $needle], ['projection' => ['_id' => 1, 'externalCode' => 1],
            'sort' => ['_id' => 1], 'limit' => 10])->toArray();
        $ids = array_column($found, '_id');
        $checks['plain_hits_zero'] = $plainHits === 0;
        $checks['two_exact_matches'] = $ids === ['D-721','D-723'];
        $checks['repeat_cipher_equal'] = $found[0]['externalCode'] == $found[1]['externalCode'];
        $checks['needle_matches_stored'] = $needle == $found[0]['externalCode'];
        $checks['value_confirmed'] = $crypto->decrypt($found[0]['externalCode']) === $wanted;
        return [[['Обычная строка', $plainHits, '—'], ['Предшифрованное значение', count($ids), implode(', ', $ids)]], $checks,
            'Для учебного кода найдены '.implode(', ', $ids)];
    }
);

Для учебного кода найдены D-721, D-723

В архиве есть field-lab.php, который создаёт локальные ключи и учебные коллекции и очищает их после опыта. HTML содержит только явно выбранные сведения.

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

use MongoDB\Collection;
use MongoDB\BSON\Binary;
use MongoDB\Driver\ClientEncryption;
use MongoDB\Driver\Exception\EncryptionException;

runFieldLesson('mongodb132-field-typed-lookup', 'Понять, почему одна цифра в фильтре не совпала', ['Искомое значение', 'Номер', 'Тип после decrypt'],
    function (Collection $orders, ClientEncryption $crypto, Binary $keyId, string $uri, string $vault): array {
        foreach (['D-731' => 7, 'D-732' => '7', 'D-733' => 'WING-A'] as $number => $code) {
            $orders->insertOne(['_id' => $number, 'dock' => matchField($crypto, $keyId, $code)]);
        }
        $rows = [];
        foreach ([['Целое 7', 7], ['Строка 7', '7'], ['Строка wing-a', 'wing-a'], ['Строка WING-A', 'WING-A']] as [$label, $value]) {
            $hit = $orders->findOne(['dock' => matchField($crypto, $keyId, $value)]);
            $rows[] = [$label, $hit['_id'] ?? '—', $hit ? get_debug_type($crypto->decrypt($hit['dock'])) : '—'];
        }
        $checks['integer_hit'] = $rows[0] === ['Целое 7','D-731','int'];
        $checks['text_hit'] = $rows[1] === ['Строка 7','D-732','string'];
        $checks['case_sensitive'] = $rows[2][1] === '—' && $rows[3][1] === 'D-733';
        $checks['three_stored'] = $orders->countDocuments([]) === 3;
        $checks['types_produce_different_binary'] = matchField($crypto, $keyId, 7) != matchField($crypto, $keyId, '7');
        return [$rows, $checks, 'Целое 7 → '.$rows[0][1].' · строка 7 → '.$rows[1][1]];
    }
);

Целое 7 → D-731 · строка 7 → D-732

В архиве есть field-lab.php, который создаёт локальные ключи и учебные коллекции и очищает их после опыта. HTML содержит только явно выбранные сведения.

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

use MongoDB\Collection;
use MongoDB\BSON\Binary;
use MongoDB\Driver\ClientEncryption;
use MongoDB\Driver\Exception\EncryptionException;

runFieldLesson('mongodb132-field-sealed-document', 'Передать зашифрованную схему выдачи без лишнего JSON', ['Проверка', 'Значение'],
    function (Collection $orders, ClientEncryption $crypto, Binary $keyId, string $uri, string $vault): array {
        $instructions = (object)['desk' => 'Стойка Б', 'floor' => 2];
        $denied = false;
        try {
            matchField($crypto, $keyId, $instructions);
        } catch (EncryptionException | MongoDB\Driver\Exception\InvalidArgumentException $error) {
            $denied = true;
        }
        $orders->insertOne(['_id' => 'D-741', 'instructions' => randomField($crypto, $keyId, $instructions)]);
        $raw = $orders->findOne(['_id' => 'D-741'])['instructions'];
        $restored = $crypto->decrypt($raw);
        $fields = (array)$restored;
        $hits = $orders->countDocuments(['instructions.floor' => 2]);
        $checks['deterministic_document_rejected'] = $denied;
        $checks['random_document_stored'] = isSealed($raw);
        $checks['decoded_document'] = is_object($restored) || is_array($restored);
        $checks['typed_floor'] = $fields['floor'] === 2;
        $checks['typed_desk'] = $fields['desk'] === 'Стойка Б';
        $checks['no_dotted_match'] = $hits === 0;
        return [[['Детерминированное шифрование документа', $denied ? 'отклонено' : 'принято'],
                 ['Найдено по instructions.floor в базе', $hits], ['Стойка после decrypt', $fields['desk']],
                 ['Этаж после decrypt', $fields['floor']]], $checks, $fields['desk'].' · этаж '.$fields['floor']];
    }
);

Стойка Б · этаж 2

В архиве есть field-lab.php, который создаёт локальные ключи и учебные коллекции и очищает их после опыта. HTML содержит только явно выбранные сведения.

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

use MongoDB\Collection;
use MongoDB\BSON\Binary;
use MongoDB\Driver\ClientEncryption;
use MongoDB\Driver\Exception\EncryptionException;

runFieldLesson('mongodb132-field-wrong-master', 'Обработать ошибку чтения защищённой инструкции', ['Наблюдение', 'Результат'],
    function (Collection $orders, ClientEncryption $crypto, Binary $keyId, string $uri, string $vault): array {
        $orders->insertOne(['_id' => 'D-751', 'status' => 'Назначен',
            'note' => randomField($crypto, $keyId, 'Учебный сектор В')]);
        $order = $orders->findOne(['_id' => 'D-751']);
        $unrelatedMaster = new Binary(random_bytes(96), Binary::TYPE_GENERIC);
        $otherClient = newFieldClient($uri, $vault, $unrelatedMaster);
        $message = 'Доступно';
        $kind = null;
        try {
            $otherClient->decrypt($order['note']);
        } catch (EncryptionException $error) {
            $message = 'Инструкция недоступна';
            $kind = get_class($error);
        }
        $stillThere = $orders->findOne(['_id' => 'D-751']);
        $checks['wrong_master_failed'] = $kind === EncryptionException::class;
        $checks['public_status_visible'] = $order['status'] === 'Назначен';
        $checks['original_cipher_preserved'] = $stillThere['note'] == $order['note'];
        $checks['correct_client_reads'] = $crypto->decrypt($stillThere['note']) === 'Учебный сектор В';
        $checks['incident_one_order'] = $orders->countDocuments([]) === 1;
        return [[['Номер заказа', $order['_id']], ['Состояние', $order['status']],
                 ['Экран клиента с другим ключом', $message], ['Класс причины', $kind]], $checks,
                 $order['_id'].' · '.$message];
    }
);

D-751 · Инструкция недоступна

В архиве есть field-lab.php, который создаёт локальные ключи и учебные коллекции и очищает их после опыта. HTML содержит только явно выбранные сведения.

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

use MongoDB\Collection;
use MongoDB\BSON\Binary;
use MongoDB\Driver\ClientEncryption;
use MongoDB\Driver\Exception\EncryptionException;

runFieldLesson('mongodb132-field-public-queue', 'Построить общую очередь и расшифровать одно поле выбранного заказа', ['Представление', 'Номер', 'Приоритет или инструкция'],
    function (Collection $orders, ClientEncryption $crypto, Binary $keyId, string $uri, string $vault): array {
        foreach ([['D-761',3,'Учебный стеллаж А'], ['D-762',2,'Учебный стеллаж Б'], ['D-763',1,'Учебный стеллаж В']] as [$number,$priority,$note]) {
            $orders->insertOne(['_id' => $number, 'priority' => $priority, 'status' => 'Готов',
                'note' => randomField($crypto, $keyId, $note)]);
        }
        $page = $orders->find(['status' => 'Готов'], [
            'projection' => ['_id' => 1, 'priority' => 1], 'sort' => ['priority' => -1, '_id' => 1], 'limit' => 2,
        ])->toArray();
        $selected = $orders->findOne(['_id' => $page[0]['_id']], ['projection' => ['_id' => 1, 'note' => 1]]);
        $instruction = $crypto->decrypt($selected['note']);
        $checks['correct_ordering'] = array_column($page, '_id') === ['D-761', 'D-762'];
        $checks['priorities_visible'] = array_column($page, 'priority') === [3,2];
        $checks['no_notes_in_queue'] = !isset($page[0]['note']) && !isset($page[1]['note']);
        $checks['selected_only'] = $selected['_id'] === 'D-761' && isSealed($selected['note']);
        $checks['selected_decryption'] = $instruction === 'Учебный стеллаж А';
        return [[['Очередь 1', $page[0]['_id'], $page[0]['priority']], ['Очередь 2', $page[1]['_id'], $page[1]['priority']],
                 ['Открытая карточка', $selected['_id'], $instruction]], $checks, 'Первым выдаётся '.$selected['_id'].' · '.$instruction];
    }
);

Первым выдаётся D-761 · Учебный стеллаж А

В архиве есть field-lab.php, который создаёт локальные ключи и учебные коллекции и очищает их после опыта. HTML содержит только явно выбранные сведения.

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

use MongoDB\Collection;
use MongoDB\BSON\Binary;
use MongoDB\Driver\ClientEncryption;
use MongoDB\Driver\Exception\EncryptionException;

runFieldLesson('mongodb132-field-revision-guard', 'Изменить закрытую инструкцию, сохранив правку другого сотрудника', ['Шаг', 'Версия или число совпадений', 'На экране'],
    function (Collection $orders, ClientEncryption $crypto, Binary $keyId, string $uri, string $vault): array {
        $orders->insertOne(['_id' => 'D-771', 'revision' => 1, 'note' => randomField($crypto, $keyId, 'Учебный вход А')]);
        $opened = $orders->findOne(['_id' => 'D-771']);
        $starting = $crypto->decrypt($opened['note']);
        $firstUpdate = $orders->updateOne(['_id' => 'D-771', 'revision' => $opened['revision']], [
            '$set' => ['note' => randomField($crypto, $keyId, 'Учебный вход Б')], '$inc' => ['revision' => 1],
        ]);
        $staleUpdate = $orders->updateOne(['_id' => 'D-771', 'revision' => $opened['revision']], [
            '$set' => ['note' => randomField($crypto, $keyId, 'Устаревшая правка')], '$inc' => ['revision' => 1],
        ]);
        $saved = $orders->findOne(['_id' => 'D-771']);
        $actual = $crypto->decrypt($saved['note']);
        $checks['original_read'] = $starting === 'Учебный вход А';
        $checks['updated_one'] = $firstUpdate->getModifiedCount() === 1;
        $checks['stale_refused'] = $staleUpdate->getMatchedCount() === 0 && $staleUpdate->getModifiedCount() === 0;
        $checks['revision_two'] = $saved['revision'] === 2;
        $checks['correct_new_note'] = $actual === 'Учебный вход Б' && isSealed($saved['note']);
        return [[['Исходная версия', $opened['revision'], $starting], ['После правки', $saved['revision'], $actual],
                 ['Совпало для устаревшей правки', $staleUpdate->getMatchedCount(), 'Обновить карточку']], $checks,
                 'Сохранена версия '.$saved['revision'].' · '.$actual];
    }
);

Сохранена версия 2 · Учебный вход Б

В архиве есть field-lab.php, который создаёт локальные ключи и учебные коллекции и очищает их после опыта. HTML содержит только явно выбранные сведения.