Un bloc logique est un ensemble de lignes partageant un sens commun.
Considérons le code suivant :
$fooService = new FooService();
$fooService->setThing();
$barService = new BarService();
Event::fire(new FiringManyThings());
$fooService->setOtherThing();
return View::make('index', compact($barService));
Ces quelques lignes forment un ensemble compact dont les intentions sont laborieuses à identifier.
N'oubliez jamais que vous écrivez du code à la fois pour vous mais également pour les autres, l'une des qualités premières d'un code sera toujours sa lisibilité.
Un code difficile à lire sera un obstacle supplémentaire à sa compréhension, apporter un soin particulier au style de son code est donc loin d'être anodin.
Le code est lu beaucoup plus souvent qu'il n'est écrit.
Il est facile d'améliorer la lisibilité de ce code en découpant ces lignes en plusieurs sous-ensembles partageant un sens commun :
- La création de classes
- L’appel des méthodes
- L’assignation des variables …
En ajoutant une simple distinction visuelle, telle qu’un saut de ligne, nous pouvons cloisonner ce code en plusieurs paragraphes.
$fooService = new FooService();
$barService = new BarService();
$fooService->setThing();
$fooService->setOtherThing();
Event::fire(new FiringManyThings());
return View::make('index', compact($barService));
Notre code gagne ainsi en lisibilité, la lecture en diagonale est facilitée et on appréhende désormais rapidement les différentes intentions.