En esta ocasión aprenderemos de forma rápida y sencilla como configurar básicamente MongoDB en Symfony 4.
Este post asume que ya posees instalada la extensión de MongoDB ( ext-mongodb) para PHP en tu servidor web.
Para conocer un poco más sobre esto, lee previamente los siguientes enlaces:
Para comenzar dividiré el post en tres secciones:
Instalar MongoDB en macOS y otras plataformas.
Instalar Symfony 4 y paquetes necesarios.
Configurar MongoDB en Symfony 4.
Lo primero que debemos hacer es instalar nuestro servidor de MongoDB, para ello vamos a ver como instalarlo en macOS y otras plataformas.
Pasos para instalar en macOS usando homebrew:
Procesamos a instalar el servidor de MongoDB en macOS.
En mi post anterior, explicó como instalar este poderoso gestor de paquetes llamado homebrew, sin aún no lo tienes, échale un vistazo antes a mi post para conocer como instalarlo.
Abrimos nuestro terminal y ejecutamos:
brew update
Al terminar, ejecutamos:
brew install mongodb
Lo siguiente será generar la ruta donde se almacenarán nuestros schemas:
sudo mkdir -p /data/db
y finalmente podemos ejecutar nuestro servidor de MongoDB:
sudo mongod
Pasos para instalar en Linux:
Click para ver documentación online.
Pasos para instalar en Windows:
Click para ver documentación online.
Instalar Symfony 4 y paquetes necesarios.
Una vez instalado el servidor de MongoDB, procederemos a crear nuestro proyecto en Symfony 4 e instalar los paquetes necesarios para integrar MongoDB en nuestra instalación.
Creamos un proyecto nuevo en Symfony 4:
composer create-project symfony/skeleton sf4-mongodb
Entramos en nuestro proyecto:
cd sf4-mongodb
Instalamos el Adaptador PHP para utilizar la extensión MongoDB en nuestra aplicación:
composer config "platform.ext-mongo" "1.6.16" && composer require alcaeus/mongo-php-adapter
Instalamos el bundle de MongoDB:
composer config extra.symfony.allow-contrib true
composer require doctrine/mongodb-odm-bundle
Instalamos los “ validators” de Symfony:
composer req validation
Instalamos el componente “ Security” de Symfony:
composer req security
Configurar MongoDB en Symfony 4.
Hasta aquí tenemos todo lo necesario, solo nos falta unos pocos pasos para configurar nuestro proyecto y poder conectarnos a nuestro servidor de MongoDB.
Lo siguiente es editar nuestro archivo .env y establecer nuestra url por defecto al servidor de MongoDB, la cual podemos dejar tal como viene pre-configurado, y el nombre de nuestro schema (Base de datos) que estaremos utilizando en el proyecto. Nuestros parámetros a configurar son los siguientes:
MONGODB_URL=mongodb://localhost:27017
MONGODB_DB=sf4-mongodb
Ahora, crearemos nuestro primer documento ( que en MongoDB es el término utilizado para referirse a una tabla en modelos relacionales).
Crearemos el archivo User.php en el directorio “ src/Document “
<?php
namespace App\Document;
use Doctrine\ODM\MongoDB\Mapping\Annotations as MongoDB;
use Symfony\Bridge\Doctrine\Validator\Constraints\UniqueEntity;
use Symfony\Component\Validator\Constraints as Assert;
use Symfony\Component\Security\Core\User\AdvancedUserInterface;
class User implements AdvancedUserInterface
{
const ROLE_DEFAULT = 'ROLE_USER';
const ROLE_SUPER_ADMIN = 'ROLE_SUPER_ADMIN';
protected $id;
protected $name;
protected $username;
protected $email;
protected $enabled;
protected $password;
protected $roles;
public function __construct()
{
$this->enabled = true;
$this->roles = array();
}
public function addRole($role)
{
$role = strtoupper($role);
if ($role === static::ROLE_DEFAULT) {
return $this;
}
if (!in_array($role, $this->roles, true)) {
$this->roles[] = $role;
}
return $this;
}
public function getId()
{
return $this->id;
}
public function getName()
{
return $this->name;
}
public function getUsername()
{
return $this->username;
}
public function getPassword()
{
return $this->password;
}
public function isEnabled()
{
return $this->enabled;
}
public function getRoles()
{
$roles = $this->roles;
$roles[] = static::ROLE_DEFAULT;
return array_unique($roles);
}
public function hasRole($role)
{
return in_array(strtoupper($role), $this->getRoles(), true);
}
public function removeRole($role)
{
if (false !== $key = array_search(strtoupper($role), $this->roles, true)) {
unset($this->roles[$key]);
$this->roles = array_values($this->roles);
}
return $this;
}
public function setName($name): self
{
$this->name = $name;
return $this;
}
public function setUsername($username): self
{
$this->username = $username;
return $this;
}
public function setEmail($email): self
{
$this->email = $email;
return $this;
}
public function setPassword($password): self
{
$this->password = $password;
return $this;
}
public function setEnabled($enabled): self
{
$this->enabled = (bool) $enabled;
return $this;
}
public function setRoles(array $roles): self
{
$this->roles = array();
foreach ($roles as $role) {
$this->addRole($role);
}
return $this;
}
public function getSalt()
{
return '';
}
public function eraseCredentials()
{
}
public function isAccountNonExpired()
{
return true;
}
public function isAccountNonLocked()
{
return true;
}
public function isCredentialsNonExpired()
{
return true;
}
public function isSuperAdmin()
{
return $this->hasRole('ROLE_SUPER_ADMIN');
}
public function setSuperAdmin($boolean)
{
if (true === $boolean) {
$this->addRole('ROLE_SUPER_ADMIN');
} else {
$this->removeRole('ROLE_SUPER_ADMIN');
}
return $this;
}
public function serialize()
{
return serialize(array(
$this->password,
$this->username,
$this->enabled,
$this->id,
$this->email,
$this->name,
));
}
public function unserialize($serialized)
{
$data = unserialize($serialized);
list(
$this->password,
$this->username,
$this->enabled,
$this->id,
$this->email,
$this->name,
) = $data;
}
public function __toString()
{
return (string) $this->getUsername();
}
}
Y ya podemos proceder a volcar nuestro documento “ User” en nuestro servidor de MongoDB, para esto ejecutamos:
php bin/console doctrine:mongodb:schema:create
Y de esta manera, ya tenemos todo lo necesario para empezar a trabajar con MongoDB en Symfony 4. Para visualizar nuestro schema en el servidor de MongoDB, podemos instalar un IDE que nos permita conectarnos al servidor y poder ver y administrar nuestros schemas. Yo utilizo uno gratuito llamado Robo 3T el cual es para macOS y una vez instado solo basta con abrirlo y añadir un nuevo servidor en donde debemos colocar: localhost:27017 y listo.
Vale la pena destacar, que por defecto nuestro servidor MongoDB no viene con seguridad establecida, por lo que no requeriremos de un usuario y clave para conectarnos. Es aconsejable que posteriormente lo hagamos para proteger nuestro proyecto obviamente.
Si te gustó este post, ayúdame a que pueda servirle a muchas más personas, compartiendo mis contenidos en tus redes sociales.
Espero que este post haya sido de gran ayuda para ti, y como siempre, cualquier inquietud o duda que tengas, puedes contactarme por cualquiera de las vías disponibles, o dejando tus comentarios al final de este post. También puedes sugerir que temas o post te gustaría leer a futuro.
