See Release Notes
Long Term Support Release
<?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); } }