72 lines
1.5 KiB
PHP
72 lines
1.5 KiB
PHP
<?php
|
|
|
|
namespace KTXC\Db;
|
|
|
|
use MongoDB\BSON\ObjectId as MongoObjectId;
|
|
|
|
/**
|
|
* Wrapper for MongoDB\BSON\ObjectId
|
|
* Provides abstraction layer for MongoDB ObjectId handling
|
|
*/
|
|
class ObjectId
|
|
{
|
|
private MongoObjectId $objectId;
|
|
|
|
/**
|
|
* Create a new ObjectId
|
|
*
|
|
* @param string|MongoObjectId|null $id Optional ID string or MongoDB ObjectId
|
|
*/
|
|
public function __construct(string|MongoObjectId|null $id = null)
|
|
{
|
|
if ($id instanceof MongoObjectId) {
|
|
$this->objectId = $id;
|
|
} elseif (is_string($id)) {
|
|
$this->objectId = new MongoObjectId($id);
|
|
} else {
|
|
$this->objectId = new MongoObjectId();
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Get the string representation of the ObjectId
|
|
*/
|
|
public function __toString(): string
|
|
{
|
|
return (string) $this->objectId;
|
|
}
|
|
|
|
/**
|
|
* Get the underlying MongoDB ObjectId
|
|
* Used internally when interacting with MongoDB driver
|
|
*/
|
|
public function toBSON(): MongoObjectId
|
|
{
|
|
return $this->objectId;
|
|
}
|
|
|
|
/**
|
|
* Get the timestamp from the ObjectId
|
|
*/
|
|
public function getTimestamp(): int
|
|
{
|
|
return $this->objectId->getTimestamp();
|
|
}
|
|
|
|
/**
|
|
* Create ObjectId from string
|
|
*/
|
|
public static function fromString(string $id): self
|
|
{
|
|
return new self($id);
|
|
}
|
|
|
|
/**
|
|
* Check if a string is a valid ObjectId
|
|
*/
|
|
public static function isValid(string $id): bool
|
|
{
|
|
return preg_match('/^[a-f0-9]{24}$/iD', $id) === 1;
|
|
}
|
|
}
|