PHP Mongodb API参考

<?php
/*** Mongodb类** examples:
* $mongo = new HMongodb("127.0.0.1:11223");
* $mongo->selectDb("test_db");
* 创建索引
* $mongo->ensureIndex("test_table", array("id"=>1), array('unique'=>true));
* 获取表的记录
* $mongo->count("test_table");
* 插入记录
* $mongo->insert("test_table", array("id"=>2, "title"=>"asdqw"));
* 更新记录
* $mongo->update("test_table", array("id"=>1),array("id"=>1,"title"=>"bbb"));
* 更新记录-存在时更新，不存在时添加-相当于set
* $mongo->update("test_table", array("id"=>1),array("id"=>1,"title"=>"bbb"),array("upsert"=>1));
* 查找记录
* $mongo->find("c", array("title"=>"asdqw"), array("start"=>2,"limit"=>2,"sort"=>array("id"=>1)))
* 查找一条记录
* $mongo->findOne("$mongo->findOne("ttt", array("id"=>1))", array("id"=>1));
* 删除记录
* $mongo->remove("ttt", array("title"=>"bbb"));
* 仅删除一条记录
* $mongo->remove("ttt", array("title"=>"bbb"), array("justOne"=>1));
* 获取Mongo操作的错误信息
* $mongo->getError();
*/  

class HMongodb {  

    //Mongodb连接
    var $mongo;  

    var $curr_db_name;
    var $curr_table_name;
    var $error;  

    /**
    * 构造函数
    * 支持传入多个mongo_server(1.一个出问题时连接其它的server 2.自动将查询均匀分发到不同server)
    *
    * 参数：
    * $mongo_server:数组或字符串-array("127.0.0.1:1111", "127.0.0.1:2222")-"127.0.0.1:1111"
    * $connect:初始化mongo对象时是否连接，默认连接
    * $auto_balance:是否自动做负载均衡，默认是
    *
    * 返回值：
    * 成功：mongo object
    * 失败：false
    */
    function __construct($mongo_server, $connect=true, $auto_balance=true)
    {
        if (is_array($mongo_server))
        {
            $mongo_server_num = count($mongo_server);
            if ($mongo_server_num > 1 && $auto_balance)
            {
                $prior_server_num = rand(1, $mongo_server_num);
                $rand_keys = array_rand($mongo_server,$mongo_server_num);
                $mongo_server_str = $mongo_server[$prior_server_num-1];
                foreach ($rand_keys as $key)
                {
                    if ($key != $prior_server_num - 1)
                    {
                        $mongo_server_str .= ',' . $mongo_server[$key];
                    }
                }
            }
            else
            {
                $mongo_server_str = implode(',', $mongo_server);
            }                  }
        else
        {
            $mongo_server_str = $mongo_server;
        }
        try {
            $this->mongo = new Mongo($mongo_server, array('connect'=>$connect));
        }
        catch (MongoConnectionException $e)
        {
            $this->error = $e->getMessage();
            return false;
        }
    }  

    function getInstance($mongo_server, $flag=array())
    {
        static $mongodb_arr;
        if (emptyempty($flag['tag']))
        {
            $flag['tag'] = 'default';          }
        if (isset($flag['force']) && $flag['force'] == true)
        {
            $mongo = new HMongodb($mongo_server);
            if (emptyempty($mongodb_arr[$flag['tag']]))
            {
                $mongodb_arr[$flag['tag']] = $mongo;
            }
            return $mongo;
        }
        else if (isset($mongodb_arr[$flag['tag']]) && is_resource($mongodb_arr[$flag['tag']]))
        {
            return $mongodb_arr[$flag['tag']];
        }
        else
        {
            $mongo = new HMongodb($mongo_server);
            $mongodb_arr[$flag['tag']] = $mongo;
            return $mongo;                  }          }  

    /**
    * 连接mongodb server
    *
    * 参数：无
    *
    * 返回值：
    * 成功：true
    * 失败：false
    */
    function connect()
    {
        try {
            $this->mongo->connect();
            return true;
        }
        catch (MongoConnectionException $e)
        {
            $this->error = $e->getMessage();
            return false;
        }
    }  

    /**
    * select db
    *
    * 参数：$dbname
    *
    * 返回值：无
    */
    function selectDb($dbname)
    {
        $this->curr_db_name = $dbname;
    }  

