MongoDB::createCollection

(PECL mongo >=0.9.0)

MongoDB::createCollection — 创建一个集合

说明

public MongoDB::createCollection ( string $name [, array $options ] ) : MongoCollection

这个方法用于创建一个“有限集合”之类需要特殊参数的集合。它相当于执行


<?php

$collection = $db->command(array(
    "create" => $name,
    "capped" => $options["capped"],
    "size" => $options["size"],
    "max" => $options["max"],
    "autoIndexId" => $options["autoIndexId"],
));

?>

参考 MongoDB::command() 了解更多关于数据库指令的信息

参数

name

集合的名字

options

一个数组，包含集合的选项，具有以下形式： array("optionname" => "optionvalue", ...) 。支持的选项跟MongoDB服务器的版本有关。目前支持的选项有：

capped: 这个集合是否是固定大小的。
size: 如果是固定大小的，指定它的大小（字节）。
max: 如果是固定大小的，指定集合中最多存储多少个文档。
autoIndexId: 如果 capped 是 TRUE 你可以显式定义为 FALSE 来禁用自增_id 特性。MongoDB 2.2以前， autoIndexId 的默认值是FALSE。

返回值

返回新建的集合对象。

范例

Example #1 MongoDB::createCollection() 固定大小集合实例

固定大小（capped）集合是一种磁盘容量或者文档数量固定的特殊集合。当集合“满了”的时候，最老的文档就会被新文档代替。固定大小集合在类似日志记录的应用中非常有用，比如你需要保留一定量的日志，不用担心它们占用过多的空间。

这个例子建立了一个非常小的日志集合，保存10条日志。


<?php

$log = $db->createCollection(
    "logger",
    array(
        'capped' => true,
        'size' => 10*1024,
        'max' => 10
    )
);

for ($i = 0; $i < 100; $i++) {
    $log->insert(array("level" => WARN, "msg" => "sample log message #$i", "ts" => new MongoDate()));
}

$msgs = $log->find();

foreach ($msgs as $msg) {
    echo $msg['msg']."\n";
}

?>

以上例程的输出类似于：

sample log message #90
sample log message #91
sample log message #92
sample log message #93
sample log message #94
sample log message #95
sample log message #96
sample log message #97
sample log message #98
sample log message #99

更新日志

版本说明

1.4.0

版本	说明
1.4.0	1.4.0以前的版本里，所有选项都是这个方法的参数。之前版本这个方法的签名是这样的： public MongoDB::createCollection ( string `$name` [, bool `$capped` = `FALSE` [, int `$size` = 0 [, int `$max` = 0 ]]] ) : MongoCollection 参数的意义与现在版本的 `options` 参数相同。

1.4.0以前的版本里，所有选项都是这个方法的参数。之前版本这个方法的签名是这样的：

public MongoDB::createCollection ( string $name [, bool $capped = FALSE [, int $size = 0 [, int $max = 0 ]]] ) : MongoCollection

参数的意义与现在版本的 options 参数相同。

add a note

User Contributed Notes

There are no user contributed notes for this page.

官方地址：https://www.php.net/manual/en/mongodb.createcollection.php

有任何技术问题请点击这里网站运营推广招聘

IT PHP 编程语言 Linux 开发编程科技 Elasticsearch HTML/CSS/XML 网络数据库 JAVA 面试 NoSQL C/C++ Golang Git 算法操作系统正则表达式 Redis 互联网 MySql JavaScript 运维软件国际架构设计 Mac OS TCP/IP Excel Vim Windows Socket Oracle VR MongoDB Python 运营 MemCache 商业硬件电子娱乐设计 nginx 摄影游戏 WordPress HTTP 团建数码电器

php7 安装fileinfo扩展 preg_split — 通过一个正则表达式分隔字符串 php位值,解决 PHP 中 usort 在值相同时改变原始位置的问题 [PHP] inet_pton/inet_ntop IP地址转换函数 [鸟哥]PHP_INT_MIN 和 -9223372036854775808 PHP 8.1 ADORecordSet对象 adodb手册 opcache预加载 Composer的Packagist资源 array_multisort() 多字段排序 PHPMailer设置utf8 PHPMailer字符集CharSet PHP json解析（json_decode）页面工具 mysql面试题 php中几种注释规范纯php实现DES以及TripleDES加密算法 [原创]诡异的php-fpm超时问题两千行PHP学习笔记 html转义/html编码/html解码 PHP获取指定函数定义在哪个文件中及行号

略微加速

PHP官方手册 - 互联网笔记

MongoDB::createCollection

说明

参数

返回值

范例

更新日志

User Contributed Notes