Archives de
Mois : décembre 2020

Clean Code

Clean Code

Notes de lectures

Clean Code, le titre d’un livre écrit par Robert C. Martin, uncle Bob, est une véritable Bible pour certain. Voici quelques éléments qui j’ai retenus.

Nommage

  • Utiliser des noms clair, sans ambiguïté
  • Utiliser le même pour pour un concept unique

Fonctions

  • Garder les fonctions courtes, 20 lignes
  • Peu d’imbrications
  • Une fonction ne fait qu’une chose
  • Éviter d’avoir trop d’arguments

Commentaires

Mieux vaut changer son code pour le rendre claire que d’avoir un commentaire. Le code peux changer, le commentaire non.

<?php

// vérifie si l’employé peux avoir la retraite a taux plein
if($emplyee->flags &amp;&amp; $employee->age > 65)

Ou plutot

<?php

if(($employee->peutAvoirLaRetraiteATauxPlein())

Formatage

Le plus important est d’avoir un formatage commun afin que le code sois visuellement cohérent et d’évité d’avoir des changement dans la gestions des sources.

Objets

Erreur

Utiliser des exceptions plutôt que des code de retour pour simplifier la gestion des erreurs. Ne pas utiliser null pour les même raisons.

Classe

Comme les fonctions:

  • Garder les fonctions courtes, 100 lignes
  • Peu d’imbrications
  • Une classe ne fait qu’une chose

Emergent Design

Afin de produire du code propre nous pouvons suivre ces 4 règles:

  • Passer tout les test
  • Refactoriser, Dedupliquer
  • Être expressive
  • Ne pas avoir trop de classes et de fonctions