Comment Ca Marche - Communauté informatique  
   
Accueil - Encyclopédie informatiqueTélécharger l'encyclopédieContribuer à cet article

PHP - Les fonctions

Fonctions avec PHP Encyclopédie

La notion de fonction

On appelle fonction un sous-programme qui permet d'effectuer un ensemble d'instructions par simple appel de la fonction dans le corps du programme principal. Les fonctions permettent d'exécuter dans plusieurs parties du programme une série d'instructions, cela permet une simplicité du code et donc une taille de programme minimale. D'autre part, une fonction peut faire appel à elle-même, on parle alors de fonction récursive (il ne faut pas oublier de mettre une condition de sortie au risque sinon de ne pas pouvoir arrêter le programme...).

La déclaration d'une fonction

PHP recèle de nombreuses fonctions intégrées permettant d'effectuer des actions courantes. Toutefois, il est possible de définir des fonctions, dites fonctions utilisateurs afin de simplifier l'exécution de séries d'instructions répétitives. Contrairement à de nombreux autres langages, PHP nécessite que l'on définisse une fonction avant que celle-ci puisse être utilisée, car pour l'appeler dans le corps du programme il faut que l'interpréteur la connaisse, c'est-à-dire qu'il connaisse son nom, ses arguments et les instructions qu'elle contient. La définition d'une fonction s'appelle "déclaration" et peut se faire n'importe où dans le code. La déclaration d'une fonction se fait grâce au mot-clé function, selon la syntaxe suivante : 

function Nom_De_La_Fonction(argument1, argument2, ...) {
		 liste d'instructions
}

Remarques:

  • le nom de la fonction suit les mêmes règles que les noms de variables :
    • le nom doit commencer par une lettre
    • un nom de fonction peut comporter des lettres, des chiffres et les caractères _ et & (les espaces ne sont pas autorisés!)
    • le nom de la fonction, comme celui des variables est sensible à la casse (différenciation entre les minuscules et majuscules)
  • Les arguments sont facultatifs, mais s'il n'y a pas d'arguments, les parenthèses doivent rester présentes
  • Il ne faut pas oublier de refermer les accolades

  • Le nombre d'accolades ouvertes (fonction, boucles et autres structures) doit être égal au nombre d'accolades fermées!
  • La même chose s'applique pour les parenthèses, les crochets ou les guillemets!
Une fois cette étape franchie, votre fonction ne s'exécutera pas tant que l'on ne fait pas appel à elle quelque part dans la page!

Appel de fonction

Pour exécuter une fonction, il suffit de faire appel à elle en écrivant son nom (une fois de plus en respectant la casse) suivie d'une parenthèse ouverte (éventuellement des arguments) puis d'une parenthèse fermée : 

Nom_De_La_Fonction();

Remarques:

  • le point virgule signifie la fin d'une instruction et permet à l'interpréteur de distinguer les différents blocs d'instructions
  • si jamais vous avez défini des arguments dans la déclaration de la fonction, il faudra veiller à les inclure lors de l'appel de la fonction (le même nombre d'arguments séparés par des virgules!) 
    Nom_De_La_Fonction(argument1, argument2);

Renvoi d'une valeur par une fonction

La fonction peut renvoyer une valeur (et donc se terminer) grâce au mot-clé return. Lorsque l'instruction return est rencontrée, la fonction évalue la valeur qui la suit, puis la renvoie au programme appelant (programme à partir duquel la fonction a été appelée).

Une fonction peut contenir plusieurs instructions return, ce sera toutefois la première instruction return rencontrée qui provoquera la fin de la fonction et le renvoi de la valeur qui la suit.

La syntaxe de l'instruction return est simple : 

return valeur_ou_variable;

Les arguments d'une fonction

Il est possible de passer des arguments à une fonction, c'est-à-dire lui fournir une valeur ou le nom d'une variable afin que la fonction puisse effectuer des opérations sur ces arguments ou bien grâce à ces arguments.
Le passage d'arguments à une fonction se fait au moyen d'une liste d'arguments (séparés par des virgules) entre parenthèses suivant immédiatement le nom de la fonction. Les arguments peuvent être de simple variables, mais aussi des tableaux ou des objets. A noter qu'il est possible de donner une valeur par défaut à ces arguments en faisant suivre le nom de la variable par le signe "=" puis la valeur que l'on affecte par défaut à la variable.

Lorsque vous voulez utiliser un argument dans le corps de la fonction en tant que variable, celui-ci doit être précédé par le signe $. 

<?
function dire_texte($qui, $texte = 'Bonjour')
{

 if(empty($qui)){ // $qui est vide, on retourne faux
  return false;

 }else{
  echo "$texte $qui"; // on affiche le texte
  return true; // fonction exécutée avec succès
 }
}

?>

Ainsi cette fonction peut être appelée de deux façons différentes : 

<?
// Passage des deux paramètres
dire_texte("cher phpeur", "Bienvenue"); // affiche "Bienvenue cher phpeur"
// Utilisation de la valeur par défaut du deuxième paramètre
dire_texte("cher phpeur"); // affiche "Bonjour cher phpeur"
?>

Travailler sur des variables dans les fonctions

Lorsque vous manipulerez des variables dans des fonctions, il vous arrivera de constater que vous avez beau modifier la variable dans la fonction celle-ci retrouve sa valeur d'origine dès que l'on sort de la fonction...

