MongoDB 教程七: MongoDB和PHP结合开发

(视频来源:php兄弟连)

MongoDB 系列教程索引 : MongoDB 教程索引 (附有视频)

Linux上安装 MongoDB PHP扩展

在终端上安装

你可以在linux中执行以下命令来安装MongoDB 的 PHP 扩展驱动

$ sudo pecl install mongo

使用php的pecl安装命令必须保证网络连接可用以及root权限。

安装手册

如果你想通过源码来编译扩展驱动。你必须手动编译源码包,这样做的好是最新修正的bug包含在源码包中。

你可以在Github上下载MongoDB PHP驱动包。访问github网站然后搜索”mongo php driver”(下载地址:https://github.com/mongodb/mongo-php-driver),下载该源码包,然后执行以下命令:

$ tar zxvf mongodb-mongodb-php-driver-<commit_id>.tar.gz
$ cd mongodb-mongodb-php-driver-<commit_id>
$ phpize
$ ./configure
$ sudo make install

如果你的php是自己编译的,则安装方法如下(假设是编译在/usr/local/php目录中):

$ tar zxvf mongodb-mongodb-php-driver-<commit_id>.tar.gz
$ cd mongodb-mongodb-php-driver-<commit_id>
$ /usr/local/php/bin/phpize
$ ./configure --with-php-config=/usr/local/php/bin/php-config
$ sudo make install

执行以上命令后,你需要修改php.ini文件,在php.ini文件中添加mongo配置,配置如下:

extension=mongo.so

注意:你需要指明 extension_dir 配置项的路径。

或者直接查看文章:MongoDB 教程番外篇之管理工具: Rockmongo


window上安装 MongoDB PHP扩展

Github上已经提供了用于window平台的预编译php mongodb驱动二进制包(下载地址: https://s3.amazonaws.com/drivers.mongodb.org/php/index.html),你可以下载与你php对应的版本,但是你需要注意以下几点问题:

  • VC6 是运行于 Apache 服务器
  • ‘Thread safe’(线程安全)是运行在Apache上以模块的PHP上,如果你以CGI的模式运行PHP,请选择非线程安全模式(’ non-thread safe’)。
  • VC9是运行于 IIS 服务器上。
  • 下载完你需要的二进制包后,解压压缩包,将’php_mongo.dll’文件添加到你的PHP扩展目录中(ext)。ext目录通常在PHP安装目录下的ext目录。

打开php配置文件 php.ini 添加以下配置:

extension=php_mongo.dll

重启服务器。

通过浏览器访问phpinfo,如果安装成功,就会看到类型以下的信息:

MongoDB 教程七: MongoDB和PHP结合开发
MongoDB 教程七: MongoDB和PHP结合开发

MAC中安装MongoDB PHP扩展驱动

你可以使用’autoconf’安装MongoDB PHP扩展驱动。

你可以使用’Xcode’安装MongoDB PHP扩展驱动。

如果你使用 XAMPP,你可以使用以下命令安装MongoDB PHP扩展驱动:

sudo /Applications/XAMPP/xamppfiles/bin/pecl install mongo

如果以上命令在XMPP或者MAMP中不起作用,你需要在Github上下载兼容的预编译包。

然后添加 ‘extension=mongo.so’配置到你的php.ini文件中。

MongoDB PHP

在php中使用mongodb你必须使用 mongodb的php驱动。

MongoDB PHP在各平台上的安装及驱动包下载请查看:PHP安装MongoDB扩展驱动

确保连接及选择一个数据库

为了确保正确连接,你需要指定数据库名,如果数据库在mongoDB中不存在,mongoDB会自动创建

代码片段如下:

<?php
   // 连接到mongodb
   $m = new MongoClient();
   echo "Connection to database successfully";
   // 选择一个数据库
   $db = $m->mydb;
   echo "Database mydb selected";
?>

执行以上程序,输出结果如下:

Connection to database successfully
Database mydb selected

更多方法:

//格式=>("mongodb://用户名:密码@地址:端口/默认指定数据库",参数)
$conn = new Mongo();
//可以简写为
//$conn=new Mongo();                                            #连接本地主机,默认端口.
//$conn=new Mongo("172.21.15.69");                              #连接远程主机
//$conn=new Mongo("ikeepstudying.loc:10086");                         #连接指定端口远程主机
//$conn=new Mongo("ikeepstudying.loc",array("replicaSet"=>true));     #负载均衡
//$conn=new Mongo("ikeepstudying.loc",array("persist"=>"t"));         #持久连接
//$conn=new Mongo("mongodb://sa:123@localhost");                #带用户名密码
//$conn=new Mongo("mongodb://localhost:27017,localhost:27018"); #连接多个服务器
//$conn=new Mongo("mongodb:///tmp/mongo-27017.sock");           #域套接字
//$conn=new Mongo("mongodb://admin_miss:miss@localhost:27017/test",array('persist'=>'p',"replicaSet"=>true));   #完整

详细资料:http://www.php.net/manual/en/mongo.connecting.php

创建集合

创建集合的代码片段如下:

<?php
   // 连接到mongodb
   $m = new MongoClient();
   echo "Connection to database successfully";
   // 选择一个数据库
   $db = $m->mydb;
   echo "Database mydb selected";
   $collection = $db->createCollection("mycol");
   echo "Collection created succsessfully";
?>

执行以上程序,输出结果如下:

Connection to database successfully
Database mydb selected
Collection created succsessfully

更多方法:

$db = $conn->mydb; #选择mydb数据库
//$db=$conn->selectDB("mydb");                  #第二种写法

$collection = $db->column; #选择集合(选择'表')
//$collection=$db->selectCollection('column');  #第二种写法
//$collection=$conn->mydb->column;              #更简洁的写法

注意:

1.数据库和集合不需要事先创建,若它们不存在则会自动创建它们.

2.注意错别字,你可能会无意间的创建一个新的数据库(与原先的数据库混乱).

插入文档

在mongoDB中使用 insert() 方法插入文档:

插入文档代码片段如下:

<?php
   // 连接到mongodb
   $m = new MongoClient();
   echo "Connection to database successfully";
   // 选择一个数据库
   $db = $m->mydb;
   echo "Database mydb selected";
   $collection = $db->mycol;
   echo "Collection selected succsessfully";
   $document = array( 
      "title" => "MongoDB", 
      "description" => "database", 
      "likes" => 100,
      "url" => "http://www.w3cschool.cc/mongodb/",
      "by", "w3cschool.cc"
   );
   $collection->insert($document);
   echo "Document inserted successfully";
?>

执行以上程序,输出结果如下:

Connection to database successfully
Database mydb selected
Collection selected succsessfully
Document inserted successfully

更多方法:

//**向集合中插入数据,返回bool判断是否插入成功. **/
$array  = array('column_name' => 'col' . rand(100, 999), 'column_exp' => 'xiaocai');
$result = $collection->insert($array); #简单插入
echo "新记录ID:" . $array['_id']; #MongoDB会返回一个记录标识
var_dump($result); #返回:bool(true)
#插入结果:{ "_id" : ObjectId("4d63552ad549a02c01000009"), "column_name" : "col770", "column_exp" : "xiaocai" }
#'_id'为主键字段,在插入是MongoDB自动添加.

//**向集合中安全插入数据,返回插入状态(数组). **/
$array  = array('column_name' => 'col' . rand(100, 999), 'column_exp' => 'xiaocai2');
$result = $collection->insert($array, true); #用于等待MongoDB完成操作,以便确定是否成功.(当有大量记录插入时使用该参数会比较有用)
echo "新记录ID:" . $array['_id']; #MongoDB会返回一个记录标识
var_dump($result); #返回:array(3) { ["err"]=> NULL ["n"]=> int(0) ["ok"]=> float(1) }

//**插入的完整语法 **/
# insert(array $data,array('safe'=>false,'fsync'=>false,'timeout'=>10000))
# 参数说明:safe:默认false,是否安全写入;fsync:默认false,是否强制插入到同步到磁盘;timeout:超时时间(毫秒)

//**以下两次插入的为同一条记录(相同的_id),因为它们的值相同**/
$collection->insert(array('column_name' => 'xiaocai'));
$collection->insert(array('column_name' => 'xiaocai'));
#避免方法,安全插入
$collection->insert(array('column_name' => 'xiaocai'), true);
try
{
	$collection->insert(array('column_name' => 'xiaocai'), true);
}
catch(MongoCursorException $e)
{
	echo "Can't save the same person twice!\n";
}

详细资料:http://www.php.net/manual/zh/mongocollection.insert.php

查找文档

使用find() 方法来读取集合中的文档。

读取使用文档的代码片段如下:

<?php
   // 连接到mongodb
   $m = new MongoClient();
   echo "Connection to database successfully";
   // 选择一个数据库
   $db = $m->mydb;
   echo "Database mydb selected";
   $collection = $db->mycol;
   echo "Collection selected succsessfully";

   $cursor = $collection->find();
   // 迭代显示文档标题
   foreach ($cursor as $document) {
      echo $document["title"] . "\n";
   }
?>

执行以上程序,输出结果如下:

Connection to database successfully
Database mydb selected
Collection selected succsessfully
{
   "title": "MongoDB"
}

更多方法:

/** 查询文档中的记录数 **/
echo 'count:' . $collection->count() . "<br>";                                          #全部
echo 'count:' . $collection->count(array('type' => 'user')) . "<br>";                     #可以加上条件
echo 'count:' . $collection->count(array('age' => array('$gt' => 50, '$lte' => 74))) . "<br>"; #大于50小于等于74
echo 'count:' . $collection->find()->limit(5)->skip(0)->count(true) . "<br>";           #获得实际返回的结果数

/**
 * 注:$gt为大于、$gte为大于等于、$lt为小于、$lte为小于等于、$ne为不等于、$exists不存在
 */

/** 集合中所有文档 **/
$cursor = $collection->find()->snapshot();
foreach($cursor as $id => $value)
{
	echo "$id: ";
	var_dump($value);
	echo "<br>";
}
/**
 * 注意:
 *      在我们做了find()操作,获得$cursor游标之后,这个游标还是动态的.
 *      换句话说,在我find()之后,到我的游标循环完成这段时间,如果再有符合条件的记录被插入到collection,那么这些记录也会被$cursor获得.
 *      如果你想在获得$cursor之后的结果集不变化,需要这样做:
 *      $cursor = $collection->find();
 *      $cursor->snapshot();#获得快照!
 *      详见http://www.bumao.com/index.php/2010/08/mongo_php_cursor.html
 */

/** 查询一条数据 **/
$cursor = $collection->findOne();
/**
 *  注意:findOne()获得结果集后不能使用snapshot(),fields()等函数;
 */

/** age,type 列不显示 **/
$cursor = $collection->find()->fields(array("age" => false, "type" => false));

/** 只显示user 列 **/
$cursor = $collection->find()->fields(array("user" => true));
/**
 * 我这样写会出错:$cursor->fields(array("age"=>true,"type"=>false));
 */

/** (存在type,age节点) and age!=0 and age<50 **/
$where  = array('type' => array('$exists' => true), 'age' => array('$ne' => 0, '$lt' => 50, '$exists' => true));
$cursor = $collection->find($where);

/** 分页获取结果集  **/
$cursor = $collection->find()->limit(5)->skip(0);

/** 排序  **/
$cursor = $collection->find()->sort(array('age' => -1, 'type' => 1));                    #1表示降序 -1表示升序,参数的先后影响排序顺序

/** 创建索引  **/
$collection->ensureIndex(array('age' => 1, 'type' => -1));                             #1表示降序 -1表示升序
$collection->ensureIndex(array('age' => 1, 'type' => -1), array('background' => true));   #索引的创建放在后台运行(默认是同步运行)
$collection->ensureIndex(array('age' => 1, 'type' => -1), array('unique' => true));       #该索引是唯一的

/** 取得查询结果 **/
$cursor = $collection->find();
$array  = array();
foreach($cursor as $id => $value)
{
	$array[] = $value;
}

更新文档

使用 update() 方法来更新文档。

以下实例将更新文档中的标题为’ MongoDB Tutorial’, 代码片段如下:

<pre>
<?php
   // 连接到mongodb
   $m = new MongoClient();
   echo "Connection to database successfully";
   // 选择一个数据库
   $db = $m->mydb;
   echo "Database mydb selected";
   $collection = $db->mycol;
   echo "Collection selected succsessfully";

   // 更新文档
   $collection->update(array("title"=>"MongoDB"), array('$set'=>array("title"=>"MongoDB Tutorial")));
   echo "Document updated successfully";
   // 显示更新后的文档
   $cursor = $collection->find();
   // 循环显示文档标题
   echo "Updated document";
   foreach ($cursor as $document) {
      echo $document["title"] . "\n";
   }
?>

执行以上程序,输出结果如下:

Connection to database successfully
Database mydb selected
Collection selected succsessfully
Document updated successfully
Updated document
{
   "title": "MongoDB Tutorial"
}

更多方法:

//** 修改更新 **/
$where   = array('column_name' => 'col123');
$newdata = array('column_exp' => 'GGGGGGG', 'column_fid' => 444);
$result  = $collection->update($where, array('$set' => $newdata)); #$set:让某节点等于给定值
/*
 * 原数据
 * {"_id":ObjectId("4d635ba2d549a02801000003"),"column_name":"col123","column_exp":"xiaocai"}
 * 被替换成了
 * {"_id":ObjectId("4d635ba2d549a02801000003"),"column_name":"col123","column_exp":"GGGGGGG","column_fid":444}
 */

//** 替换更新 **/
$where   = array('column_name' => 'col709');
$newdata = array('column_exp' => 'HHHHHHHHH', 'column_fid' => 123);
$result  = $collection->update($where, $newdata);
/*
 * 原数据
 * {"_id":ObjectId("4d635ba2d549a02801000003"),"column_name":"col709","column_exp":"xiaocai"}
 * 被替换成了
 * {"_id":ObjectId("4d635ba2d549a02801000003"),"column_exp":"HHHHHHHHH","column_fid":123}
 */

//** 批量更新 **/
$where   = array('column_name' => 'col');
$newdata = array('column_exp' => 'multiple', '91u' => 684435);
$result  = $collection->update($where, array('$set' => $newdata), array('multiple' => true));
/**
 * 所有'column_name'='col'都被修改
 */

//** 自动累加 **/
$where   = array('91u' => 684435);
$newdata = array('column_exp' => 'edit');
$result  = $collection->update($where, array('$set' => $newdata, '$inc' => array('91u' => -5)));
/**
 * 更新91u=684435的数据,并且91u自减5
 * 注意:91u存在时加上-5,不存在时就设置91u=-5
 */

//**  匹配到就更新,否则新增  **/
$c->update(array("name" => "joe"), array("username" => "joe312", "createdAt" => new MongoDate()), array("upsert" => true) #up(date)(in)sert
);

/** 删除节点 **/
$where  = array('column_name' => 'col685');
$result = $collection->update($where, array('$unset' => 'column_exp'));
/**
 * 删除节点column_exp
 */

/** 附加新数据到节点 **/
$coll->update(array('b' => 1), array('$push' => array('a' => 'wow')) #附加新数据到节点a
);
# 如果对应节点是个数组,就附加一个新的值上去;不存在,就创建这个数组,并附加一个值在这个数组上;
# 如果该节点不是数组,返回错误。
# 原纪录:array('a'=>array(0=>'haha'),'b'=>1)
# 新记录为:array('a'=>array(0=>'haha',1=>'wow'),'b'=>1)
# $pushAll与$push类似,只是会一次附加多个数值到某节点

/** 判断更新 **/
$coll->update(array('b' => 1), array('$addToSet' => array('a' => 'wow')));
# 如果该阶段的数组中没有某值,就添加之
# 设记录结构为array('a'=>array(0=>'haha'),'b'=>1)
# 如果在a节点中已经有了wow,那么就不会再添加新的,
# 如果没有,就会为该节点添加新的item——wow。

/** 删除某数组节点的最后一个元素 **/
$coll->update(array('b' => 1), array('$pop' => array('a' => 1)) #删除a数组节点的最后一个元素
);

/** 删除某数组节点的第一个元素 **/
$coll->update(array('b' => 1), array('$pop' => array('a' => -1)) #删除a数组节点的第一个元素
);

/** 删除某数组节点的元素 **/
$coll->update(array('b' => 1), array('$pull' => array('a' => 'haha')))
# 如果该节点是个数组,那么删除其值为value的子项,如果不是数组,会返回一个错误。
# 原记录为:array('a'=>array(0=>'haha',1=>'wow'),'b'=>1),
# 删除a中value为haha的子项
# 结果为: array('a'=>array(0=>'wow'),'b'=>1)
# $pullAll与$pull类似,只是可以删除一组符合条件的记录。

# 注意:
# 1.注意区分替换更新与修改更新
# 2.注意区分数据类型如 array('91u'=>'684435')与array('91u'=>684435)
# 详细资料:http://www.mongodb.org/display/DOCS/Updating#Updating-%24bit

删除文档

使用 remove() 方法来删除文档。

以下实例中我们将移除 ‘title’ 为 ‘MongoDB Tutorial’ 的数据记录。, 代码片段如下:

<?php
   // 连接到mongodb
   $m = new MongoClient();
   echo "Connection to database successfully";
   // 选择一个数据库
   $db = $m->mydb;
   echo "Database mydb selected";
   $collection = $db->mycol;
   echo "Collection selected succsessfully";
   
   // 移除文档
   $collection->remove(array("title"=>"MongoDB Tutorial"),false);
   echo "Documents deleted successfully";
   
   // 显示可用文档数据
   $cursor = $collection->find();
   // iterate cursor to display title of documents
   echo "Updated document";
   foreach ($cursor as $document) {
      echo $document["title"] . "\n";
   }
?>

执行以上程序,输出结果如下:

Connection to database successfully
Database mydb selected
Collection selected succsessfully
Documents deleted successfully

更多方法:

/** 删除 **/
$collection->remove(array('column_name' => 'col399'));
//$collection->remove();                #清空集合
//$collection->drop();                  #清空,效率高于remove()


/** 删除指定MongoId **/
$id = new MongoId("4d638ea1d549a02801000011");
$collection->remove(array('_id' => (object)$id));
/*
 * *
 *  使用下面的方法来匹配{"_id":ObjectId("4d638ea1d549a02801000011")},查询、更新也一样
 *  $id = new MongoId("4d638ea1d549a02801000011");
 *  array('_id'=>(object)$id)
 * *
 */

除了以上实例外,在php中你还可以使用findOne(), save(), limit(), skip(), sort()等方法来操作Mongodb数据库。

一个简单的php mongodb操作类,只写了个php 查询mongodb库的操作;

代码:

<?php

class myMongodb
{
	private static $_instance;

	private $_conn = null;

	private $_collection = null;

	private function __construct($host, $port, $database, $tableName)
	{
		$this->_conn = new Mongo("mongodb://{$host}:{$port}");

		$this->_collection = $this->_conn->$database->$tableName;
	}

	private function __clone() { }

	/**
	 * @param $host         mongodb服务器地址
	 * @param $port         mongodb服务器端口
	 * @param $database     数据库名称
	 * @param $tableName    数据库表名称
	 * @return myMongodb
	 */
	public function get_instance($host, $port, $database, $tableName)
	{
		if(!(self::$_instance instanceof self))
		{
			self::$_instance = new self($host, $port, $database, $tableName);
		}

		return self::$_instance;
	}

	public function close()
	{
		$this->_conn->close();
	}

	/**
	 * 查询数据
	 * @param array $condition    查询条件
	 * @param array $fields       查询字段
	 * @param array $sort         结果排序
	 * @param int   $skip
	 * @param int   $limit
	 * @return array
	 */
	public function find($condition, $fields, $sort, $skip = 0, $limit = 20)
	{
		$tmp = $this->_collection->find($condition)->fields($fields)->sort($sort)->skip($skip)->limit($limit);

		$result = array();
		foreach($tmp as $value)
		{
			$result[] = $value;
		}

		return $result;
	}

	//获取集合总数
	public function count($condition = '')
	{
		if($condition == '')
		{
			return $this->_collection->count();
		}

		return $this->_collection->count($condition);
	}
}

 

参考:

http://www.runoob.com/mongodb/mongodb-php.html

http://www.bkjia.com/jingyan/491295.html

 

MongoDB 系列教程索引 : MongoDB 教程索引 (附有视频)

上一篇: MongoDB 教程六: MongoDB管理:数据导入导出,数据备份恢复及用户安全与认证

下一篇: MongoDB 教程八(结语): 一网打尽当下NoSQL类型、适用场景及使用公司

本文:MongoDB 教程七: MongoDB和PHP结合开发