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

<?php
declare(strict_types=1);
require __DIR__.'/bv117-helper.php';
[$manager,$database]=bv117Environment();
$server=bv117Command($manager,$database,['buildInfo'=>1])[0]['version'];
$runtime=['php'=>PHP_VERSION,'extension'=>phpversion('mongodb'),'server'=>$server];
$collection='mongodb117_bson_'.bin2hex(random_bytes(8));
$namespace=$database.'.'.$collection; $owned=false; $details=[];
try {
    if(bv117Exists($manager,$database,$collection)){throw new RuntimeException('Fixture name collision');}
    bv117Command($manager,$database,['create'=>$collection]);
    $owned=true;
$input='65a000000000000000000001';
    $id=new MongoDB\BSON\ObjectId($input);
    bv117Insert($manager,$namespace,[['_id'=>$id,'title'=>'Кружка']]);
    $options=['projection'=>['_id'=>1,'title'=>1],'limit'=>1];
    $typed=bv117Read($manager,$namespace,['_id'=>$id],$options);
    $plain=bv117Read($manager,$namespace,['_id'=>$input],$options);
    $absent=bv117Read($manager,$namespace,['_id'=>new MongoDB\BSON\ObjectId('65a000000000000000000099')],$options);
    $invalidCaught=false;
    try{new MongoDB\BSON\ObjectId('not-an-object-id');}
    catch(MongoDB\Driver\Exception\InvalidArgumentException $failure){$invalidCaught=true;}
    $generated=new MongoDB\BSON\ObjectId();
    $generatedValid=preg_match('/\A[0-9a-f]{24}\z/D',(string)$generated)===1;
    $stored=$typed[0]['_id'];
    $rows=[
        ['Типизированный фильтр',$typed[0]['title']],
        ['Только строка в фильтре',(string)count($plain).' документов'],
        ['Валидный, но отсутствующий ID',(string)count($absent).' документов'],
        ['Неверный формат',$invalidCaught?'InvalidArgumentException':'ошибка'],
        ['ID для ссылки',(string)$stored],
        ['Компонент времени ID, секунд',(string)$stored->getTimestamp()],
        ['ID без аргумента',$generatedValid?'24 hex-символа':'ошибка'],
    ];
    $checks=['typed_id_found'=>count($typed)===1 && $typed[0]['title']==='Кружка',
        'string_id_not_equal'=>$plain===[],'valid_absent_id'=>$absent===[],
        'invalid_id_caught'=>$invalidCaught,'objectid_roundtrip'=>$stored instanceof MongoDB\BSON\ObjectId && (string)$stored===$input,
        'timestamp_component'=>$stored->getTimestamp()===1704984576,'generated_shape'=>$generatedValid];
} finally {
    if($owned){bv117Command($manager,$database,['drop'=>$collection]);}
}
$checks['owned_collection_removed']=!bv117Exists($manager,$database,$collection);
bv117Report('mongodb117-bson-objectid-route', ['Действие', 'Результат'], $rows, $checks, $runtime, $details);
echo 'mongodb117-bson-objectid-route: saved result.html and result.json
';

mongodb117-bson-objectid-route: saved result.html and result.json

Запустите php example.php и откройте result.html. В архив включены bv117-helper.php и README с установкой/запуском. Данные создаются заново в отдельной собственной коллекции; соседние программы запускать не требуется.

