This course is still being released! Check back later for more chapters.

Get Notified About this Course!

We will send you messages regarding this course only
and nothing else, we promise.
You can unsubscribe anytime by emailing us at:
privacy@symfonycasts.com
> Doctrine > Herencia en Doctrine: Clases en la base de datos
Login to bookmark this video
Buy Access to Course
05.

Consulta de clases

|

Share this awesome video!

|

Keep on Learning!

Start your All-Access Pass

With a Subscription, click any sentence in the script to jump to that part of the video!

Login Subscribe

Veamos cómo podemos consultar tipos específicos de naves. Aquí vemos una lista de todas las naves estelares. Pero, ¿y si sólo queremos mostrar exploradoras, o cargueros, o cargueros mineros? ¡Hay DQL para eso!

En primer lugar, vamos a distinguir visualmente los distintos tipos de naves, para que sepamos cuáles son exploradoras, cargueros, etc.

Recuerda que no podemos acceder directamente a la columna discriminador para obtener este valor. Ahora mismo, nuestra única opción es comprobar la instancia de la nave devuelta porfindAll y ver si es un carguero, un explorador, etc. Esto es fácil de hacer en PHP, pero en Twig, no tanto...

Me gustaría poder llamar a $starship->getType() y que devolviera el valor del discriminador. ¡Aquí tienes un truco! Abre nuestra entidad nave estelar, y en el atributo DiscriminatorMap, corta la matriz del mapa. En la clase, añade private const TYPE_MAP =... pega, no olvides el punto y coma. En el atributo, pon como argumento self::TYPE_MAP:

124 lines | src/Entity/Starship.php
// ... lines 1 - 10
#[ORM\DiscriminatorMap(self::TYPE_MAP)]
abstract class Starship
{
private const TYPE_MAP = [
'scout' => Scout::class,
'freighter' => Freighter::class,
'mining_freighter' => MiningFreighter::class,
];
// ... lines 19 - 122
}

Ahora, abajo, añade un nuevo método, final public function getType(), éste devolverá una cadena. Aquí utilizamos final para evitar que cualquier subclase modifique la lógica.

Nuestro TYPE_MAP tiene como clave los valores discriminantes que queremos devolver, y los valores son los nombres de las clases. Para obtener el valor del discriminador del objeto nave actual, podemos dar la vuelta a la matriz TYPE_MAP, de modo que los nombres de las clases sean las claves. Abajo en getType, return array_flip(self::class)[static::class]. Como recordatorio, self::class siempre devuelve la clase en la que está escrito el código, por lo que devolvería Starship::class para todas las naves. static::class devuelve la clase del objeto real, por lo que devolvería Scout::class para un explorador, Freighter::class para un carguero, etc. Por lo tanto, aquí es importante utilizar static::class para la clave:

124 lines | src/Entity/Starship.php
// ... lines 1 - 11
abstract class Starship
{
// ... lines 14 - 118
final public function getType(): string
{
return array_flip(self::TYPE_MAP)[static::class];
}
}

Actualizar la interfaz de usuario

Con nuestro método getType() listo, actualizaremos la plantilla Twig para mostrarlo. Abre templates/main/homepage.html.twig. Antes del nombre de la nave, añadiré algún espacio, y añade {{ ship.type }}:

55 lines | templates/main/homepage.html.twig
// ... lines 1 - 4
{% block body %}
<main class="flex flex-col lg:flex-row">
// ... lines 7 - 8
<div class="px-12 pt-10 w-full">
// ... lines 10 - 13
<div class="space-y-5">
{% for ship in ships %}
<div class="bg-[#16202A] rounded-2xl pl-5 py-5 pr-11 flex flex-col min-[1174px]:flex-row min-[1174px]:justify-between">
<div class="flex justify-center min-[1174px]:justify-start">
// ... line 18
<div class="ml-5">
// ... lines 20 - 23
<h4 class="text-[22px] pt-1 font-semibold">
<a
class="hover:text-slate-200"
href="#"
>
{{ ship.type }}
{{ ship.name }}
</a>
</h4>
// ... lines 33 - 35
</div>
</div>
// ... lines 38 - 48
</div>
{% endfor %}
</div>
</div>
</main>
{% endblock %}

