Récupérer des enregistrements par champ

Comment procéder à la récupération des enregistrements par champ ?

Chaque collector peut appeler la méthode magique getBy ou getOneBy ou getKvBy qui permet de récupérer des données filtrées par champ.

Les paramètres

1. La valeur recherchée.

Exemple

L'exemple suivant permet de récupérer les valeurs du collector "example" si le champ "is_valid" est égal à 1.

$result = $this->collector['example']->getByIs_valid('1');

Retour de la fonction

Cette méthode retourne un tableau contenant les valeurs.

Array
(
    [0] = Array
        (
            [id_example] = 1
            [lib] = Item 1
            [created_at] = 2019-05-03 14:33:10
            [n_order] = 1
            [is_valid] = 1
            [ex_type] = EX1
        )

    [1] = Array
        (
            [id_example] = 3
            [lib] = Item 3
            [created_at] = 2019-05-03 14:33:21
            [n_order] = 3
            [is_valid] = 1
            [ex_type] = EX2
        )

)

Méthode getOneBy

La méthode getOneBy fonctionne de façon identique, à la seule différence que le résultat ne retourne qu'un seul enregistrement.

$result = $this->collector['example']->getOneByLib('Item 3');

Méthode getKvBy

La méthode getKvBy fonctionne de façon identique, à la seule différence que le résultat retourne les clés et valeurs (cf. méthode getKv()).

$result = $this->collector['example']->getKvByLib('Item 3'));
Array ( [3] => Item 3 )