<?php
declare(strict_types=1);
require __DIR__.'/bv117-helper.php';
[$manager,$database]=bv117Environment();
$server=bv117Command($manager,$database,['buildInfo'=>1])[0]['version'];
$runtime=['php'=>PHP_VERSION,'extension'=>phpversion('mongodb'),'server'=>$server];
$collection='mongodb117_bson_'.bin2hex(random_bytes(8));
$namespace=$database.'.'.$collection; $owned=false; $details=[];
try {
    if(bv117Exists($manager,$database,$collection)){throw new RuntimeException('Fixture name collision');}
    bv117Command($manager,$database,['create'=>$collection]);
    $owned=true;
$text='2026-10-29 15:30:00.123'; $zone='Europe/Moscow';
    $local=bv117Date($text,$zone);
    $correct=new MongoDB\BSON\UTCDateTime($local);
    $wrong=new MongoDB\BSON\UTCDateTime($local->getTimestamp()); // Намеренно неверные единицы.
    bv117Insert($manager,$namespace,[['_id'=>201,'starts_at'=>$correct,'timezone_id'=>$zone,'seconds_as_ms'=>$wrong]]);
    $document=bv117Read($manager,$namespace,['_id'=>201],
        ['projection'=>['_id'=>0,'starts_at'=>1,'timezone_id'=>1,'seconds_as_ms'=>1],'limit'=>1])[0];
    $utc=$document['starts_at']->toDateTimeImmutable();
    $display=$utc->setTimezone(new DateTimeZone($document['timezone_id']));
    $badDateCaught=false;
    try{bv117Date('2026-02-30 15:30:00.123',$zone);}
    catch(InvalidArgumentException $failure){$badDateCaught=true;}
    $rows=[
        ['Форма + зона',$text.' '.$zone],
        ['После чтения: UTC',$utc->format('Y-m-d H:i:s.v P')],
        ['Показ пользователю',$display->format('Y-m-d H:i:s.v P')],
        ['Миллисекунды BSON',(string)$document['starts_at']],
        ['Секунды DateTime',(string)$utc->getTimestamp()],
        ['Секунды ошибочно приняты за мс: год',$document['seconds_as_ms']->toDateTimeImmutable()->format('Y')],
        ['30 февраля',$badDateCaught?'отклонено до записи':'ошибка'],
    ];
    $checks=['stored_date_type'=>$document['starts_at'] instanceof MongoDB\BSON\UTCDateTime,
        'utc_exact'=>$utc->format('Y-m-d H:i:s.v P')==='2026-10-29 12:30:00.123 +00:00',
        'local_roundtrip'=>$display->format('Y-m-d H:i:s.v')===$text,
        'milliseconds_exact'=>(string)$document['starts_at']==='1793277000123',
        'immutable_utc_unchanged'=>$utc->getOffset()===0 && $display->getOffset()===10800,
        'seconds_mistake_visible'=>$document['seconds_as_ms']->toDateTimeImmutable()->format('Y')==='1970',
        'invalid_calendar_date_caught'=>$badDateCaught];
} finally {
    if($owned){bv117Command($manager,$database,['drop'=>$collection]);}
}
$checks['owned_collection_removed']=!bv117Exists($manager,$database,$collection);
bv117Report('mongodb117-bson-local-time', ['Шаг', 'Значение'], $rows, $checks, $runtime, $details);
echo 'mongodb117-bson-local-time: saved result.html and result.json
';

mongodb117-bson-local-time: saved result.html and result.json

Запустите php example.php и откройте result.html. В архив включены bv117-helper.php и README с установкой/запуском. Данные создаются заново в отдельной собственной коллекции; соседние программы запускать не требуется.

