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

<?php
declare(strict_types=1);
require __DIR__.'/receipt-lab.php';
use MongoDB\Collection;
use MongoDB\BSON\{Document,PackedArray,Decimal128,UTCDateTime};

runReceipt('mongodb136-reconcile-first-line', 'Проверить одну строку накладной', ['Поставка', 'Артикул', 'По накладной', 'На приёмке', 'Решение'],
    function (Collection $receipts): array {
        $invoice=[['sku'=>'LED','qty'=>2]];
        $scan=[['sku'=>'LED','qty'=>2]];
        $saved=storeAndRead($receipts,$invoice,$scan);
        $expected=$saved['invoice'][0];
        $seen=$saved['scan'][0];
        $match=$expected['sku']===$seen['sku'] && $expected['qty']===$seen['qty'];
        $rows=[[$saved['_id'],$expected['sku'],$expected['qty'],$seen['qty'],$match?'Совпало':'Проверить']];
        $checks['stored_sources_read'] = $saved['invoice']===$invoice && $saved['scan']===$scan;
        $checks['one_item_agrees'] = count($saved['invoice'])===1 && count($saved['scan'])===1 && $match;
        return [$rows,$checks,'П-42: по накладной две LED, принято две.'];
    }
);

П-42: по накладной две LED, принято две.

Программа записывает учебные данные, читает их обратно из MongoDB и формирует result.html и result.json. Эти файлы содержат итог конкретного запуска.

<?php
declare(strict_types=1);
require __DIR__.'/receipt-lab.php';
use MongoDB\Collection;
use MongoDB\BSON\{Document,PackedArray,Decimal128,UTCDateTime};

runReceipt('mongodb136-reconcile-sku-order', 'Найти строку скана при другом порядке коробок', ['Артикул', 'Строка накладной', 'Строка скана', 'Принято, шт.'],
    function (Collection $receipts): array {
        $saved=storeAndRead($receipts,[['sku'=>'LED','qty'=>2],['sku'=>'CABLE','qty'=>3]],
            [['sku'=>'CABLE','qty'=>3],['sku'=>'LED','qty'=>2]]);
        $scanIndex=tallyPositions($saved['scan']);
        $rows=[];
        foreach ($saved['invoice'] as $n=>$line) {
            $key='sku:'.$line['sku'];
            $actual=$scanIndex[$key] ?? null;
            if ($actual===null || count($actual['positions'])!==1) { throw new RuntimeException('Expected one matching scan'); }
            $rows[]=[$line['sku'],$n+1,$actual['positions'][0],$actual['quantity']];
        }
        $checks['order_changed'] = $saved['invoice'][0]['sku']!==$saved['scan'][0]['sku'];
        $checks['sku_pairs'] = $rows===[['LED',1,2,2],['CABLE',2,1,3]];
        return [$rows,$checks,'LED найдена во второй строке скана, CABLE — в первой.'];
    }
);

LED найдена во второй строке скана, CABLE — в первой.

Программа записывает учебные данные, читает их обратно из MongoDB и формирует result.html и result.json. Эти файлы содержат итог конкретного запуска.

<?php
declare(strict_types=1);
require __DIR__.'/receipt-lab.php';
use MongoDB\Collection;
use MongoDB\BSON\{Document,PackedArray,Decimal128,UTCDateTime};

runReceipt('mongodb136-reconcile-repeat-lines', 'Объединить повторный SKU и показать исходные позиции', ['Артикул', 'Строки накладной', 'Всего, шт.'],
    function (Collection $receipts): array {
        $saved=storeAndRead($receipts,[['sku'=>'LED','qty'=>2],['sku'=>'CABLE','qty'=>1],['sku'=>'LED','qty'=>1]],[]);
        $index=tallyPositions($saved['invoice']);
        $rows=[];
        foreach ($index as $item) {
            $rows[]=[$item['sku'],implode(', ',$item['positions']),$item['quantity']];
        }
        $checks['one_total_per_sku'] = count($index)===2 && $index['sku:LED']['quantity']===3;
        $checks['all_source_positions'] = $index['sku:LED']['positions']===[1,3] && $index['sku:CABLE']['positions']===[2];
        $checks['sum_preserved'] = array_sum(array_column($index,'quantity'))===array_sum(array_column($saved['invoice'],'qty'));
        return [$rows,$checks,'LED: 3 штуки из строк 1 и 3. CABLE: 1 штука из строки 2.'];
    }
);

LED: 3 штуки из строк 1 и 3. CABLE: 1 штука из строки 2.

Программа записывает учебные данные, читает их обратно из MongoDB и формирует result.html и result.json. Эти файлы содержат итог конкретного запуска.

<?php
declare(strict_types=1);
require __DIR__.'/receipt-lab.php';
use MongoDB\Collection;
use MongoDB\BSON\{Document,PackedArray,Decimal128,UTCDateTime};

