MongoDB PHP Adapter 安装与使用指南

---

项目目录结构及介绍

MongoDB PHP Adapter 是一个用于适配老版 ext-mongo 库到新版 MongoDB 驱动 (ext-mongodb) 的用户层库。它使依赖于 ext-mongo 的应用能在 PHP 7 及以上版本运行。以下是项目的基本目录结构概览：

mongo-php-adapter/
├── composer.json          # 依赖管理文件
├── CHANGELOG.md           # 版本更新日志
├── LICENSE                # 许可证文件
├── README.md              # 项目说明文档
├── lib                    # 核心代码库，包含了适配器的主要实现
│   └── Alcaeus            # 项目的主要命名空间，存放各类适配类
├── tests                  # 测试套件，用于单元测试
│   ├── autoload.php       # 自动加载测试类库
│   └── ...                # 各类测试文件
├── github                 # 通常包含GitHub工作流相关配置
├── composer.lock          # Composer锁定文件
├── .gitignore             # Git忽略文件列表
├── phpunit.xml.dist      # PHPUnit测试框架配置文件
└── ...

注解：

• lib 目录是核心，包含了对旧接口的模拟实现。
• tests 是用于确保代码质量的测试集合。
• composer.json 控制依赖关系与自动加载。

项目的启动文件介绍

该项目本身不需要直接“启动”，它作为一个库被集成进使用它的PHP应用程序中。安装并配置此库后，通过Composer将之引入你的项目即可开始利用其提供的适配功能。

在用户应用层面，使用时首先应确保安装了正确的MongoDB新驱动(ext-mongodb)，然后通过以下Composer命令添加该适配器到你的项目依赖中（注意处理可能的兼容性问题）：

composer require alcaeus/mongo-php-adapter

如果是针对PHP 8的环境，还需要考虑版本兼容性，例如使用特定版本标签：

composer require alcaeus/mongo-php-adapter:^1.2.0

项目的配置文件介绍

Composer.json 配置

主要的配置位于项目自己的 composer.json 文件内，但在用户端，为了适应旧版Mongo扩展的逻辑同时安装新的MongoDB驱动，你可能需要调整或增加如下配置以绕过composer平台要求检查：

{
    "config": {
        "platform": {
            "ext-mongo": "1.6.16"
        }
    },
    "require": {
        "alcaeus/mongo-php-adapter": "*"
    }
}

之后运行 composer install 或在已有的项目中添加上述配置后运行 composer update。

应用级别的配置

在实际应用中，并没有特定的“配置文件”直接关联到MongoDB PHP Adapter。其配置主要是通过PHP代码中的MongoDB客户端初始化过程来完成的，比如连接字符串的指定等，这通常是在应用启动阶段或数据库访问层进行的设置。

例如，若要配置数据库连接，你会直接在应用代码里这样做（不是在Adapter本身）：

$client = new \MongoDB\Client("mongodb://localhost");

对于MongoDB PHP Adapter来说，关键在于通过上述提到的Composer配置步骤，正确地将其置于依赖链中，使得你的应用能够透明地使用原有的 ext-mongo 接口而不做过多修改。

---

总结而言，MongoDB PHP Adapter的使用更多地涉及到开发环境的配置而非独立应用的启动流程或特定配置文件维护。开发者需关注的是库的正确安装与依赖解决，以及在编码中按需调用MongoDB操作，确保应用平滑过渡至新驱动。