Obtener relaciones de modelos automáticamente en Laravel

Siempre insistimos con usar la carga impaciente (Eager Loading) con el método with() ya que nos permite cargar los registros relacionados con nuestro modelo:

public function books()
{
   return $this->hasMany(Book::class);
}

$authors = Author::with('books')->get();

De esta forma obtenemos todos los autores con sus libros en una misma colección y con una consulta a la base de datos optimizada.

Pero en este tip vamos a ver que hay una forma automática de realizar lo mismo.

Cargar relaciones automáticamente

Hay situaciones en las que sabemos que cada vez que obtenemos un modelo, necesitamos su relación. Por este motivo, Laravel nos brinda una forma de automatizar la carga sin necesidad de utilizar el método with() todo el tiempo.

Así que, si necesitamos cargar los libros de los autores cada vez que obtenemos estos últimos, tenemos que sobrescribir la propiedad $with en el modelo Author con los nombres de las relaciones que necesitamos cargar automáticamente. Por ejemplo.

class Author extends Model
{

    protected $with = ['books'];

    public function books()
    {
        return $this->hasMany(Book::class);
    }

    // (...)

}

De esta forma, cada vez que obtengamos uno o mas autores, vendrán cargados sus libros (si es que los tiene). Así que, si hacemos lo siguiente:

$author = Author::first();
$books = $author->books;

Atención: Cuidado con la carga automática

No todo es color de rosas, hay que tener en cuenta que si establecemos la propiedad $with en el modelo, siempre, pero siempre, se cargaran las relaciones que establecimos en $with.

Te aconsejo que analices correctamente tu sistema para asegurarte que la mayoría de veces que utilizas el modelo también utilizaras sus relaciones.

La buena noticia es que, si en alguna parte del sistema no necesitas la carga automática, podes utilizar el método without() para no cargar la relación. Por ejemplo:

$relevantAuthors = Author::where('relevant', true)->withour('books')->get();

Bonus: Carga automática de cantidad de registros relacionados

No solo tenemos la propiedad $with, también Laravel nos permite sobrescribir la propiedad $withCount que nos permitirá obtener la cantidad de registros que tiene la relación. Por ejemplo:

class Author extends Model
{

    protected $with = ['books'];

    protected $withCount = ['books'];

    public function books()
    {
        return $this->hasMany(Book::class);
    }

    // (...)

}

$author = Author::first();
{{ $author->books_count }}

Para obtener la cantidad de registros de los modelos relacionados automáticamente, primero debemos establecer en el arreglo de $withCount, el nombre de la relación y luego hacer la carga automática (o la carga con el método with()) .

Por ultimo, para mostrar la cantidad de registros debemos armar la propiedad con el nombre de la relación (books en nuestro caso) y luego la palabra _count, como lo hicimos en el ejemplo anterior.

Pero ojo! $withCount, como $with, siempre se ejecutarán por más que no vayamos a utilizarlo.

Conclusión

Espero que les haya gustado este Laravel tip y utilízalo cuando sea necesario. Nos vemos en la próxima.

Mirá estos tips

39 tips que todo desarrollador debe tener en cuenta

Optimiza la recorrida de un arreglo con este tip

Laravel Tip: Optimiza el método find() de Eloquent de esta forma!