Les Fonctions

Une fonction sert à regrouper du code réutilisable.

Imagine une fonction comme une petite machine :

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

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 :

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

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 :

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 ?

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 :

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