🎬 HoRain 云小助手：个人主页

⛺️生活的理想，就是为了理想的生活!

---

⛳️ 推荐

前些天发现了一个超棒的服务器购买网站，性价比超高，大内存超划算！忍不住分享一下给大家。点击跳转到网站。

目录

⛳️ 推荐

🔧 一、安装 MongoDB PHP 扩展

​​1. Linux 系统安装​​

​​2. Windows 系统安装​​

​​3. macOS 系统安装​​

​​4. 使用 Composer 安装库​​

🧪 二、验证安装

🔌 三、基本使用示例

⚠️ 四、常见问题与注意事项

💡 五、进阶：使用 Doctrine MongoDB ODM

---

安装和使用 MongoDB PHP 扩展可以让你在 PHP 项目中轻松连接和操作 MongoDB 数据库。以下是详细的安装步骤、基本使用方法以及注意事项。

​​安装前，请务必确认你的 PHP 版本​​，并选择与之匹配的 MongoDB 扩展版本。你可以通过 phpinfo() 函数或命令行执行 php -v 来查看 PHP 版本、线程安全（Thread Safety，TS 或 NTS）以及架构（x86 或 x64）信息。

🔧 一、安装 MongoDB PHP 扩展

​​1. Linux 系统安装​​

Linux 系统推荐使用 pecl 工具进行安装，这是最简便的方法。

sudo pecl install mongodb

安装成功后，需要在 php.ini 配置文件中添加一行来启用扩展：

extension=mongodb.so

如果无法使用 pecl 在线安装，你也可以选择​​手动编译安装​​：

wget https://pecl.php.net/get/mongodb-1.15.0.tgz # 请替换为最新稳定版本
tar -zxvf mongodb-1.15.0.tgz
cd mongodb-1.15.0
phpize
./configure
make && make install

手动编译后，同样需要在 php.ini 中添加 extension=mongodb.so。

​​2. Windows 系统安装​​

Windows 下的安装过程主要是下载正确的 DLL 文件并进行配置。

1. ​​下载 DLL​​：访问 PECL 的 MongoDB 页面，根据你的 PHP 版本、线程安全（TS/NTS）和架构（x86/x64）下载对应的 .dll 文件。
2. ​​放置 DLL 文件​​：将下载的 php_mongodb.dll 文件复制到你的 PHP 扩展目录（通常是 PHP 安装目录下的 ext 文件夹）。
3. ​​修改配置​​：在 php.ini 文件中添加以下配置：

   extension=php_mongodb.dll

4. ​​重启服务​​：​​重启 Web 服务器​​（如 Apache、Nginx）或 PHP-FPM，使配置生效。

​​3. macOS 系统安装​​

在 macOS 上，通常可以使用 Homebrew 来安装，或者采用与 Linux 系统类似的 pecl 安装方法：

brew install php-mongodb # 如果使用Homebrew管理的PHP
# 或者
pecl install mongodb

同样，安装后需在 php.ini 中配置 extension=mongodb.so。

​​4. 使用 Composer 安装库​​

虽然 pecl 安装了底层的 C 语言扩展，但为了更方便地操作 MongoDB，官方还提供了一个 PHP 库。建议使用 Composer 将其安装到你的项目中：

composer require mongodb/mongodb

这个库提供了更友好、面向对象的 API。

🧪 二、验证安装

安装和配置完成后，可以通过以下方式验证扩展是否成功启用：

1. 创建一个 PHP 文件（如 info.php），内容为：

   <?php
   phpinfo();
   ?>

   在浏览器中访问该文件，搜索 "mongodb"，如果能看到 MongoDB 扩展的相关信息，说明安装成功。
2. 或者在命令行中执行：

   php -m | grep mongodb

   如果输出 mongodb，则证明扩展已加载。

🔌 三、基本使用示例

安装成功后，你就可以在 PHP 代码中连接和操作 MongoDB 了。

​​1. 连接 MongoDB​​

<?php
require 'vendor/autoload.php'; // 引入Composer自动加载文件，如果你安装了mongodb/mongodb库