runReceipt('mongodb136-reconcile-quantity-gap', 'Показать недобор и излишек в штуках', ['Артикул', 'План', 'Факт', 'Факт − план', 'Итог'],
    function (Collection $receipts): array {
        $saved=storeAndRead($receipts,[['sku'=>'LED','qty'=>3],['sku'=>'CABLE','qty'=>2],['sku'=>'TAPE','qty'=>1]],
            [['sku'=>'TAPE','qty'=>1],['sku'=>'CABLE','qty'=>4],['sku'=>'LED','qty'=>2]]);
        $rows=[];
        foreach (reconcileDelivery($saved['invoice'],$saved['scan']) as [$sku,$plan,$fact,$delta,$action]) {
            $detail=match(true) { $delta<0=>'Недобор', $delta>0=>'Излишек', default=>'Совпало' };
            $rows[]=[$sku,$plan,$fact,$delta,$detail];
        }
        $checks['signed_deltas'] = array_column($rows,3)===[-1,2,0];
        $checks['balances'] = array_sum(array_column($rows,3))===array_sum(array_column($saved['scan'],'qty'))-array_sum(array_column($saved['invoice'],'qty'));
        return [$rows,$checks,'LED: недобор 1. CABLE: излишек 2. TAPE: совпало.'];
    }
);

LED: недобор 1. CABLE: излишек 2. TAPE: совпало.

Программа записывает учебные данные, читает их обратно из MongoDB и формирует result.html и result.json. Эти файлы содержат итог конкретного запуска.

<?php
declare(strict_types=1);
require __DIR__.'/receipt-lab.php';
use MongoDB\Collection;
use MongoDB\BSON\{Document,PackedArray,Decimal128,UTCDateTime};

runReceipt('mongodb136-reconcile-missing-extra', 'Развести недостающий и лишний артикулы', ['Артикул', 'В накладной', 'В скане', 'Действие'],
    function (Collection $receipts): array {
        $saved=storeAndRead($receipts,[['sku'=>'FUSE','qty'=>2],['sku'=>'TAPE','qty'=>1]],
            [['sku'=>'TAPE','qty'=>1],['sku'=>'CLIP','qty'=>1]]);
        $rows=[];
        foreach (reconcileDelivery($saved['invoice'],$saved['scan']) as [$sku,$plan,$fact,$delta,$action]) {
            if ($action!=='Принять') { $rows[]=[$sku,$plan,$fact,$action]; }
        }
        $checks['missing_row'] = $rows[0]===['FUSE',2,0,'Найти по накладной'];
        $checks['extra_row'] = $rows[1]===['CLIP',0,1,'Уточнить поставку'];
        $checks['matching_rows_hidden'] = count($rows)===2 && !in_array('TAPE',array_column($rows,0),true);
        return [$rows,$checks,'FUSE не найден в скане. CLIP отсутствует в накладной.'];
    }
);

FUSE не найден в скане. CLIP отсутствует в накладной.

Программа записывает учебные данные, читает их обратно из MongoDB и формирует result.html и result.json. Эти файлы содержат итог конкретного запуска.

<?php
declare(strict_types=1);
require __DIR__.'/receipt-lab.php';
use MongoDB\Collection;
use MongoDB\BSON\{Document,PackedArray,Decimal128,UTCDateTime};

runReceipt('mongodb136-reconcile-empty-boundary', 'Сохранить разницу между пустым списком и пустой карточкой', ['Пакет', 'PHP в режиме array, затем JSON', 'PHP в режиме object', 'BSON из базы', 'Действие'],
    function (Collection $receipts): array {
        $incoming=['S-LIST'=>'{"lines":[]}','S-OBJECT'=>'{"lines":{}}'];
        $rows=[];
        foreach ($incoming as $id=>$text) {
            $asArray=json_decode($text,true,512,JSON_THROW_ON_ERROR);
            $asObject=json_decode($text,false,512,JSON_THROW_ON_ERROR);
            $receipts->insertOne(['_id'=>$id,'packet'=>Document::fromJSON($text)]);
            $fromDatabase=rawReceipt($receipts,$id)->get('packet')->get('lines');
            $ordinary=is_array($asObject->lines)?'array':'stdClass';
            $raw=match(true) { $fromDatabase instanceof PackedArray=>'PackedArray', $fromDatabase instanceof Document=>'Document', default=>'другой тип' };
            $rows[]=[$id,json_encode($asArray['lines'],JSON_THROW_ON_ERROR),$ordinary,$raw,
                $raw==='PackedArray'?'Пустая ведомость':'Запросить список'];
        }
        $checks['assoc_collapses_shapes'] = array_column($rows,1)===['[]','[]'];
        $checks['json_object_mode'] = array_column($rows,2)===['array','stdClass'];
        $checks['database_shape_retained'] = array_column($rows,3)===['PackedArray','Document'];
        return [$rows,$checks,'Пустой список принят. Для объекта вместо списка нужна исправленная ведомость.'];
    }
);

Пустой список принят. Для объекта вместо списка нужна исправленная ведомость.