En nuestro navegador, actualiza y ¡listo! Podemos ver el nombre de la nave precedido del tipo. Aunque podría quedar más bonito...

Un truco: aunque tu sitio no sea multilingüe, puedes utilizar el componente de traducción. Utiliza estas cadenas de tipo como claves para tu idioma por defecto y personalízalas en tus archivos de traducción.

Para simplificar las cosas, me limitaré a pasarlas por algunos filtros de cadena para hacerlas más bonitas. De vuelta a la plantilla, añade |replace({'_': ' '})|title:

55 lines | templates/main/homepage.html.twig
// ... lines 1 - 4
{% block body %}
<main class="flex flex-col lg:flex-row">
// ... lines 7 - 8
<div class="px-12 pt-10 w-full">
// ... lines 10 - 13
<div class="space-y-5">
{% for ship in ships %}
<div class="bg-[#16202A] rounded-2xl pl-5 py-5 pr-11 flex flex-col min-[1174px]:flex-row min-[1174px]:justify-between">
<div class="flex justify-center min-[1174px]:justify-start">
// ... line 18
<div class="ml-5">
// ... lines 20 - 23
<h4 class="text-[22px] pt-1 font-semibold">
<a
class="hover:text-slate-200"
href="#"
>
{{ ship.type|replace({'_': ' '})|title }}
{{ ship.name }}
</a>
</h4>
// ... lines 33 - 35
</div>
</div>
// ... lines 38 - 48
</div>
{% endfor %}
</div>
</div>
</main>
{% endblock %}

Esto sustituye los guiones bajos por espacios y pone en mayúsculas la primera letra de cada palabra.

Actualiza el navegador y... ¡mucho mejor!

Filtrar las Naves

Ahora, pasemos al filtrado propiamente dicho. Abre el StarshipRepository y añade un nuevo métodopublic function filterShips(), tipo de retorno: array. Encima, añade un docblock para especificar que devuelve una matriz de Starship's:

57 lines | src/Repository/StarshipRepository.php
// ... lines 1 - 12
class StarshipRepository extends ServiceEntityRepository
{
// ... lines 15 - 19
/**
* @return Starship[]
*/
public function filterShips(): array
// ... lines 24 - 55
}

Dentro, return $this->createQueryBuilder(), alias s. Añade ->where('s INSTANCE OF '.Scout::class). Este INSTANCE OF es un operador DQL especial que comprueba si la entidad es una instancia de la clase especificada o de cualquier subclase. ¡Igual que el operador instanceof de PHP! Así que esto devolverá todos los exploradores y cualquier subclase de explorador (si tuviéramos alguna).

Termina con ->getQuery()->execute():

57 lines | src/Repository/StarshipRepository.php
// ... lines 1 - 12
class StarshipRepository extends ServiceEntityRepository
{
// ... lines 15 - 22
public function filterShips(): array
{
return $this->createQueryBuilder('s')
->where('s INSTANCE OF '.Scout::class)
->getQuery()
->execute()
;
}
// ... lines 31 - 55
}

En MainController::homepage(), pasa de utilizar findAll() a filterShips():

26 lines | src/Controller/MainController.php
// ... lines 1 - 10
class MainController extends AbstractController
{
// ... line 13
public function homepage(
// ... line 15
): Response {
$ships = $starshipRepository->filterShips();
// ... lines 18 - 23
}
}

Actualiza la página de inicio y... Bien, ¡acabamos de ver a los exploradores!

Uso de parámetros

Al construir consultas, para evitar la inyección SQL, utilizamos parámetros en lugar de codificar valores en la cláusula where. Así que vamos a hacerlo.

Cambia la cláusula where por s INSTANCE OF :class, y debajo, añade ->setParameter('class', Scout::class):