<?php
declare(strict_types=1);
require __DIR__.'/bv117-helper.php';
[$manager,$database]=bv117Environment();
$server=bv117Command($manager,$database,['buildInfo'=>1])[0]['version'];
$runtime=['php'=>PHP_VERSION,'extension'=>phpversion('mongodb'),'server'=>$server];
$collection='mongodb117_bson_'.bin2hex(random_bytes(8));
$namespace=$database.'.'.$collection; $owned=false; $details=[];
try {
    if(bv117Exists($manager,$database,$collection)){throw new RuntimeException('Fixture name collision');}
    bv117Command($manager,$database,['create'=>$collection]);
    $owned=true;
$zone=new DateTimeZone('Europe/Berlin');
    $begin=new DateTimeImmutable('2026-03-29 00:00:00',$zone);
    $end=$begin->modify('+1 day');
    $from=new MongoDB\BSON\UTCDateTime($begin); $until=new MongoDB\BSON\UTCDateTime($end);
    $fromMs=(int)(string)$from; $untilMs=(int)(string)$until;
    bv117Insert($manager,$namespace,[
        ['_id'=>1,'at'=>new MongoDB\BSON\UTCDateTime($fromMs-1)],
        ['_id'=>2,'at'=>$from],
        ['_id'=>3,'at'=>new MongoDB\BSON\UTCDateTime($untilMs-1)],
        ['_id'=>4,'at'=>$until],
    ]);
    $options=['projection'=>['_id'=>1,'at'=>1],'sort'=>['at'=>1,'_id'=>1],'limit'=>10];
    $selected=bv117Read($manager,$namespace,['at'=>['$gte'=>$from,'$lt'=>$until]],$options);
    $ids=array_column($selected,'_id');
    $all=bv117Read($manager,$namespace,[],$options);
    $rows=[];
    foreach($all as $event){
        $rows[]=[$event['_id'],$event['at']->toDateTimeImmutable()->setTimezone($zone)->format('Y-m-d H:i:s.v P'),
            bv117Utc($event['at']),in_array($event['_id'],$ids,true)?'да':'нет'];
    }
    $rows[]=['Длина окна',(string)(($untilMs-$fromMs)/3600000).' часа',(string)($untilMs-$fromMs).' мс','—'];
    $nextEnd=new MongoDB\BSON\UTCDateTime($end->modify('+1 day'));
    $next=bv117Read($manager,$namespace,['at'=>['$gte'=>$until,'$lt'=>$nextEnd]],$options);
    $checks=['only_day_boundary_rows'=>$ids===[2,3],
        'calendar_day_23_hours'=>$untilMs-$fromMs===82800000,
        'start_end_offsets'=>$begin->getOffset()===3600 && $end->getOffset()===7200,
        'adjacent_day_no_overlap'=>array_column($next,'_id')===[4],
        'start_inclusive_end_exclusive'=>!in_array(1,$ids,true) && !in_array(4,$ids,true)];
    $details=['from_ms'=>(string)$from,'until_ms'=>(string)$until,'selected_ids'=>$ids];
} finally {
    if($owned){bv117Command($manager,$database,['drop'=>$collection]);}
}
$checks['owned_collection_removed']=!bv117Exists($manager,$database,$collection);
bv117Report('mongodb117-bson-day-range', ['Запись', 'Местное время Europe/Berlin', 'UTC', 'Входит в день?'], $rows, $checks, $runtime, $details);
echo 'mongodb117-bson-day-range: saved result.html and result.json
';

mongodb117-bson-day-range: saved result.html and result.json

Запустите php example.php и откройте result.html. В архив включены bv117-helper.php и README с установкой/запуском. Данные создаются заново в отдельной собственной коллекции; соседние программы запускать не требуется.

