Création des classes objet PHP de votre projet Web

En programmation, un objet est un conteneur qui comporte des propriétés et des méthodes – qui sont en fait des variables et des actions ne concernant que ce qu'il représente.

En programmation objet, une partie de vos classes PHP vont correspondre aux tables de la base de données créés pour recevoir et stocker les informations.

Chaque objet en relation avec la base de données devra avoir les fonctionnalités suivantes :

Initialisation depuis la base de données par passage de paramètres (_construct)
Initialisation depuis les variables _POST "Select"
Une fonction de mise à jour en BDD « Update »
Une fonction d'enregistrement en BDD « Insert »
Une fonction de suppression d'un enregistrement en BDD "Delete"
Une fonction de listing des enregistrements de la table "SelectAll"

Attention à ce que chaque fonction/methode dans vos classes ne réalisent qu'une seule fonctionnalité et pas une liste de fonctions que l'on pourrait séparer en sous fonctions

Définition d'une classe en PHP

Une définition de classe basique commence par le mot-clé class, suivi du nom de la classe. Suit une paire d'accolades contenant la définition des propriétés et des méthodes appartenant à la classe (les fonctions).

Pour tout savoir sur les classes en PHP suivre le lien suivant :
https://www.php.net/manual/fr/language.oop5.basic.php

Exemple d'écriture de la définition d'une class PHP

            
 
        <?php
        //Les commentaires sont entre doubles slashes
        class Article //nom de la classe
        {
        // déclaration d'une propriété
           public $titre = 'une valeur par défaut ou rien';
           public $texte ;//On déclare une propriété sans valeur pour le moment ;

        // déclaration des méthodes (fonction)
        public function displayTitre() {
             //on ajoute le code PHP qui va réaliser notre traitement d'information.
             echo $this->titre;
            }
        }
        ?>

Rôle du $this->

Le $this-> permet d'acceder à la valeur d'une propriété dans une classe.
Dans une methode de classe, pour attribuer ou lire une valeur d'une propriété on utilise :

 $this->maPropriete;

Déclarer / Instancier un objet

    
$MonObjet = new $MaClass();
ou
$MonObjet = new $MaClass; //Les parenthèses ne sont pas obligatoires si il n'y a pas de paramètres.

Récupérer la valeur d'un attribut de classe

$MaClass->maVariable;

Appeller une methode de classe

$MaClass->maMethode(); //Execute la fonction située dans l'objet

Pour tout connaître sur la syntaxe de base des objets PHP
https://www.php.net/manual/fr/language.oop5.basic.php

Convention de nommage en PHP

Cet article portera sur les conventions de nommage pour PHP. C'est à dire comment créer des noms de variables, de fonctions et classes en PHP
Ces directives sont spécifiques à PHP telles que définies par Zend et à utiliser avec le Zend Framework.
Bien que ces conventions soient spécifiques à un langage, elles ne sont que des lignes directrices (rien d'obligatoire mais juste une bonne pratique).
Cependant, si vous choisissez de les adopter, la chose la plus importante est que toute votre équipe fasse la même chose.

La chose la plus importantes à se rappeler quand vous créez votre code est d'utiliser seulement des noms de bon sens. En utilisant des noms explicites dans votre code, ce sera plus facile pour vous et d'autres programmeurs de comprendre votre code et ce à quoi il sert. Il faut donc totalement oublier les noms de varibles de type $a, $b, $i...
Si votre variable doit contenir le titre d'un article alors il faudrait la nommer $titreArticle.
Si votre fonction doit récupérer les informations d'un article depuis un formulaire html à l'aide de la methode POST (validation de formulaire html) alors vous pourrez nommer votre fonction getArticleFromPost().

Les conventions de nommage sont un ensemble de «lignes directrices» définissant le cas à utiliser pour nommer les éléments de votre code. Ceci est fait pour garder votre code uniforme, ce qui le rend plus facile à suivre et à comprendre. Les deux cas utilisés le plus souvent sont le Pascal Case et le Camel Case.

Les conventions de nommage les plus utilisées :

Pascal case -> NomEnPascalCase (aussi appelée Upper Camel Case)
Pascal case c'est quand la première lettre de chaque mot commence par une majuscule sans espaces entre les mots.
Camel Case -> nomEnCamelCase (aussi appelé Lower Camel Case)
Camel cas c'est la même chose, sauf que la première lettre du mot commence par une lettre minuscule.

Guide de nommage en PHP

Classe : MaClasse (Upper Camel Case) //Le nom de la classe doit indiquer l'objet créé (User, Article...)
Fichier (script tout bête sans classe dedans) : mon_script.php
Fichier de classe : MaClasse.class.php (Upper Camel Case)
Fonction publique : maFonction() (camel Case) //Le nom doit décrire le comportement de la fonction ou de la méthode
Fonction privée|protégée : _autreFonction() (camel Case) //Le nom doit décrire le comportement de la fonction ou de la méthode. Les méthodes qui sont déclarées en privé ou protégé doivent commencer par un _.
variable publique : $maVariable, $monArray, $maString, $monEntier (camel Case) Les noms doivent décrire les données dans la variable.
variable privée|protégée : $_maVariable (camel Case) Les noms doivent décrire les données dans la variable. Les variables déclarées en privé ou protégé doivent commencer par un _.
constante : NOM_DE_CONSTANTE (ALL_CAPS -> tout en majuscule). Il faut utiliser le signe '_' pour séparer les mots dans des constantes

Avec cette façon d'écrire votre code, vous avez déjà l'assurance d'aller beaucoup plus vite et d'éviter un maximum de bug.
Quand on écrit du code, on ne fait que lire et relire ce que l'on a écrit pour compléter les fonctionnalités du système.
Et dans quelques jours, semaines, mois ou années vous devrez être capable de lire et comprendre votre code aussi vite que la lecture d'une page d'un livre. Cette façon d'écrire permet surtout de comprendre toute de suite si un "$nom" correspond à une variable, classe, fonction... Ce qui accélère la lecture et la compréhension du code.