MongoId specifics ¶

Getting scalar from document ID ¶

Remember: MongoDB document id (_id field) is not scalar, but an instance of \MongoDB\BSON\ObjectID class. To get actual Mongo ID string your should typecast \MongoDB\BSON\ObjectID instance to string:

$query = new Query();
$row = $query->from('customer')->one();
var_dump($row['_id']); // outputs: "object(\MongoDB\BSON\ObjectID)"
var_dump((string) $row['_id']); // outputs "string 'acdfgdacdhcbdafa'"

Although this fact is very useful sometimes, it often produces some problems. You may face them in URL composition or attempt of saving "_id" to other storage. In these cases, ensure you have converted \MongoDB\BSON\ObjectID into the string:

/* @var $this yii\web\View */
echo $this->createUrl(['item/update', 'id' => (string) $row['_id']]);

Same applies to implementing user identity which is stored in MongoDB. When implementing \yii\web\IdentityInterface::getId() you should typecast \MongoDB\BSON\ObjectID class to scalar in order for authentication to work.

Getting document ID from scalar ¶

While building condition, values for the key '_id' will be automatically cast to \MongoDB\BSON\ObjectID instance, even if they are plain strings. So it is not necessary for you to perform back cast of string '_id' representation:

use yii\web\Controller;
use yii\mongodb\Query;

class ItemController extends Controller
{
    /**
     * @param string $id MongoId string (not object)
     */
    public function actionUpdate($id)
    {
        $query = new Query;
        $row = $query->from('item')
            ->where(['_id' => $id]) // implicit typecast to [[\MongoDB\BSON\ObjectID]]
            ->one();
        ...
    }
}

However, if you have other columns, containing \MongoDB\BSON\ObjectID, you should take care of possible typecast on your own.