MongoDB PHP 扩展

在PHP中使用MongoDB通常涉及到安装MongoDB PHP扩展并使用该扩展提供的类和函数来与MongoDB数据库交互。以下是使用MongoDB PHP扩展的基本指南：

1. 安装扩展

方法一：使用 PECL

你可以通过PECL（PHP Extension Community Library）来安装MongoDB扩展。确保你已经安装了PECL，然后在命令行中运行以下命令：

pecl install mongodb

安装完成后，你需要在php.ini文件中启用这个扩展。添加以下行：

extension=mongodb.so

如果你使用的是Windows系统，应该添加：

extension=mongodb.php

重启你的Web服务器（如Apache或Nginx）以使更改生效。

方法二：使用Composer

如果你的项目使用Composer作为依赖管理器，可以使用ext-mongodb包来代替PECL扩展。在composer.json文件中添加以下依赖：

{
    "require": {
        "mongodb/mongodb": "^1.15"
    }
}

然后运行composer install来安装依赖。

2. 基本用法

一旦安装了MongoDB扩展，你就可以开始使用它来连接到MongoDB服务器并执行操作。

连接到MongoDB

<?php

use MongoDB\Driver\Manager;
use MongoDB\Driver\Session;
use MongoDB\Driver\Monitoring\CommandSucceededEvent;

$manager = new Manager('mongodb://localhost:27017');

// 或者使用MongoDB\Client类（推荐）
$client = new MongoDB\Client('mongodb://localhost:27017');

// 获取名为"myDatabase"的数据库
$database = $client->myDatabase;

// 获取名为"myCollection"的集合
$collection = $database->myCollection;
?>

插入文档

<?php

use MongoDB\Model\BSONDocument;

// 创建一个文档
$document = new BSONDocument([
    'name' => 'John Doe',
    'email' => 'john.doe@example.com',
    'age' => 30
]);

// 插入文档
$collection->insertOne($document);
?>

查询文档

<?php

// 查询名字为"John Doe"的文档
$cursor = $collection->find(['name' => 'John Doe']);

foreach ($cursor as $document) {
    echo $document->toJson() . "\n";
}
?>

更新文档

<?php

// 更新名字为"John Doe"的文档的电子邮件
$collection->updateOne(
    ['name' => 'John Doe'],
    ['$set' => ['email' => 'johndoe@newemail.com']]
);
?>

删除文档

<?php

// 删除名字为"John Doe"的文档
$collection->deleteOne(['name' => 'John Doe']);
?>

3. 高级功能

MongoDB PHP扩展支持很多高级功能，包括事务处理、聚合管道、索引管理等。

聚合管道

<?php

$pipeline = [
    ['$match' => ['name' => 'John Doe']],
    ['$project' => ['_id' => 0, 'email' => 1]]
];

$cursor = $collection->aggregate($pipeline);

foreach ($cursor as $document) {
    echo $document->toJson() . "\n";
}
?>

创建索引

<?php

// 创建一个名为"name"的升序索引
$collection->createIndex(['name' => 1]);

// 创建一个唯一索引
$collection->createIndex(['email' => 1], ['unique' => true]);
?>

事务处理

<?php

$session = $client->startSession();
$session->startTransaction();

try {
    $collection->insertOne(['name' => 'Jane Doe'], ['session' => $session]);
    $collection->updateOne(['name' => 'John Doe'], ['$set' => ['email' => 'john.doe@newemail.com']], ['session' => $session]);

    $session->commitTransaction();
} catch (\Throwable $e) {
    $session->abortTransaction();
}
?>

4. 错误处理

确保你的代码能够妥善处理可能出现的错误。例如，当插入操作失败时，可以捕获异常并采取相应的措施。

try {
    $result = $collection->insertOne($document);
} catch (\MongoDB\Driver\Exception\Exception $e) {
    echo "Error inserting document: " . $e->getMessage();
}

总结

以上是使用MongoDB PHP扩展的基本介绍。你可以参考MongoDB官方文档来了解更多细节和高级功能。如果你有更具体的需求或者遇到问题，请随时告诉我！