A Comprehensive Guide to Installing and Configuring PHP with MongoDB on CentOS

gitbox 2025-06-14

Preparing the Environment

Before you start, make sure your CentOS system is up-to-date and that PHP is already installed. You can check the current PHP version using the following command:

php -v

If PHP is not installed, you can install it using the following command:

sudo yum install php php-cli php-pear

Installing MongoDB

Next, you need to configure the MongoDB repository. You can set up the MongoDB YUM repository using the following command:

cat <<EOF | sudo tee /etc/yum.repos.d/mongodb-org-4.4.repo
[mongodb-org-4.4]
name=MongoDB Repository
baseurl=https://repo.mongodb.org/yum/redhat/7/mongodb-org/4.4/x86_64/
gpgcheck=1
enabled=1
gpgkey=https://www.mongodb.org/static/pgp/server-4.4.asc
EOF

Then, install MongoDB using the following command:

sudo yum install -y mongodb-org

Starting MongoDB Service

Once installation is complete, you can start the MongoDB service using the following command:

sudo systemctl start mongod

To ensure that MongoDB starts automatically after a system reboot, use the following command:

sudo systemctl enable mongod

Installing the MongoDB PHP Extension

To enable PHP to interact with MongoDB, you need to install the MongoDB PHP extension. Install it using the following command:

sudo pecl install mongodb

After installation, add the following configuration to your PHP configuration file:

echo "extension=mongodb.so" | sudo tee /etc/php.d/45-mongodb.ini

Verifying the Installation

After restarting the PHP service, verify that the MongoDB PHP extension is successfully loaded using the following command:

php -m | grep mongodb

If you see "mongodb" in the output, then PHP and MongoDB are successfully configured.

Conclusion

By following this guide, you have successfully configured PHP with MongoDB on CentOS. This setup will provide strong support for your development projects and enable you to leverage the advantages of both technologies. If you encounter any issues, you can refer to the official documentation or community resources for assistance.