final class \SmartMongoDb
{ } ->

• Language: PHP
• Located at: lib/framework/plugins/lib_db_mongodb.php
• Package: Plugins:Database:MongoDB
• Namespace: \
• Class Name: SmartMongoDb
• Throws: Exception : Depending how this class it is constructed it may throw Exception or Raise Fatal Error
• Version: v.20221231
• Depends: extensions: PHP MongoDB ; classes: Smart, SmartEnvironment, SmartComponents (optional)
• Hints: Important: MongoDB database specifies that max BSON document size is 16 megabytes and supports no more than 100 levels of nesting, thus this limit cannot be exceeded from PHP side when creating new mongodb documents: https://docs.mongodb.com/manual/reference/limits/ ; To store documents larger than the maximum size, MongoDB provides the GridFS API
• Usage: dynamic object: (new Class())->method() - This class provides only DYNAMIC methods

class Methods

Sample code: PHP
<?php

 // Sample Count Records
 $count = $mongo->count(
 		'myTestCollection',
 		[ 'name' => [ '$eq' => 'Test:!' ] ] // filter
 );
 var_dump($count);

// Sample Find One
 $find = $mongo->findone(
 		'myTestCollection',
 		[ 'cost' => 7 ] // filter
 );
 var_dump($find);

// Sample Find Many
 $mfind = $mongo->find(
 		'myTestCollection',
 		[ 'name' => 'John' ], // filter
 		[ // projection
 			'name',
 			'description'
 		],
 		[
 			'limit' => 10, // limit
 			'skip' => 0 // offset
 		]
 );
 var_dump($mfind);

// Sample Insert
 $doc = [];
 $doc['id']  = $mongo->assign_uuid();
 $doc['name'] = 'My Name';
 $doc['description'] = 'Some description goes here ...';
 $insert = $mongo->insert('myTestCollection', (array)$doc);
 $doc = [];
 var_dump($insert);

// Sample Bulk Insert (10 Documents)
 $docs = array();
 for($i=0; $i<10; $i++) {
 	$docs[] = [
 		'id'  => $mongo->assign_uuid(),
 		'name' => 'Document #'.$i,
 		'cost' => ($i+1),
 		'data' => [
 			'description' => 'This is the document #'.$i,
 			'date_time' => (string) date('Y-m-d H:i:s'),
 			'rating' => Smart::random_number(1,9) / 100
 		]
 	];
 } //end for
 $insert = $mongo->bulkinsert('myTestCollection', (array)$docs);
 $docs = array();
 var_dump($insert);

// Sample Complete Update (Replace) ; it will completely replace the document with a new one, except the _id UID key, by _id ; works only with one document ; if more documents match the criteria, only the first one will be updated
 $doc = [];
 $doc['name'] = 'My New Name';
 $doc['description'] = 'Some description goes here ...';
 $update = $mongo->update(
 		'myTestCollection',
 		[ '_id' => 'XXXXXXXXXX-XXXXXXXXXX-XXXXXXXXXX' ], 			// filter (update only this)
 		[ 0 => (array) $doc ]										// replace array
 	);
 $doc = [];
 var_dump($update);

// Sample Partial Update, will update one or many: name and description ; if other keys exist in the stored document they remain unchanged
 $doc = [];
 $doc['name'] = 'My New Name';
 $doc['description'] = 'Some description goes here ...';
 $update = $mongo->update(
 		'myTestCollection',
 		[ 'id' => 'XXXXXXXXXX-XXXXXXXXXX-XXXXXXXXXX' ], 			// filter (update only this)
 		'$set', 													// increment operation
 		(array) $doc												// update array
 	);
 $doc = [];
 var_dump($update);

// Sample Upsert
 $doc = [];
 $docID  = 'XXXXXXXXXX-XXXXXXXXXX-XXXXXXXXXX'; // comes from $mongo->assign_uuid();
 $doc['name'] = 'My Newest Name';
 $doc['description'] = 'Some description goes here ...';
 try {
 		$upsert = $mongo->upsert(
 			'myTestCollection',
 			[ 'id' => $docID ], 								// filter (update only this)
 			[ // also the $mongo->update() can use this style of associative array
 				'$setOnInsert' 	=> (array) [ 'id' => $docID ], 						// just on insert
 				'$set' 			=> (array) $doc, 									// update array
 				'$addToSet' 	=> (array) [ 'updated' => date('Y-m-d H:i:s') ] 	// update array #2 using $addToSet (can be also: $push or $inc, ...)
 			]
 		);
 } catch(Exception $err) {
 		// if upsert goes wrong ...
 }
 $doc = [];
 var_dump($upsert);

// Sample Delete
 $delete = $mongo->delete(
 		'myTestCollection',
 		[ 'name' => 'An Item', 'cost' => 8 ] // filter
 );
 var_dump($delete);

// Search Distinct with Filter
 $filter = $mongo->command(
 		[
 			'distinct' => 'myTestCollection',
 			'key' => 'cost',
 			'query' => [ 'cost' => [ '$gte' => 5 ] ] // find distinct where cost > 5
 		]
 );
 if(!$mongo->is_command_ok($filter) {
 		// command failed ...
 }
 var_dump($filter);

// ... see more usage samples: modules/mod-samples/libs/TestUnitMongoDB.php

// #end php code

class Properties

class Constants

Sample code: PHP