Les Fonctions
Une fonction sert à regrouper du code réutilisable.
Imagine une fonction comme une petite machine :
- Tu lui donnes des informations
- Elle fait un travail
- Elle retourne un résultat
Le gros avantage :
tu peux réutiliser le même code plusieurs fois sans le réécrire.
1. Créer une fonction
Une fonction se crée avec le mot-clé function.
function addition($a, $b) {
return $a + $b;
}
Comprendre la syntaxe
- function → crée une fonction
- addition → nom de la fonction
- $a et $b → paramètres
- return → retourne le résultat
Ici, la fonction additionne deux nombres.
2. Les paramètres
Les paramètres sont des valeurs envoyées dans la fonction.
addition(10, 5);
Dans cet exemple :
- 10 devient $a
- 5 devient $b
PHP exécute ensuite le calcul.
3. Le return
Le mot-clé return sert à retourner une valeur.
return $a + $b;
Sans return, la fonction ne renvoie rien.
Pense à return comme :
« Voici le résultat final »
4. Typage des paramètres
PHP peut préciser le type des données attendues.
function addition(int $a, int $b): int {
return $a + $b;
}
Explication
- int → attend un nombre entier
- : int → retourne un entier
Cela rend le code plus propre et plus sécuritaire.
5. Exemple complet
$Var1 = 50;
$Var2 = 40;
function addition(int $a, int $b): int {
$Reponse = $a + $b;
return $Reponse;
}
echo addition($Var1, $Var2);
Résultat fonction
> 50 + 40 = 90
6. Fonction avec texte
Une fonction peut aussi retourner du texte.
function hello(string $name): string {
return "Bonjour " . $name;
}
Résultat texte
> Bonjour Fred
7. Pourquoi utiliser des fonctions ?
Les fonctions sont très importantes en programmation.
Elles permettent :
- de réutiliser du code
- de mieux organiser le projet
- de rendre le code plus propre
- de faciliter les corrections
Dans les vrais projets, les fonctions sont utilisées partout.
8. Utiliser une fonction dans une page
Créer une fonction ne suffit pas. Pour qu’elle s’exécute, il faut l’appeler.
Appeler une fonction veut dire : demander à PHP d’exécuter le code qui est dans cette fonction.
function direBonjour() {
echo "Bonjour Fred";
}
direBonjour();
Ici, la fonction est créée avec function direBonjour(), puis elle est utilisée avec direBonjour();.
9. La portée des variables
La portée d’une variable, c’est l’endroit où elle existe dans le code.
Une variable créée dans une fonction existe seulement dans cette fonction.
function test() {
$message = "Salut";
echo $message;
}
test();
Ici, $message fonctionne parce qu’il est utilisé à l’intérieur de la fonction.
function test() {
$message = "Salut";
}
echo $message; // Erreur
Ici, ça ne fonctionne pas parce que $message est enfermée dans la fonction.
À retenir
> Une variable dans une fonction reste dans la fonction.
> Une variable hors fonction n’est pas automatiquement disponible dans la fonction.
10. Utiliser un fichier MesFonctions.php
Dans un projet, on évite de mettre toutes les fonctions dans chaque page. On crée souvent un fichier séparé, par exemple :
MesFonctions.php
Ce fichier contient seulement les fonctions réutilisables.
Exemple : MesFonctions.php
<?php
function addition(int $a, int $b): int {
return $a + $b;
}
function direBonjour(string $name): string {
return "Bonjour " . $name;
}
?>
Exemple : index.php
<?php
require_once "MesFonctions.php";
echo addition(10, 5);
echo direBonjour("Fred");
?>
require_once sert à importer le fichier une seule fois. Après ça, les fonctions deviennent disponibles dans la page.
11. require, include, require_once et include_once
PHP permet d’importer le contenu d’un autre fichier.
| Instruction | Utilisation |
|---|---|
| include | Importe un fichier. Si le fichier manque, PHP continue quand même. |
| require | Importe un fichier. Si le fichier manque, PHP bloque la page. |
| include_once | Importe le fichier une seule fois. |
| require_once | Importe le fichier une seule fois et bloque si le fichier manque. |
Pour les fichiers de fonctions, la meilleure option est souvent :
require_once "MesFonctions.php";
12. Documenter une fonction
Documenter une fonction, c’est écrire un commentaire clair qui explique ce qu’elle fait.
La bonne méthode est d’utiliser un bloc de commentaire juste au-dessus de la fonction.
/**
* Additionne deux nombres entiers.
*
* @param int $a Premier nombre
* @param int $b Deuxième nombre
* @return int Résultat de l’addition
*/
function addition(int $a, int $b): int {
return $a + $b;
}
À quoi ça sert ?
- Comprendre rapidement le rôle de la fonction
- Savoir quels paramètres elle attend
- Savoir ce qu’elle retourne
- Rendre le code plus professionnel
13. Bonne structure d’une fonction
Une fonction propre devrait faire une seule chose.
Exemple propre :
function calculerTotal(float $prix, int $quantite): float {
return $prix * $quantite;
}
Cette fonction est claire :
- Elle calcule un total
- Elle reçoit un prix
- Elle reçoit une quantité
- Elle retourne un résultat
Bonnes pratiques
> Donne un nom clair à ta fonction.
> Utilise des paramètres typés.
> Utilise return pour retourner une valeur.
> Documente les fonctions importantes.
> Garde une fonction simple et précise.
Résumé rapide
| Élément | Rôle |
|---|---|
| function | Créer une fonction |
| Paramètres | Envoyer des données |
| return | Retourner un résultat |
| Typage | Préciser les types de données |