PHP functions : comment créer des blocs de code réu­ti­li­sables ?

Lorsque vous utilisez une fonction PHP, vous pouvez appeler plusieurs fois un même bloc de code au lieu de copier chaque fois ce dernier. Ainsi, vous gagnerez du temps et serez moins sus­cep­tible d’y in­tro­duire des erreurs.

PHP functions : de quoi s’agit-il ?

Les fonctions PHP sont des blocs de code désignés qui exécutent une ins­truc­tion spé­ci­fique, ou encore une série d’ins­truc­tions. Elles jouent un rôle fon­da­men­tal dans la pro­gram­ma­tion struc­tu­rée et vous per­met­tent de diviser votre code PHP en unités qui sont non seulement plus petites, mais également réu­ti­li­sables. PHP propose de nom­breuses fonctions pré­dé­fi­nies pour des tâches courantes, par exemple le travail avec des chaînes, des tableaux ou encore des boucles PHP. Vous pouvez aussi per­son­na­li­ser vos propres fonctions si vous souhaitez im­plé­men­ter des processus spé­ci­fiques dans vos ap­pli­ca­tions.

Quelle est la dif­fé­rence entre les PHP functions internes et per­son­na­li­sées ?

Les fonctions internes sont déjà intégrées aux langages de pro­gram­ma­tion. Pour la plupart, elles font partie in­té­grante de la bi­blio­thèque de leur langage, et sont donc à la dis­po­si­tion immédiate du dé­ve­lop­peur concerné ; aucune étape sup­plé­men­taire n’est alors né­ces­saire. À l’inverse, il peut s’avérer né­ces­saire d’installer des ex­ten­sions spé­ci­fiques pour utiliser d’autres de ces fonctions. Les fonctions PHP internes sont conçues de manière à permettre l’exécution efficace de tâches générales et d’opé­ra­tions fré­quem­ment utilisées. La fonction « strlen() » constitue à cet égard un exemple typique ; celle-ci renvoie la longueur d’une chaîne de ca­rac­tères. De manière générale, ces fonctions sont op­ti­mi­sées de manière à assurer des per­for­mances élevées.

À l’inverse, les fonctions per­son­na­li­sées cor­res­pon­dent à des sections de code di­rec­te­ment écrites par l’uti­li­sa­teur ; elles doivent donc être définies de manière explicite au sein du code. Le plus souvent, ces fonctions PHP sont adaptées à des cas d’uti­li­sa­tion spé­ci­fiques ou servent à résoudre des problèmes propres à un projet logiciel. Ces fonctions per­son­na­li­sées peuvent être composées d’al­go­rithmes complexes ou manipuler certaines données. Pour donner un exemple pertinent, certaines fonctions per­son­na­li­sées font appel à PHP pour récupérer des in­for­ma­tions dans une base de données MySQL avant de les formater pour les afficher sur un site Web.

PHP functions : comment sont-elles struc­tu­rées ?

Les fonctions PHP per­son­na­li­sées suivent un modèle bien précis. Vous trouverez ci-dessous la structure de base :

function functionName(parameter1, parameter2, ...) {
    // php function example code block
    return result; // optional
}

Découvrez avec nous les dif­fé­rentes parties d’une fonction PHP :

• function : ce mot-clé marque le début de la dé­fi­ni­tion de la fonction ;
• func­tion­Name : il s’agit là du nom de la fonction. Celui-ci doit être unique et des­crip­tif quant à l’objectif de la fonction ;
• parameter1, parameter2, … : les pa­ra­mètres cor­res­pon­dent aux valeurs trans­mises à la fonction PHP lorsque celle-ci est appelée. Ils sont fa­cul­ta­tifs, et vous pouvez en utiliser autant que vous le voulez ;
• code block : ce code permet d’exécuter la tâche ou les opé­ra­tions sou­hai­tées ;
• return result : il s’agit là d’une partie fa­cul­ta­tive. Si la fonction doit renvoyer un résultat, alors il convient d’utiliser cette dé­cla­ra­tion « return ».

Les fonctions internes n’ont, quant à elles, nul besoin d’être définies. Pour les appeler, vous pouvez di­rec­te­ment utiliser leur iden­ti­fi­ca­teur.

Exemples d’ap­pli­ca­tion des PHP functions

Découvrez avec nous certaines pos­si­bi­li­tés d’uti­li­sa­tion pratiques des fonctions PHP.

Attribuer des valeurs par défaut aux pa­ra­mètres

Vous pouvez définir des valeurs par défaut pour les pa­ra­mètres de vos fonctions PHP, en ren­seig­nant la valeur par défaut souhaitée di­rec­te­ment lors de la dé­fi­ni­tion de la fonction. Si vous n’indiquez aucune valeur pour ce paramètre au moment d’appeler la fonction, c’est la valeur par défaut qui est alors choisie.

function greet($name = "Tim") {
    echo "Hello, $name";
}
greet(); // Output: "Hello, Tim"
greet("Max"); // Output: "Hello, Max"

Trans­mettre des arguments en tant que référence

Les éléments sont transmis à une fonction « by value » (par valeur) ou « by reference » (par référence). Avec l’option « par valeur », une copie de l’élément concerné est utilisée, et les mo­di­fi­ca­tions ne s’ap­pli­quent pas à l’élément original hors de la fonction. Avec l’option « par référence », la véritable valeur est com­mu­ni­quée à la fonction, et les mo­di­fi­ca­tions internes à cette dernière sont ensuite reportées sur la valeur originale. Pour l’utiliser, il convient de placer le symbole « & » devant la dé­fi­ni­tion de la fonction.

function incrementByOne(&$num) {
    $num++;
}
$val = 5;
incrementByOne($val);
echo $val; // Output: "6"

Nous avons ici choisi de définir la fonction « in­cre­ment­ByOne » avec le paramètre $num, transmis par référence. L’opérateur de post-in­cré­men­ta­tion compte parmi les opé­ra­teurs PHP ; il in­cré­mente de 1 les nombres ou les chaînes de ca­rac­tères. Lorsque vous appelez la fonction PHP, la valeur $val passe donc de 5 à 6, car les mo­di­fi­ca­tions s’ap­pli­quent aussi hors de la fonction en raison de la méthode de trans­mis­sion par référence.