Les
fonctions
Le sommaire :
Une fonction est un
morceau de programme qui réalise une tâche bien précise, qui doit être autonome
et peut être utilisée par différents fichiers PHP.
Les morceaux de
programmes ainsi autonomes se distinguent en deux catégories :
La fonction se
déclare par l’intermédiaire du mot clef function, le contenu de cette dernière
devant être placé entre accolades.
Une fonction peut
être intégrée, si elle est placée dans le fichier source qui l’utilise, dans
quel cas elle ne sera utilisable qu’à partir du fichier la contenant, ou
externe, donc définie dans un fichier de fonctions, et par conséquent,
utilisable par tous les autres fichiers.
Une fonction doit retourner
un résultat par l’intermédiaire de l’instruction return.
Mais si vous
souhaitez qu’une fonction connaisse une ou plusieurs valeurs à traiter, il faut
lui passer ces valeurs en paramètres au moment de son appel.
Le passage de
paramètres à une fonction est néanmoins facultatif, dans quel cas, la fonction
n’est plus une fonction, mais une procédure…
La syntaxe :
< ?
function
NomFonction($ParamValeur1,$ParamValeur2) {
// ici nous avons
prévu que la fonction reçoive deux paramètres.
// les paramètres
placés entre parenthèses sont bien sûr des variables
Traitement ;
return
$Resultat ; }
Maintenant voici la syntaxe
qui permet d’utiliser la fonction NomFonction :
$ResultatDeLaFonction
= NomFonction(ValeurParam1,ValeurParam2) ;
La variable
$ResultatDeLaFonction reçoit le résultat que retourne la fonction par
l’intermédiaire de l’instruction return.
La fonction intégrée
peut être définie n’importe où dans un fichier source PHP.
Cependant, sa portée
est limitée au fichier source qui la contient.
Voici un exemple de
code qui propose la fonction Cube, qui calcule le cube d’une valeur passée en
paramètre :
<html>
<head>
<?php
// création de la
fonction Cube
Function
Cube($ValeurATraiter)
{ $ResultatCube =
$ValeurATraiter * $ValeurATraiter * $ValeurATraiter;
// Renvoi du
résultat
Return
$ResultatCube; } ?>
<title>
Utilisation d'une fonction intégrée</title>
</head>
<body>
<?php
// initialisation
d'une variable pour laquelle nous souhaitons afficher son cube
$ValeurInitiale = 3;
// affectation du
cube de $ValeurInitiale dans $Resultat
$Resultat =
Cube($ValeurInitiale);
// Affichage du
résultat
echo "Le cube
de $ValeurInitiale est : $Resultat »;
?>
</body>
</html>
Une fonction peut
aussi être externe.
Dans ce cas, sa
portée n’est pas restreinte, elle peut être utilisée à partir de tous vos
fichiers sources PHP.
Par contre, un
fichier PHP qui contient les fonctions externes doit répondre aux règles
suivantes :
Par exemple, si vous
créez le fichier MesFonctions de façon à y définir vos fonctions, vous devez
l’intituler MesFonctions.inc.
Puis, à l’intérieur
de ce fichier, vous devez saisir vos fonctions dans les balises traditionnelles
du PHP.
Autres règle
importante, un fichier PHP qui utilise une fonction externe doit déclarer le
nom du fichier de fonctions dans son entête, en première ligne.
La syntaxe
est :
<?php
include(«NomDuFichierDeFonctions»); ?>
Voici un
exemple :
Le code du fichier
de fonctions, Fonctions.inc :
<?php
// création de la
fonction Cube
Function
Cube($ValeurATraiter)
{ $ResultatCube =
$ValeurATraiter * $ValeurATraiter * $ValeurATraiter;
// Renvoi du
résultat
Return
$ResultatCube; } ?>
Le code du fichier
qui utilise la fonction Cube :
<?php include("fonctions.inc") ?>
<html>
<head>
<title>
Utilisation d'une fonction</title>
</head>
<body>
<?php
// initialisation
d'une variable pour laquelle nous souhaitons afficher son cube
$ValeurInitiale = 3;
// affectation du
cube de $ValeurInitiale dans $Resultat
$Resultat =
Cube($ValeurInitiale);
// Affichage du
résultat
echo "Le cube
de $ValeurInitiale est : $Resultat »;
?>
</body>
</html>
Philippe BOULANGER