Cela est du à la portée des variables, c'est-à-dire si elles ont été définies comme variables globales ou locales.
Il existe plusieurs niveaux de définition de variables :

  • Une variable précédée du mot clé global sera visible dans l'ensemble du code, c'est-à-dire que sa portée ne sera pas limitée à la fonction seulement. Ainsi, toutes les fonctions pourront utiliser et modifier cette même variable
  • Le niveau static permet de définir une variable locale à la fonction, qui persiste durant tout le temps d'exécution du script
  • Par défaut, la variable possède le niveau local, c'est-à-dire que la variable ne sera modifiée qu'à l'intérieur de la fonction et retrouvera la valeur qu'elle avait juste avant l'appel de fonction à la sortie de celle-ci
<?
$chaine = "Nombre de camions : ";

function ajoute_camion($mode='')
{

 global $chaine;

 static $nb=0;

  $nb++; // on incrémente le nombre de camions
 if($mode == "affiche"){
  echo $chaine.$nb; // on affiche le nombre de camions
 }
}

ajoute_camion(); // nb == 1
ajoute_camion(); // nb == 2
ajoute_camion(); // nb == 3
ajoute_camion("affiche"); // affiche Nombre de camions : 4
?>

Passage de paramètre par référence

Une autre méthode pour modifier une variable consiste à la faire précéder du caractère &, précisant qu'il s'agit alors d'un alias: la valeur de la variable est modifiée à la sortie de la fonction. On parle alors de passage par référence. Dans ce cas on passe la référence (adresse mémoire) de la variable à la fonction, ce qui permet de modifier sa valeur. 

<?
function dire_texte($qui, &$texte)
{

 $texte = "Bienvenue $qui";

}

$chaine = "Bonjour ";

dire_texte("cher phpeur",$chaine);

echo $chaine; // affiche "Bienvenue cher phpeur"
?>

Retourner plusieurs variables

Lorsque vous souhaitez qu'une fonction retourne plusieurs valeurs, le plus simple est d'utiliser un tableau. 

<?
function nom_fonction()
{

.....
return array( $variable1, $variable2, $variable3 );

// on retourne les valeurs voulues dans un tableau
}

$retour = nom_fonction();

echo "$retour[0] - $retour[1] - $retour[2]";

?>

La récursivité

Les fonctions récursives sont des fonctions qui s'appellent elles-mêmes. Ce type de fonction se révéle indispensable pour parcourir une arborescence par exemple.
Voici un exemple simple. 

<?
function fonction_recursive($n=0)
{

 $n++;

 echo "$n <br>";

 if($n < 10){ // si n est inférieur à 10 on continue
  fonction_recursive($n);

 }
}

fonction_recursive(); // affiche les nb de 1 à 10
?>

Trucs & astuces pertinents trouvés dans la base de connaissances

18/11 01h10 Fonction mail() (PHP)
04/11 15h50 Rediriger en fonction de la langue du visiteur (PHP)
20/02 11h25 Mon accès à internet ne fonctionne plus (Connexion)
01/01 03h06 Notice: Undefined index: (Langages)
29/12 16h39 Afficher facilement le code php/xhtml de vos pages (Webmaster)
28/12 00h03 Récupérer login et mot de passe passés par un .htaccess (PHP)
08/12 22h42 Les ressemblances à ne pas confondre (PHP)
02/12 16h02 Vérifier une adresse électronique (format du mail) (PHP)
22/11 23h51 Rediriger sur une autre page (redirection) (PHP)
18/11 12h04 Toutes les fonctions de google sur un seul site (Google)
PHP fonctions Plus d'astuces sur « PHP fonctions »

Discussions pertinentes trouvées dans le forum

15/06 14h10 php fonction mysql [PHP] fonction Mysql permettant de... Webmastering 15/06 15h54->antic8014
04/05 12h01 fonction php fonction javascript fonction PHP depuis fonction javascript Webmastering 09/04 14h41->einstein2129
14/07 11h49 php fonction contraire md5 [php]fonction contraire du md5? Webmastering 20/01 01h32->maxime_B8
11/10 13h58 imput type file fonction ftp php imput type=file et fonction FTP en PHP Webmastering 11/10 14h33->bivouak7
13/12 13h07 php fonction mail copie cachée [PhP]fonction mail & Copie cachée Webmastering 19/12 11h54->Zep3k!GnO7
11/02 18h29 php fonction [PHP] Aide sur une fonction Webmastering 14/02 12h35->txiki6
25/09 09h19 php sql requête [php/SQL] Bonne requête qui ne fonctionne pas Webmastering 25/09 15h13->Ohm-WorK5
17/06 14h30 fonction imprimer javascript php fonction imprimer javascript et PHP Webmastering 17/06 15h02->Imer4
01/05 16h34 easy php . t'il Easy PHP . comment fonctionne t'il Webmastering 22/05 11h18->romano844
09/08 16h37 php changer title fonction page [php]changer <title> en fonction de la page Webmastering 10/08 10h10->maxime_B4
Discussion fermée Problème résolu PHP fonctions Plus de discussions sur « PHP fonctions »

Ce document intitulé « PHP - Les fonctions » issu de l'encyclopédie informatique Comment Ça Marche (www.commentcamarche.net) est mis à disposition sous les termes de la licence Creative Commons. Vous pouvez copier, modifier des copies de cette page, dans les conditions fixées par la licence, tant que cette note apparaît clairement.