Skip to content

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 / all si le retour est un élément avec quelques attributs ou tous les attributs
  • listshort / listall si 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.