Meilleures pratiques de programmation

Référence en anglais : 17 Janvier 2009 - 00h33 - http://drupal.org/node/287350


Cette page expose brièvement nos meilleures pratiques pour programmer avec Drupal. Cela concerne autant des questions de haut niveau que celles abordées dans les pages Normes de programmation et Configuration & Usage Best Practices.

Le but de ces pages n'est pas de vous apprendre à programmer mais de de vous apprendre à devenir un meilleur programmeur dans le framework Drupal.

Tout le monde peut écrire du code, mais peu savent qu'il y a une façon de faire avec Drupal. Pourquoi la vitesse et les performances sont-elles si importantes ? Pourquoi documenter le code-source ? Pourquoi ce bout de code si utilisé est-il mauvais ? Nous répondons ici à ces questions, et à plein d'autres encore, et nous expliquons pourquoi.

Plan proposé

  • Écrire du code efficace
    • Utiliser des fonctions récursives
    • Construire un code rapide
    • Évitez les connexions inutiles Avoiding unnecessary coupling
  • Écrire du code qui se documente lui-même
  • Le besoin d'une documentation
  • Nommez vos fonctions
    • Utilisation de fonction privées
  • Utilisation de variables globales
  • Rendre votre module extensible
    • Écrire des fonctions hook et des fonctions de thèmes
    • Quand devrez-vous créer une API pour votre module et comment le faire
  • Code orienté objet versus code procédural et où Drupal marche avec.
  • Liens vers de la documentation utile sur une meilleure programmation en PHP, tel que : http://www.odi.ch/prog/design/php/guide.php
  • Considérations propres aux base de données
    • par exemple, comment enregistrer les données sans gaspillage, utilisation de la table system, la table watchdog, etc.
  • Écueils à éviter
    • Écrire du code déjà existant
    • Sur-utilisation de if-else, swith-case et try-catch
    • La dualité de l'opérateur ternaire