<?php
/*
< * Copyright 2015-2017 MongoDB, Inc.
> * Copyright 2015-present MongoDB, Inc.
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
< * http://www.apache.org/licenses/LICENSE-2.0
> * https://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
namespace MongoDB\Model;
use ArrayAccess;
use MongoDB\Exception\BadMethodCallException;
> use ReturnTypeWillChange;
use function array_key_exists;
>
/**
* Collection information model class.
*
* This class models the collection information returned by the listCollections
* command or, for legacy servers, queries on the "system.namespaces"
* collection. It provides methods to access options for the collection.
*
* @api
* @see \MongoDB\Database::listCollections()
* @see https://github.com/mongodb/specifications/blob/master/source/enumerate-collections.rst
*/
class CollectionInfo implements ArrayAccess
{
/** @var array */
private $info;
/**
* @param array $info Collection info
*/
public function __construct(array $info)
{
$this->info = $info;
}
/**
* Return the collection info as an array.
*
< * @see http://php.net/oop5.magic#language.oop5.magic.debuginfo
> * @see https://php.net/oop5.magic#language.oop5.magic.debuginfo
* @return array
*/
public function __debugInfo()
{
return $this->info;
}
/**
* Return the maximum number of documents to keep in the capped collection.
*
> * @deprecated 1.0 Deprecated in favor of using getOptions
* @return integer|null
> *
*/
public function getCappedMax()
{
/* The MongoDB server might return this number as an integer or float */
return isset($this->info['options']['max']) ? (integer) $this->info['options']['max'] : null;
}
/**
* Return the maximum size (in bytes) of the capped collection.
*
> * @deprecated 1.0 Deprecated in favor of using getOptions
* @return integer|null
> *
*/
public function getCappedSize()
{
/* The MongoDB server might return this number as an integer or float */
return isset($this->info['options']['size']) ? (integer) $this->info['options']['size'] : null;
}
/**
> * Return information about the _id index for the collection.
* Return the collection name.
> */
*
> public function getIdIndex(): array
* @return string
> {
*/
> return (array) ($this->info['idIndex'] ?? []);
public function getName()
> }
{
>
return (string) $this->info['name'];
> /**
}
> * Return the "info" property of the server response.
> *
/**
> * @see https://mongodb.com/docs/manual/reference/command/listCollections/#output
* Return the collection options.
> */
*
> public function getInfo(): array
* @return array
> {
*/
> return (array) ($this->info['info'] ?? []);
public function getOptions()
> }
{
>
return isset($this->info['options']) ? (array) $this->info['options'] : [];
> /**
}
> * @see https://mongodb.com/docs/manual/reference/command/listCollections/#output
> * @see https://mongodb.com/docs/manual/reference/command/listCollections/#output
< return isset($this->info['options']) ? (array) $this->info['options'] : [];
> return (array) ($this->info['options'] ?? []);
> }
>
> /**
> * Return the collection type.
> *
> * @see https://mongodb.com/docs/manual/reference/command/listCollections/#output
> */
> public function getType(): string
> {
> return (string) $this->info['type'];
* Return whether the collection is a capped collection.
*
> * @deprecated 1.0 Deprecated in favor of using getOptions
* @return boolean
> *
*/
public function isCapped()
{
return ! empty($this->info['options']['capped']);
}
/**
* Check whether a field exists in the collection information.
*
< * @see http://php.net/arrayaccess.offsetexists
> * @see https://php.net/arrayaccess.offsetexists
* @param mixed $key
* @return boolean
*/
> #[ReturnTypeWillChange]
public function offsetExists($key)
{
return array_key_exists($key, $this->info);
}
/**
* Return the field's value from the collection information.
*
< * @see http://php.net/arrayaccess.offsetget
> * @see https://php.net/arrayaccess.offsetget
* @param mixed $key
* @return mixed
*/
> #[ReturnTypeWillChange]
public function offsetGet($key)
{
return $this->info[$key];
}
/**
* Not supported.
*
< * @see http://php.net/arrayaccess.offsetset
> * @see https://php.net/arrayaccess.offsetset
* @param mixed $key
* @param mixed $value
* @throws BadMethodCallException
> * @return void
*/
> #[ReturnTypeWillChange]
public function offsetSet($key, $value)
{
throw BadMethodCallException::classIsImmutable(self::class);
}
/**
* Not supported.
*
< * @see http://php.net/arrayaccess.offsetunset
> * @see https://php.net/arrayaccess.offsetunset
* @param mixed $key
* @throws BadMethodCallException
> * @return void
*/
> #[ReturnTypeWillChange]
public function offsetUnset($key)
{
throw BadMethodCallException::classIsImmutable(self::class);
}
}