Download and Install

Install the MongoDB PHP Extension

Laravel MongoDB requires the MongoDB PHP Extension to manage MongoDB connections and commands. Follow the Installing the MongoDB PHP Driver with PECL guide to install the MongoDB PHP Extension.

Install Laravel

Ensure that the version of Laravel you install is compatible with the version of Laravel MongoDB. To learn which versions are compatible, see the Compatibility page.

Run the following command to install Laravel:

composer global require laravel/installer

When the installation completes, the command outputs the following message:

Using version ^<version number> for laravel/installer

Create a Laravel application

Run the following command to generate a new Laravel web application called my-app:

laravel new my-app

When the installation completes, the command outputs the following message:

INFO  Application ready in [my-app]. You can start your local development using:
➜ cd my-app
➜ php artisan serve
New to Laravel? Check out our bootcamp and documentation. Build something amazing!

Add a Laravel application encryption key

Navigate to the application directory you created in the previous step:

cd my-app

Run the following command to add the Laravel application encryption key, which is required to encrypt cookies:

php artisan key:generate

Add Laravel MongoDB to the dependencies

Run the following command to add the Laravel MongoDB dependency to your application:

composer require mongodb/laravel-mongodb:^4.6

When the installation completes, verify that the composer.json file includes the following line in the require object:

"mongodb/laravel-mongodb": "^4.6"

After completing these steps, you have a new Laravel project with the Laravel MongoDB dependencies installed.