PHPackages                             techapi/mongo-laravel - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Database & ORM](/categories/database)
4. /
5. techapi/mongo-laravel

ActiveLibrary[Database & ORM](/categories/database)

techapi/mongo-laravel
=====================

Integração Mongo

v1.0.18(7mo ago)0375MITPHPPHP ^8.2

Since Jul 29Pushed 7mo agoCompare

[ Source](https://github.com/CredFranco/mongo-laravel)[ Packagist](https://packagist.org/packages/techapi/mongo-laravel)[ RSS](/packages/techapi-mongo-laravel/feed)WikiDiscussions main Synced today

READMEChangelogDependencies (2)Versions (20)Used By (0)

Mongo Laravel
=============

[](#mongo-laravel)

Uma biblioteca Laravel para integração simplificada com MongoDB, oferecendo uma interface fluente e intuitiva para operações com banco de dados MongoDB.

📋 Requisitos
------------

[](#-requisitos)

- **PHP**: ^8.2
- **Laravel**: ^11.0 || ^12.0
- **Extensão MongoDB para PHP**: Obrigatória para funcionamento
- **Composer**: Para gerenciamento de dependências

🔧 Verificação e Instalação da Extensão MongoDB
----------------------------------------------

[](#-verificação-e-instalação-da-extensão-mongodb)

Antes de usar esta biblioteca, você **deve** ter a extensão MongoDB instalada no PHP.

### Verificar se a extensão está instalada

[](#verificar-se-a-extensão-está-instalada)

```
php -m | grep mongodb
```

Se não retornar nada, a extensão não está instalada.

### Instalação da Extensão MongoDB

[](#instalação-da-extensão-mongodb)

#### 🐧 Linux (Ubuntu/Debian)

[](#-linux-ubuntudebian)

```
# Instalar a extensão
sudo apt-get update
sudo apt-get install php-mongodb

# Ou via PECL
sudo pecl install mongodb

# Adicionar ao php.ini se necessário
echo "extension=mongodb" | sudo tee -a /etc/php/8.2/cli/php.ini
echo "extension=mongodb" | sudo tee -a /etc/php/8.2/fpm/php.ini

# Reiniciar serviços
sudo systemctl restart apache2  # ou nginx
sudo systemctl restart php8.2-fpm
```

#### 🍎 macOS

[](#-macos)

```
# Via Homebrew
brew install php@8.2
brew install mongodb/brew/mongodb-community

# Instalar extensão via PECL
pecl install mongodb

# Adicionar ao php.ini
echo "extension=mongodb" >> /usr/local/etc/php/8.2/php.ini

# Reiniciar serviços se necessário
brew services restart php@8.2
```

#### 🪟 Windows

[](#-windows)

1. Baixe a extensão MongoDB apropriada do [PECL](https://pecl.php.net/package/mongodb)
2. Extraia o arquivo `php_mongodb.dll` para a pasta `ext` do PHP
3. Adicione `extension=mongodb` ao arquivo `php.ini`
4. Reinicie o servidor web

📦 Instalação
------------

[](#-instalação)

### 1. Instalar via Composer

[](#1-instalar-via-composer)

```
composer require techapi/mongo-laravel
```

### 2. Configurar Conexão com MongoDB

[](#2-configurar-conexão-com-mongodb)

Adicione a configuração do MongoDB no arquivo `config/database.php`:

```
'connections' => [
    // ... outras conexões

    'mongodb' => [
        'driver'   => 'mongodb',
        'host'     => env('MONGO_HOST', 'localhost'),
        'port'     => env('MONGO_PORT', 27017),
        'username' => env('MONGO_USER', ''),
        'password' => env('MONGO_PASS', ''),
        'options'  => [
            'database' => env('MONGO_DB', 'laravel'),
            'authSource' => env('MONGO_AUTH_SOURCE', 'admin'), // Opcional
        ],
    ],
],
```

### 3. Configurar Variáveis de Ambiente

[](#3-configurar-variáveis-de-ambiente)

Adicione as seguintes variáveis ao seu arquivo `.env`:

```
MONGO_HOST=localhost
MONGO_PORT=27017
MONGO_USER=seu_usuario
MONGO_PASS=sua_senha
MONGO_DB=nome_do_banco
MONGO_AUTH_SOURCE=admin
```

### 4. Publicar Service Provider (Opcional)

[](#4-publicar-service-provider-opcional)

O package possui auto-discovery habilitado, mas se precisar registrar manualmente, adicione em `config/app.php`:

```
'providers' => [
    // ...
    Mongo\Providers\MongoServiceProvider::class,
],

'aliases' => [
    // ...
    'Mongo' => Mongo\Facades\Mongo::class,
],
```

🚀 Uso
-----

[](#-uso)

### Criando um Model

[](#criando-um-model)

Use o comando artisan para criar um novo model:

```
php artisan make:mongo-model User
```

Ou especificando o nome da collection:

```
php artisan make:mongo-model User --collection=usuarios
```

Isso criará um model em `app/Models/User.php`:

```