Linux系统下PHP MongoDB驱动安装配置指南

安装前的准备工作

MongoDB 旨在结合键/值存储的高性能伸缩性与传统关系型数据库的功能优势。要在 PHP 代码中使用 MongoDB，必须先在服务器上安装对应的 mongodb 扩展。确保你的服务器已具备基本的开发工具链（如 gcc、make 等）以及 PHP 的 pecl 管理权限。

详细操作步骤

第1步：下载驱动源码包

为了获取最新或稳定的版本，可以从 PECL 官方仓库下载源码。以下以 mongodb-1.1.9.tgz 为例：

wget https://pecl.php.net/get/mongodb-1.1.9.tgz

注意：实际生产中建议访问 PECL mongodb 页面 确认当前推荐安装的最新版本号，替换上述命令中的版本号。

第2步：解压安装包

将下载的压缩包解压到工作目录：

tar zxf ./mongodb-1.1.9.tgz

进入解压后的目录：

cd mongodb-1.1.9

第3步：编译并安装驱动

使用 pecl 工具直接进行安装。这是最便捷的方式，它会自动处理编译和安装过程：

pecl install mongodb

如果通过 tar 解压后手动编译，也可以执行：
phpize → ./configure → make → make install

第4步：配置 PHP 启用扩展

安装完成后，需要告诉 PHP 加载该扩展。打开你的 PHP 配置文件 php.ini（通常位于 /etc/php/version/fpm/php.ini 或类似路径），在文件末尾或 [modules] 部分添加以下内容：

extension=mongodb.so

重要提示：请根据实际 PHP 版本确认 .so 文件的完整路径。如果不确定路径，可通过命令行运行 php -i | grep extension_dir 查看扩展目录。

第5步：重启 PHP 服务

修改配置后，必须重启 PHP-FPM 进程以使更改生效：

/etc/init.d/php-fpm restart

如果使用 systemd 管理的系统，命令可能为 systemctl restart php-fpm 或 systemctl restart php8.x-fpm。

验证与注意事项

配置完成后，你可以创建一个简单的 PHP 文件，运行 phpinfo() 或者检查输出内容中是否包含 "mongodb" 扩展信息。此外，请确保目标 MongoDB 服务器处于运行状态，并且网络连接畅通，才能进行正常的读写操作。

常见问题排查

• 找不到 mongodb.so：检查 php.ini 中的路径是否正确，或重新运行 pecl install mongodb 以确保库文件已复制到正确的扩展目录。
• 权限不足：执行安装和重启服务时可能需要 root 权限或使用 sudo。
• 版本兼容性：确保安装的 MongoDB 驱动版本与你使用的 PHP 版本及 MongoDB 服务端版本兼容。

以上就是在 Linux 系统中为 PHP 安装和配置 MongoDB 驱动的详细内容，更多关于 PHP 数据库集成的资料请关注本站其它相关文章！