En este post te voy a mostrar cómo hacer una unión de tablas o inner join usando Laravel y sus modelos, a través del método join, select, get y posiblemente where.

¿Modelo o tabla?

Verás que en los ejemplos utilizo Modelo::join, pero si no tienes un modelo ligado a una tabla, puedes usar el método DB::table para obtener una referencia a la tabla. Es decir, lo siguiente:

Alumno::join(...)

Podría ser lo mismo que:

DB::table("alumnos")->join(...)

Sintaxis para inner join

La sintaxis es como se ve a continuación:

<?php
$resultado = Modelo::join("tabla_externa","tabla_externa.clave_foranea", "=", "modelo.clave")
->select("columna1", "columna2", ...)
->get();

Veamos los ejemplos para entenderlo de mejor manera.

Simple inner join en Laravel

Veamos cómo unir dos simples tablas. Yo tengo una tabla de asistencia (que tiene una clave foránea) y una tabla de alumnos. Es decir, llevo el registro de la asistencia de un alumno. La estructura es la siguiente:

MariaDB [sistema_escolar_2]> describe asistencia; describe alumnos;
+-------------------------+---------------------+------+-----+---------+----------------+
| Field                   | Type                | Null | Key | Default | Extra          |
+-------------------------+---------------------+------+-----+---------+----------------+
| id                      | bigint(20) unsigned | NO   | PRI | NULL    | auto_increment |
| id_alumno               | bigint(20) unsigned | NO   | MUL | NULL    |                |
| estado                  | enum('a','r','f')   | NO   |     | NULL    |                |
| id_registros_asistencia | bigint(20) unsigned | NO   | MUL | NULL    |                |
+-------------------------+---------------------+------+-----+---------+----------------+
4 rows in set (0.00 sec)

+------------------+---------------------+------+-----+---------+----------------+
| Field            | Type                | Null | Key | Default | Extra          |
+------------------+---------------------+------+-----+---------+----------------+
| id               | bigint(20) unsigned | NO   | PRI | NULL    | auto_increment |
| nombre           | varchar(191)        | NO   |     | NULL    |                |
| apellido_paterno | varchar(191)        | NO   |     | NULL    |                |
| apellido_materno | varchar(191)        | NO   |     | NULL    |                |
| calle            | varchar(191)        | NO   |     | NULL    |                |
| numero           | varchar(191)        | NO   |     | NULL    |                |
| localidad        | varchar(191)        | NO   |     | NULL    |                |
| cp               | varchar(191)        | NO   |     | NULL    |                |
| created_at       | timestamp           | YES  |     | NULL    |                |
| updated_at       | timestamp           | YES  |     | NULL    |                |
+------------------+---------------------+------+-----+---------+----------------+
10 rows in set (0.00 sec)

MariaDB [sistema_escolar_2]>

Para unir ambas tablas tengo mi modelo Alumno y hago lo siguiente:

<?php
$resultado = Alumno::join("asistencia", "asistencia.id_alumno", "=", "alumnos.id")
->select("*")
->get();

En este caso estaría usando id_alumno para el join en la tabla externa usando Laravel. El método select especifica las columnas.

Con esto, tenemos la siguiente salida:

[
  {
    "id": 45,
    "nombre": "Django",
    "apellido_paterno": "Freeman",
    "apellido_materno": "Gun",
    "calle": "12",
    "numero": "12",
    "localidad": "12",
    "cp": "12",
    "created_at": "2020-01-17 05:54:34",
    "updated_at": "2020-01-20 20:30:43",
    "id_alumno": 13,
    "estado": "a",
    "id_registros_asistencia": 24
  }
]

La estoy mostrando en JSON solo para depurar, pero puedes mostrarla en una vista. Como ves, están presentes datos de ambas tablas.

Join con algunas columnas

Podemos modificar la consulta anterior para solo seleccionar algunas columnas. Por ejemplo, el nombre del alumno y el estado de la asistencia:

<?php
$resultado = Alumno::join("asistencia", "asistencia.id_alumno", "=", "alumnos.id")
->select("alumnos.nombre", "asistencia.estado")
->get();

Teniendo la siguiente salida:

[
  {
    "nombre": "Django",
    "estado": "a"
  }
]

En caso de querer todos los campos de una tabla puedes usar tabla.*, por ejemplo, si solo quieres todos los campos de la tabla alumnos entonces sería alumnos.*.

Join con Where

A veces al unir tablas con join en Laravel es necesario aplicar cierta condición a la tabla para filtrarla. Para esto podemos usar el método where. Veamos un ejemplo:

<?php
$busqueda = "Luis";
$resultado = Alumno::join("asistencia", "asistencia.id_alumno", "=", "alumnos.id")
->select("alumnos.nombre", "asistencia.estado")
->where("alumnos.nombre", "=", $busqueda)
->get();

Con esto podríamos hacer una consulta en donde el nombre del alumno sea “Luis”.

Un último ejemplo

Finalmente quiero dejar un ejemplo de inner join, que igualmente une dos tablas pero una de ellas es una tabla pivote. La consulta queda así:

<?php
$idCurso = $request->get("idCurso");
$alumnos = Alumno
::join("alumno_curso", "alumno_curso.id_alumno", "=", "alumnos.id")
->where("alumno_curso.id_curso", "=", $idCurso)
->select("alumnos.*", "alumno_curso.*")
->get();

Pero si yo quisiera hacer un inner join de Laravel con las 3 tablas sería algo así:

<?php
$alumnos = Alumno
::join("alumno_curso", "alumno_curso.id_alumno", "=", "alumnos.id")
->join("cursos", "cursos.id", "=", "alumno_curso.id_curso")
->where("alumno_curso.id_curso", "=", $idCurso)
->select("*")
->get();

Con eso estaría uniendo la tabla cursos, alumno_curso y alumnos.

Conclusión

Te dejo un enlace interesante a la documentación oficial, y otro enlace para que veas mis posts sobre Laravel.