<?php
declare(strict_types=1);
require __DIR__.'/bv117-helper.php';
[$manager,$database]=bv117Environment();
$server=bv117Command($manager,$database,['buildInfo'=>1])[0]['version'];
$runtime=['php'=>PHP_VERSION,'extension'=>phpversion('mongodb'),'server'=>$server];
$collection='mongodb117_bson_'.bin2hex(random_bytes(8));
$namespace=$database.'.'.$collection; $owned=false; $details=[];
try {
    if(bv117Exists($manager,$database,$collection)){throw new RuntimeException('Fixture name collision');}
    bv117Command($manager,$database,['create'=>$collection]);
    $owned=true;
bv117Insert($manager,$namespace,[
        ['_id'=>1,'title'=>'Тетрадь','unit_price'=>bv117Price('19.90'),'quantity'=>3,'currency'=>'RUB'],
        ['_id'=>2,'title'=>'Пакет','unit_price'=>bv117Price('0.10'),'quantity'=>3,'currency'=>'RUB'],
    ]);
    $lines=bv117Aggregate($manager,$database,$collection,[
        ['$match'=>['currency'=>'RUB']],['$sort'=>['_id'=>1]],
        ['$project'=>['_id'=>1,'title'=>1,'unit_price'=>1,'quantity'=>1,
            'amount'=>['$multiply'=>['$unit_price','$quantity']],
            'stored_type'=>['$type'=>'$unit_price']]],
    ]);
    $totals=bv117Aggregate($manager,$database,$collection,[
        ['$match'=>['currency'=>'RUB']],
        ['$group'=>['_id'=>'$currency','quantity'=>['$sum'=>'$quantity'],
            'amount'=>['$sum'=>['$multiply'=>['$unit_price','$quantity']]]]],
    ]);
    $rejected=[];
    foreach(['19,90','NaN','Infinity','-1.00'] as $input){
        try{bv117Price($input);}
        catch(InvalidArgumentException $failure){$rejected[]=$input;}
    }
    $invalidDecimal=false;
    try{new MongoDB\BSON\Decimal128('not-decimal');}
    catch(MongoDB\Driver\Exception\InvalidArgumentException $failure){$invalidDecimal=true;}
    $rows=[];
    foreach($lines as $line){$rows[]=[$line['_id'],$line['title'],(string)$line['unit_price'],$line['quantity'],(string)$line['amount']];}
    $rows[]=['Итого','RUB','',$totals[0]['quantity'],(string)$totals[0]['amount']];
    $rows[]=['Отказ',implode(' / ',$rejected),'вход отклонён',null,(string)count($rejected).' отказа'];
    $rows[]=['Синтаксис Decimal','not-decimal',$invalidDecimal?'InvalidArgumentException':'ошибка',null,'не создан'];
    $checks=['decimal_storage'=>array_column($lines,'stored_type')===['decimal','decimal'],
        'decimal_server_result'=>$lines[0]['amount'] instanceof MongoDB\BSON\Decimal128 && $totals[0]['amount'] instanceof MongoDB\BSON\Decimal128,
        'line_amounts'=>array_map(fn($line)=>(string)$line['amount'],$lines)===['59.70','0.30'],
        'total_exact'=>(string)$totals[0]['amount']==='60.00',
        'quantity_six'=>$totals[0]['quantity']===6,
        'domain_rejections'=>$rejected===['19,90','NaN','Infinity','-1.00'],
        'constructor_invalid_decimal_caught'=>$invalidDecimal];
} finally {
    if($owned){bv117Command($manager,$database,['drop'=>$collection]);}
}
$checks['owned_collection_removed']=!bv117Exists($manager,$database,$collection);
bv117Report('mongodb117-bson-decimal-invoice', ['Строка', 'Товар/условие', 'Цена/статус', 'Количество', 'Итог'], $rows, $checks, $runtime, $details);
echo 'mongodb117-bson-decimal-invoice: saved result.html and result.json
';

mongodb117-bson-decimal-invoice: saved result.html and result.json

Запустите php example.php и откройте result.html. В архив включены bv117-helper.php и README с установкой/запуском. Данные создаются заново в отдельной собственной коллекции; соседние программы запускать не требуется.

