Les fonctions

Le principe

En PHP nous utilisons un grand nombre de fonctions déjà construites, elles sont dites natives. Celles-ci ont généralement la structure suivante : int nom_fonction(paramètres) et elles renvoient 0 ou 1 suivant la réussite de leur exécution, ce qui permet de connaître leur bon exécution.
Pour exécuter une fonction on l'appelle avec les paramètres nécessaires. Ces paramètres sont documentés clairement sur le site officiel de PHP.

On peut bien sûr déclarer de nouvelles fonctions et créer ainsi des librairies complètes de fonctions qui seront appelées par exemple avec la fonction include.

Notons que certaines fonctions n'ont pas de paramètres, dans ce cas, on les appelle avec des parenthèses vides.

Fonction et valeur retournée

1er exemple

<?php
/*
appel à la fonction calcul de superficie d'un disque
qui prend en paramètre la taille du rayon
*/
$rayon = 15;
$aire = calcul_superficie($rayon);
echo "L'aire du disque de rayon $rayon est : $aire"; 
?>

Pour déclarer cette fonction, la construction est la suivante :

<?php
// fonction de calcul de la superficie d'un disque
function calcul_superficie($rayon) {
    $sup = $rayon * $rayon * 3.14159; 
    return $sup;
}
?>

Nous remarquons qu'il nous faut préciser la valeur renvoyée par la fonction à l'aide de la commande return. De plus, il faut interroger directement la valeur renvoyée par la fonction, ce qui est classique.
Le résultat sera le suivant :

L'aire du disque de rayon 15 est : 706.85775

Fonction sans argument ou paramètre

Exemple

Voici le cas d'une fonction qui ne prend pas de paramètre en entrée et retourne la dizaine inférieure des minutes de l'heure courante.

<?php
function dizaine() {
    $date = new DateTime(); // objet DateTime (programmation orientée objet)
    $minutes = $date->format("i");
    $min = floor($minutes/10)*10;
    return $min;
}
echo dizaine();
?>

Résultat :

0

Sans argument on laisse les parenthèses vides

Fonction avec un argument facultatif

Il suffit de préciser dans la déclaration de la fonction l'argument en lui assignant une valeur

<?php
function dizaineh($heure = 0) {
    $date = new DateTime(); // objet DateTime (programmation orientée objet)
    $minutes = $date->format("i");
    $min = floor($minutes/10)*10;
    if ($heure)
        $min = $date->format("H").":".$min;
    return $min;
}
echo dizaineh()."<br />".dizaineh(1);
?>

0
03:0

Fonction qui retourne plusieurs valeurs

Et si la fonction devait retourner plusieurs valeurs ?
Dans ce cas, il faut retourner un tableau que l'on exploitera ensuite comme tel.

Exemple

<?php
function calcul($n1) {
    $resultat[] = $n1 * 3;
    $resultat[] = $n1 + 3;
    return $resultat;
}
$res = calcul(5);
echo "produit = $res[0] et somme = $res[1]<br />";
list($produit, $somme) = calcul(7);
echo "produit = $produit et somme = $somme";
?>

Le résultat sera :

Avec le chiffre 5, produit = 15 et somme = 8
Avec le chiffre 7, produit = 21 et somme = 10

A noter

• l'emploi d'un tableau ($resultat[]) pour retourner plus d'une valeur. On récupère ensuite ces valeurs en parcourant le tableau
• l'emploi de la fonction list() particulièrement pratique pour récupérer dans de nouvelles variables le résultat d'une fonction retournant plusieurs valeurs.

Voyons ensuite les différents moyens de passer des variables entre pages, d'exploiter les formulaires...