Программа записывает учебные данные, читает их обратно из MongoDB и формирует result.html и result.json. Эти файлы содержат итог конкретного запуска.

<?php
declare(strict_types=1);
require __DIR__.'/receipt-lab.php';
use MongoDB\Collection;
use MongoDB\BSON\{Document,PackedArray,Decimal128,UTCDateTime};

runReceipt('mongodb136-reconcile-typed-transfer', 'Перенести цену и дату по Extended JSON и сверить их в MongoDB', ['Поле', 'Прочитано в копии', 'Тип на сервере'],
    function (Collection $receipts): array {
        $original=Document::fromPHP([
            'sku'=>'LED','price'=>new Decimal128('1499.90'),
            'receivedAt'=>new UTCDateTime(new DateTimeImmutable('2026-06-01T08:30:00Z')),
        ]);
        $receipts->insertOne(['_id'=>'source','line'=>$original]);
        $stored=rawReceipt($receipts,'source')->get('line');
        $transport=$stored->toCanonicalExtendedJSON();
        $decoded=Document::fromJSON($transport);
        $receipts->insertOne(['_id'=>'copy','line'=>$decoded]);
        $copy=rawReceipt($receipts,'copy')->get('line');
        $serverTypes=$receipts->aggregate([
            ['$match'=>['_id'=>['$in'=>['source','copy']]]],
            ['$project'=>['_id'=>1,'priceType'=>['$type'=>'$line.price'],'dateType'=>['$type'=>'$line.receivedAt']]],
            ['$sort'=>['_id'=>1]],
        ])->toArray();
        $checks['server_types_both_copies'] = count($serverTypes)===2 && array_column($serverTypes,'priceType')===['decimal','decimal'] && array_column($serverTypes,'dateType')===['date','date'];
        $checks['round_trip_classes'] = $copy->get('price') instanceof Decimal128 && $copy->get('receivedAt') instanceof UTCDateTime;
        $checks['round_trip_values'] = (string)$copy->get('price')===(string)$original->get('price') && (string)$copy->get('receivedAt')===(string)$original->get('receivedAt');
        $rows=[['Цена',(string)$copy->get('price'),$serverTypes[0]['priceType']],
            ['Дата приёмки, UTC',$copy->get('receivedAt')->toDateTime()->format('Y-m-d H:i:s'),$serverTypes[0]['dateType']]];
        return [$rows,$checks,'Копия из базы: 1499.90 и 2026-06-01 08:30:00 UTC. Типы decimal и date сохранены.'];
    }
);

Копия из базы: 1499.90 и 2026-06-01 08:30:00 UTC. Типы decimal и date сохранены.

Программа записывает учебные данные, читает их обратно из MongoDB и формирует result.html и result.json. Эти файлы содержат итог конкретного запуска.

<?php
declare(strict_types=1);
require __DIR__.'/receipt-lab.php';
use MongoDB\Collection;
use MongoDB\BSON\{Document,PackedArray,Decimal128,UTCDateTime};
require __DIR__.'/receiving-view.php';

runReceipt('mongodb136-reconcile-receiving-sheet', 'Собрать итоговую ведомость приёмщика', ['Артикул', 'По накладной, шт.', 'По скану, шт.', 'Факт − план', 'Действие'],
    function (Collection $receipts): array {
        $invoice=[['sku'=>'LED','qty'=>2],['sku'=>'CABLE','qty'=>3],['sku'=>'LED','qty'=>1],['sku'=>'FUSE','qty'=>2],['sku'=>'TAPE','qty'=>1]];
        $scan=[['sku'=>'TAPE','qty'=>1],['sku'=>'LED','qty'=>3],['sku'=>'CLIP','qty'=>1],['sku'=>'CABLE','qty'=>1]];
        $saved=storeAndRead($receipts,$invoice,$scan);
        $rows=reconcileDelivery($saved['invoice'],$saved['scan']);
        $decisions=array_count_values(array_column($rows,4));
        $accepted=$decisions['Принять'] ?? 0;
        $issues=count($rows)-$accepted;
        $checks['receipt_reference'] = $saved['_id']==='П-42';
        $checks['all_distinct_skus'] = array_column($rows,0)===['LED','CABLE','FUSE','TAPE','CLIP'];
        $checks['business_decisions'] = $accepted===2 && $issues===3 && ($decisions['Пересчитать'] ?? 0)===1 && ($decisions['Найти по накладной'] ?? 0)===1 && ($decisions['Уточнить поставку'] ?? 0)===1;
        $checks['quantity_audit'] = array_sum(array_column($rows,1))===9 && array_sum(array_column($rows,2))===6;
        return [$rows,$checks,$saved['_id'].': принять '.$accepted.' артикула, проверить ещё '.$issues.'.'];
    }, 'receivingSheetView'
);

П-42: принять 2 артикула, проверить ещё 3.

Программа записывает учебные данные, читает их обратно из MongoDB и формирует result.html и result.json. Эти файлы содержат итог конкретного запуска.