    /**
    * 创建索引：如索引已存在，则返回。
    *
    * 参数：
    * $table_name:表名
    * $index:索引-array("id"=>1)-在id字段建立升序索引
    * $index_param:其它条件-是否唯一索引等
    *
    * 返回值：
    * 成功：true
    * 失败：false
    */
    function ensureIndex($table_name, $index, $index_param=array())
    {
        $dbname = $this->curr_db_name;
        $index_param['safe'] = 1;
        try {
            $this->mongo->$dbname->$table_name->ensureIndex($index, $index_param);
            return true;
        }
        catch (MongoCursorException $e)
        {
            $this->error = $e->getMessage();
            return false;
        }
    }  

    /**
    * 插入记录
    *
    * 参数：
    * $table_name:表名
    * $record:记录
    *
    * 返回值：
    * 成功：true
    * 失败：false
    */
    function insert($table_name, $record)
    {
        $dbname = $this->curr_db_name;
        try {
            $this->mongo->$dbname->$table_name->insert($record, array('safe'=>true));
            return true;
        }
        catch (MongoCursorException $e)
        {
            $this->error = $e->getMessage();
            return false;
        }
    }  

    /**
    * 查询表的记录数
    *
    * 参数：
    * $table_name:表名
    *
    * 返回值：表的记录数
    */
    function count($table_name)
    {
        $dbname = $this->curr_db_name;
        return $this->mongo->$dbname->$table_name->count();
    }  

    /**
    * 更新记录
    *
    * 参数：
    * $table_name:表名
    * $condition:更新条件
    * $newdata:新的数据记录
    * $options:更新选择-upsert/multiple
    *
    * 返回值：
    * 成功：true
    * 失败：false
    */
    function update($table_name, $condition, $newdata, $options=array())
    {
        $dbname = $this->curr_db_name;
        $options['safe'] = 1;
        if (!isset($options['multiple']))
        {
            $options['multiple'] = 0;          }
        try {
            $this->mongo->$dbname->$table_name->update($condition, $newdata, $options);
            return true;
        }
        catch (MongoCursorException $e)
        {
            $this->error = $e->getMessage();
            return false;
        }          }  

    /**
    * 删除记录
    *
    * 参数：
    * $table_name:表名
    * $condition:删除条件
    * $options:删除选择-justOne
    *
    * 返回值：
    * 成功：true
    * 失败：false
    */
    function remove($table_name, $condition, $options=array())
    {
        $dbname = $this->curr_db_name;
        $options['safe'] = 1;
        try {
            $this->mongo->$dbname->$table_name->remove($condition, $options);
            return true;
        }
        catch (MongoCursorException $e)
        {
            $this->error = $e->getMessage();
            return false;
        }          }  

    /**
    * 查找记录
    *
    * 参数：
    * $table_name:表名
    * $query_condition:字段查找条件
    * $result_condition:查询结果限制条件-limit/sort等
    * $fields:获取字段
    *
    * 返回值：
    * 成功：记录集
    * 失败：false
    */
    function find($table_name, $query_condition, $result_condition=array(), $fields=array())
    {
        $dbname = $this->curr_db_name;
        $cursor = $this->mongo->$dbname->$table_name->find($query_condition, $fields);
        if (!emptyempty($result_condition['start']))
        {
            $cursor->skip($result_condition['start']);
        }
        if (!emptyempty($result_condition['limit']))
        {
            $cursor->limit($result_condition['limit']);
        }
        if (!emptyempty($result_condition['sort']))
        {
            $cursor->sort($result_condition['sort']);
        }
        $result = array();
        try {
            while ($cursor->hasNext())
            {
                $result[] = $cursor->getNext();
            }
        }
        catch (MongoConnectionException $e)
        {
            $this->error = $e->getMessage();
            return false;
        }
        catch (MongoCursorTimeoutException $e)
        {
            $this->error = $e->getMessage();
            return false;
        }
        return $result;
    }  

    /**
    * 查找一条记录
    *
    * 参数：
    * $table_name:表名
    * $condition:查找条件
    * $fields:获取字段
    *
    * 返回值：
    * 成功：一条记录
    * 失败：false
    */
    function findOne($table_name, $condition, $fields=array())
    {
        $dbname = $this->curr_db_name;
        return $this->mongo->$dbname->$table_name->findOne($condition, $fields);
    }  

    /**
    * 获取当前错误信息
    *
    * 参数：无
    *
    * 返回值：当前错误信息
    */
    function getError()
    {
        return $this->error;
    }
}  

?>