<?php
declare(strict_types=1);
require __DIR__.'/bv117-helper.php';
[$manager,$database]=bv117Environment();
$server=bv117Command($manager,$database,['buildInfo'=>1])[0]['version'];
$runtime=['php'=>PHP_VERSION,'extension'=>phpversion('mongodb'),'server'=>$server];
$collection='mongodb117_bson_'.bin2hex(random_bytes(8));
$namespace=$database.'.'.$collection; $owned=false; $details=[];
try {
    if(bv117Exists($manager,$database,$collection)){throw new RuntimeException('Fixture name collision');}
    bv117Command($manager,$database,['create'=>$collection]);
    $owned=true;
$json='{"id":"65a000000000000000000001","occurred_at":"2026-10-29T12:30:00.123Z","amount":"0.10"}';
    $input=json_decode($json,true,512,JSON_THROW_ON_ERROR);
    foreach(['id','occurred_at','amount'] as $field){if(!isset($input[$field]) || !is_string($input[$field])){throw new InvalidArgumentException('String integration field required');}}
    $id=new MongoDB\BSON\ObjectId($input['id']);
    $when=new MongoDB\BSON\UTCDateTime(bv117Date($input['occurred_at'],'UTC','Y-m-d\TH:i:s.v\Z'));
    $amount=bv117Price($input['amount']);
    bv117Insert($manager,$namespace,[
        ['_id'=>501,'entity_id'=>$id,'occurred_at'=>$when,'amount'=>$amount],
        ['_id'=>502,'entity_id'=>$input['id'],'occurred_at'=>$input['occurred_at'],'amount'=>$input['amount']],
    ]);
    $types=bv117Aggregate($manager,$database,$collection,[
        ['$sort'=>['_id'=>1]],['$project'=>['_id'=>1,'id_type'=>['$type'=>'$entity_id'],
            'date_type'=>['$type'=>'$occurred_at'],'amount_type'=>['$type'=>'$amount']]],
    ]);
    $options=['projection'=>['_id'=>1,'entity_id'=>1,'occurred_at'=>1,'amount'=>1],'limit'=>2];
    $typed=bv117Read($manager,$namespace,['entity_id'=>$id],$options);
    $plain=bv117Read($manager,$namespace,['entity_id'=>$input['id']],$options);
    $document=$typed[0];
    $api=['id'=>(string)$document['entity_id'],'occurred_at'=>bv117Utc($document['occurred_at']),'amount'=>(string)$document['amount']];
    $export=json_encode($api,JSON_UNESCAPED_UNICODE|JSON_UNESCAPED_SLASHES|JSON_THROW_ON_ERROR);
    $again=json_decode($export,true,512,JSON_THROW_ON_ERROR);
    $rows=[];
    foreach($types as $type){
        $rows[]=[$type['_id'],'entity_id',$type['id_type'],$input['id']];
        $rows[]=[$type['_id'],'occurred_at',$type['date_type'],$input['occurred_at']];
        $rows[]=[$type['_id'],'amount',$type['amount_type'],$input['amount']];
    }
    $rows[]=['JSON API','amount',get_debug_type($again['amount']),$again['amount']];
    $rows[]=['Диагностика','epoch_ms','строка миллисекунд',(string)$document['occurred_at']];
    $details=['explicit_api_json'=>$export,'typed_query_ids'=>array_column($typed,'_id'),'string_query_ids'=>array_column($plain,'_id')];
    $checks=['typed_fields_preserved'=>$types[0]['id_type']==='objectId' && $types[0]['date_type']==='date' && $types[0]['amount_type']==='decimal',
        'raw_strings_stay_strings'=>$types[1]['id_type']==='string' && $types[1]['date_type']==='string' && $types[1]['amount_type']==='string',
        'type_map_keeps_bson_values'=>$document['entity_id'] instanceof MongoDB\BSON\ObjectId && $document['occurred_at'] instanceof MongoDB\BSON\UTCDateTime && $document['amount'] instanceof MongoDB\BSON\Decimal128,
        'typed_and_plain_filters_differ'=>array_column($typed,'_id')===[501] && array_column($plain,'_id')===[502],
        'api_roundtrip_explicit'=>$again===$input,
        'date_ms_string'=>(string)$document['occurred_at']==='1793277000123'];
} finally {
    if($owned){bv117Command($manager,$database,['drop'=>$collection]);}
}
$checks['owned_collection_removed']=!bv117Exists($manager,$database,$collection);
bv117Report('mongodb117-bson-integration-roundtrip', ['Документ/выход', 'Поле', 'Фактический тип', 'Представление'], $rows, $checks, $runtime, $details);
echo 'mongodb117-bson-integration-roundtrip: saved result.html and result.json
';

mongodb117-bson-integration-roundtrip: saved result.html and result.json

Запустите php example.php и откройте result.html. В архив включены bv117-helper.php и README с установкой/запуском. Данные создаются заново в отдельной собственной коллекции; соседние программы запускать не требуется.

