Nommage des fonctions get_loans_ dans db-functions.php
Les fonctions get_loans_* peuvent retourner :
- un objet ou plusieurs objects
- quelques attributs (minimum) ou tous les attributs
- un nombre d'élément
Le nom de la fonction après get_loans_ est de préférence un des mots clefs :
-
short/allsi le retour est un élément avec quelques attributs ou tous les attributs -
listshort/listallsi le retour est une liste d'élément (minimal ou complète) count
D'autres cas sont possibles, plus de subtilité serait aussi possible, mais on doit faire 99% des cas ainsi. Avec ce système, on arrive à comprendre assez facilement le code côté page utilisateur. Or l'important est d'avoir un code le plus facilement lisible par une personne tierce.
À noter que lorsqu'il n'y a pas de résultat, on retourne false. Ce n'est certainement pas la meilleure manière de gérer les erreurs, mais cela fonctionne relativement facilement dans de nombreux cas.