58 lines | src/Repository/StarshipRepository.php
// ... lines 1 - 12
class StarshipRepository extends ServiceEntityRepository
{
// ... lines 15 - 22
public function filterShips(): array
// ... line 24
return $this->createQueryBuilder('s')
->where('s INSTANCE OF :class')
->setParameter('class', Scout::class)
->getQuery()
->execute()
;
}
// ... lines 32 - 56
}

Actualiza la página y... un error. "array_rand no puede estar vacío". Hmm, ok esto viene de nuestro MainController. Estamos utilizando array_rand para obtener una nave aleatoria, y está fallando porque el array $ships está vacío.

Es una putada, pero no podemos utilizar el nombre de la clase directamente como parámetro. Sin embargo, ¡hay una solución!

Volviendo a StarshipRepository, en setParameter(), para el segundo argumento, utiliza$this->getEntityManager()->getClassMetadata(Scout::class).

58 lines | src/Repository/StarshipRepository.php
// ... lines 1 - 12
class StarshipRepository extends ServiceEntityRepository
{
// ... lines 15 - 22
public function filterShips(): array
// ... line 24
return $this->createQueryBuilder('s')
// ... line 26
->setParameter('class', $this->getEntityManager()->getClassMetadata(Scout::class))
// ... lines 28 - 29
;
}
// ... lines 32 - 56
}

Esto devuelve un objeto de metadatos especial para la clase Explorador y es lo que Doctrine necesita para manejar correctamente el operador INSTANCE OFcon parámetros.

Actualiza el navegador... y bien, ¡sólo los exploradores otra vez!

NO INSTANCIA DE

Prueba a cambiar la clase a Freighter::class y actualiza la página de inicio.

59 lines | src/Repository/StarshipRepository.php
// ... lines 1 - 13
class StarshipRepository extends ServiceEntityRepository
{
// ... lines 16 - 23
public function filterShips(): array
{
return $this->createQueryBuilder('s')
// ... line 27
->setParameter('class', $this->getEntityManager()->getClassMetadata(Freighter::class))
// ... lines 29 - 30
;
}
// ... lines 33 - 57
}

Ahora vemos los cargueros, pero también los cargueros mineros. Esto se debe a que en PHP, instancia de devuelve verdadero para la clase que estás viendo y cualquier subclase.

Para mostrar sólo los cargueros normales, necesitamos otra cláusula where. En nuestro método filterShips(), añade ->andWhere('s NOT INSTANCE OF :notclass'). A continuación, duplica la línea setParameter y cambia class por notclass y Freighter::class por MiningFreighter::class:

62 lines | src/Repository/StarshipRepository.php
// ... lines 1 - 14
class StarshipRepository extends ServiceEntityRepository
{
// ... lines 17 - 24
public function filterShips(): array
{
return $this->createQueryBuilder('s')
// ... line 28
->andWhere('s NOT INSTANCE OF :notclass')
// ... line 30
->setParameter('notclass', $this->getEntityManager()->getClassMetadata(MiningFreighter::class))
// ... lines 32 - 33
;
}
// ... lines 36 - 60
}

Actualiza la página de inicio y... ¡ya está, sólo los cargueros normales!

Desgraciadamente, si el carguero tuviera 10 subclases, tendríamos que añadir 10 NOT INSTANCE OF's - una para cada subclase. No creo que haya una forma más elegante de conseguirlo, pero ¡házmelo saber en los comentarios si conoces alguna!

Antes de continuar, vuelve a MainController y cambia defilterShips a findAll y confirma que lo tenemos todo de nuevo:

26 lines | src/Controller/MainController.php
// ... lines 1 - 10
class MainController extends AbstractController
{
// ... line 13
public function homepage(
// ... line 15
): Response {
$ships = $starshipRepository->findAll();
// ... lines 18 - 23
}
}

A continuación, veremos cómo podemos mostrar las propiedades específicas de cada tipo de nave en la plantilla Twig.