<?php
declare(strict_types=1);
require __DIR__.'/bv117-helper.php';
[$manager,$database]=bv117Environment();
$server=bv117Command($manager,$database,['buildInfo'=>1])[0]['version'];
$runtime=['php'=>PHP_VERSION,'extension'=>phpversion('mongodb'),'server'=>$server];
$collection='mongodb117_bson_'.bin2hex(random_bytes(8));
$namespace=$database.'.'.$collection; $owned=false; $details=[];
try {
    if(bv117Exists($manager,$database,$collection)){throw new RuntimeException('Fixture name collision');}
    bv117Command($manager,$database,['create'=>$collection]);
    $owned=true;
$hexes=['65a000000000000000000001','65a000000000000000000002','65a000010000000000000003'];
    $fixture=[
        ['_id'=>new MongoDB\BSON\ObjectId($hexes[0]),'title'=>'Текущий заказ','created_at'=>new MongoDB\BSON\UTCDateTime(bv117Date('2026-10-02 08:00:00.000','UTC'))],
        ['_id'=>new MongoDB\BSON\ObjectId($hexes[1]),'title'=>'Вчерашний заказ','created_at'=>new MongoDB\BSON\UTCDateTime(bv117Date('2026-10-01 08:00:00.000','UTC'))],
        ['_id'=>new MongoDB\BSON\ObjectId($hexes[2]),'title'=>'Архивный заказ','created_at'=>new MongoDB\BSON\UTCDateTime(bv117Date('2020-01-02 08:00:00.000','UTC'))],
    ];
    bv117Insert($manager,$namespace,$fixture);
    $projection=['_id'=>1,'title'=>1,'created_at'=>1];
    $byId=bv117Read($manager,$namespace,[],['projection'=>$projection,'sort'=>['_id'=>1],'limit'=>3]);
    $byEvent=bv117Read($manager,$namespace,[],['projection'=>$projection,'sort'=>['created_at'=>1,'_id'=>1],'limit'=>3]);
    $rows=[];
    foreach(['По _id'=>$byId,'По created_at'=>$byEvent] as $order=>$documents){
        foreach($documents as $index=>$document){
            $component=(new DateTimeImmutable('@'.$document['_id']->getTimestamp()))->setTimezone(new DateTimeZone('UTC'));
            $rows[]=[$order,$index+1,$document['title'],
                $document['created_at']->toDateTimeImmutable()->format('Y-m-d H:i:s'),
                $component->format('Y-m-d H:i:s')];
        }
    }
    $checks=['id_order_is_not_event_order'=>array_column($byId,'title')===['Текущий заказ','Вчерашний заказ','Архивный заказ'],
        'event_order'=>array_column($byEvent,'title')===['Архивный заказ','Вчерашний заказ','Текущий заказ'],
        'same_second_different_ids'=>$byId[0]['_id']->getTimestamp()===$byId[1]['_id']->getTimestamp() && (string)$byId[0]['_id']!==(string)$byId[1]['_id'],
        'timestamp_seconds_known'=>$byId[2]['_id']->getTimestamp()===1704984577,
        'business_date_preserved'=>bv117Utc($byEvent[0]['created_at'])==='2020-01-02T08:00:00.000Z'];
    $details=['ids_by_event'=>array_map(fn($d)=>(string)$d['_id'],$byEvent)];
} finally {
    if($owned){bv117Command($manager,$database,['drop'=>$collection]);}
}
$checks['owned_collection_removed']=!bv117Exists($manager,$database,$collection);
bv117Report('mongodb117-bson-imported-event-time', ['Сортировка', 'Позиция', 'Событие', 'created_at, UTC', 'Компонент ObjectId, UTC'], $rows, $checks, $runtime, $details);
echo 'mongodb117-bson-imported-event-time: saved result.html and result.json
';

mongodb117-bson-imported-event-time: saved result.html and result.json

Запустите php example.php и откройте result.html. В архив включены bv117-helper.php и README с установкой/запуском. Данные создаются заново в отдельной собственной коллекции; соседние программы запускать не требуется.