// 连接到默认的本地MongoDB实例 (mongodb://localhost:27017)
$client = new MongoDB\Client;

// 或者指定连接字符串
// $client = new MongoDB\Client("mongodb://用户名:密码@主机:端口");
?>

​​2. 选择数据库和集合​​

$db = $client->selectDatabase('my_database');
$collection = $db->selectCollection('my_collection');
// 或者更简洁的链式写法
$collection = (new MongoDB\Client)->my_database->my_collection;

​​3. 插入文档​​

$insertResult = $collection->insertOne([
    'name' => 'Alice',
    'email' => 'alice@example.com',
    'age' => 30
]);
echo "插入的文档ID: " . $insertResult->getInsertedId();

​​4. 查询文档​​

// 查询单个文档
$document = $collection->findOne(['name' => 'Alice']);
var_dump($document);

// 查询多个文档
$cursor = $collection->find(['age' => ['$gt' => 25]]); // 查找年龄大于25的文档
foreach ($cursor as $doc) {
    var_dump($doc);
}

​​5. 更新文档​​

$updateResult = $collection->updateOne(
    ['name' => 'Alice'], // 过滤条件
    ['$set' => ['age' => 31]] // 更新操作
);
echo "匹配了 " . $updateResult->getMatchedCount() . " 个文档，修改了 " . $updateResult->getModifiedCount() . " 个文档";

​​6. 删除文档​​

$deleteResult = $collection->deleteOne(['name' => 'Alice']);
echo "删除了 " . $deleteResult->getDeletedCount() . " 个文档";

以上示例基于 mongodb/mongodb 库，它提供了比底层驱动更易用的接口。

⚠️ 四、常见问题与注意事项

• ​​版本兼容性​​：这是最常见的问题。务必确保你下载的扩展版本与你的 PHP 版本、线程安全（TS/NTS）和架构（x86/x64）完全匹配。不匹配会导致 PHP 无法加载扩展。
• ​​找不到扩展​​：确保 php.ini 中 extension_dir 的路径设置正确，指向你放置 mongodb.so 或 php_mongodb.dll 文件的目录。
• ​​修改 php.ini 后未重启服务​​：​​每次修改 php.ini 后，必须重启 Web 服务器或 PHP-FPM 进程​​，更改才会生效。
• ​​使用 Composer 包​​：即使正确安装了 PECL 扩展，如果你在代码中使用了 mongodb/mongodb 这个 Composer 包，也不要忘记在项目中通过 Composer 安装它，并引入 vendor/autoload.php。
• ​​权限问题​​：在 Linux/macOS 系统下，运行 Web 服务器的用户需要对扩展文件有读取权限。
• ​​寻求帮助​​：如果遇到问题，首先检查 PHP 错误日志，通常可以获得详细的错误信息。

💡 五、进阶：使用 Doctrine MongoDB ODM

对于复杂的项目，你可能会考虑使用 ​​Doctrine MongoDB ODM​​（对象文档映射器）。它就像 MongoDB 世界的 “Doctrine ORM”，允许你通过操作 PHP 对象来操作数据库中的文档，无需手动编写大量的查询语句。

composer require doctrine/mongodb-odm

使用 ODM 需要定义文档类（类似于 Entity），并配置元数据（如注解、XML或YAML），它可以极大地提升开发效率和代码的可维护性。

安装 MongoDB PHP 扩展是连接 PHP 和 MongoDB 的第一步。关键在于确保版本兼容，配置正确。成功后，你就可以利用 PHP 强大而灵活地操作 MongoDB 数据库了。

❤️❤️❤️本人水平有限，如有纰漏，欢迎各位大佬评论批评指正！😄😄😄

💘💘💘如果觉得这篇文对你有帮助的话，也请给个点赞、收藏下吧，非常感谢!👍 👍 👍

🔥🔥🔥Stay Hungry Stay Foolish 道阻且长,行则将至,让我们一起加油吧！🌙🌙🌙