Frameworks
Utilisez une architecture MVC en PHP : Les frameworks
PHODoc
Il existe des conventions de documentation. En PHP, on commente dans le format PHPDoc. La PHPDoc est inspirée de la Javadoc, qui a été inventée pour le langage Java.À l'aide d'un programme spécial (PHPDoc), on peut générer automatiquement une documentation depuis votre code :
Commentaires PHPDoc
Ce type de documentation peut se révéler très utile pour les développeurs qui ont besoin de comprendre comment votre code source fonctionne dans les grandes lignes. Pour obtenir ce résultat, les variables et fonctions membres des objets sont précédés d'un commentaire qui suit une convention bien particulière :<?php
/**
* Executes a compiler pass.
*
* This method will execute the business logic associated with a given compiler pass and allow it to manipulate
* or consumer the Object Graph using the ProjectDescriptor object.
*
* @param ProjectDescriptor $project Representation of the Object Graph that can be manipulated.
*
* @return mixed
*/
public function execute(ProjectDescriptor $project) {
// ...
}
Hydratez !
L'hydratation consiste à transformer le contenu d'une base de données en objets et inversement. Les objets font alors la passerelle entre le reste de votre code et la base de données. Si on avait fait de "vrais" objets Comment par exemple, ils auraient sûrement eu cette forme :<?php
class Comment extends Model {
private $author;
private $content;
public getAuthor() // Récupère l'auteur {
// ...
}
public getContent() // Récupère le contenu {
// ...
}
public setAuthor($author) // Définit l'auteur {
// ...
}
public setContent($content) // Définit le contenu {
// ...
}
}
L'objet représente alors vraiment un commentaire. On peut le lire et le modifier grâce à ses fonctions membres. Avec un peu de travail, un tel objet peut directement récupérer et modifier les informations en base de données.
Bien entendu, ça demande du travail de faire ça à la main. En fait, si vous poussez le bouchon un peu loin, vous allez finir par créer ce qu'on appelle un ORM (Object-Relational Mapping). C'est un système qui sert à transformer le contenu de votre base de données en objets et vice-versa.
Par contre, bien le faire n'est pas simple du tout ! Ne vous y lancez que si vous êtes très motivés et que vous avez beaucoup de temps devant vous.
L'un des ORM les plus connus en PHP s'appelle Doctrine. Il est d'ailleurs directement livré avec le framework Symfony.
Utilisez un framework
Ce sera sûrement la prochaine étape pour vous. Les frameworks sont des super-bibliothèques qui contiennent tout le code qui vous permet d'éviter de réinventer la roue.Les frameworks vous imposent souvent une façon de coder bien précise (notamment du MVC, de la POO, etc.). Il faut du temps pour apprendre à les utiliser correctement, mais vous gagnerez ensuite beaucoup de temps et aurez un code très propre.
Il existe plusieurs frameworks PHP. Citons notamment :
- Zend Framework : le framework créé par la société qui a conçu PHP (Zend). Il a un peu moins le vent en poupe aujourd'hui même s'il reste connu.
- Symfony : un des frameworks les plus connus, développé par des Français. Il existe un cours sur Symony sur OpenClassrooms.
- Laravel : un autre framework PHP très connu.
Pour aller plus loin...