# Fonction

> Bloc de code PHP nommé et réutilisable, qui reçoit éventuellement des paramètres et peut renvoyer un résultat, appelé à volonté dans le programme.

- Auteur : Clément Hadrot
- Publié le : 2026-09-25
- Mis à jour le : 2026-09-25
- URL : https://wpmoderne.dev.wordpress-developpement.fr/lexique/fonction-php/

Isoler une tâche précise sous un nom clair, pour l'invoquer ensuite d'un simple appel plutôt que de recopier la même logique à plusieurs endroits : voilà l'intérêt fondamental d'une fonction en PHP.

## Le vocabulaire de base d'un thème WordPress

Un fichier `functions.php` de thème regorge de fonctions personnalisées, préfixées par convention par le nom du thème pour éviter tout conflit avec un autre thème ou plugin (par exemple `montheme_afficher_auteur()`). WordPress lui-même expose des centaines de fonctions publiques comme `get_the_title()` ou `wp_get_attachment_image()` que l'on invoque directement dans les templates.

## Exemple

```
function montheme_temps_de_lecture(int $nombre_mots, int $mots_par_minute = 200): int
{
    return (int) ceil($nombre_mots / $mots_par_minute);
}

echo montheme_temps_de_lecture(850) . ' min de lecture';
```

Le type de retour `: int` et le type des paramètres, disponibles depuis PHP 7, garantissent que la fonction refuse ou convertit toute valeur incohérente passée en argument.

## Bon à savoir

- Une fonction déclarée deux fois sous le même nom provoque une erreur fatale ; entourer sa déclaration d'un test `function_exists()` évite ce risque dans un thème destiné à être personnalisé par un thème enfant.
- Les arguments nommés, disponibles depuis PHP 8, permettent d'appeler une fonction en précisant explicitement le nom de chaque paramètre, indépendamment de leur ordre de déclaration.
- Une fonction variadique (`function total(...$nombres)`) accepte un nombre indéfini d'arguments, rassemblés automatiquement dans un tableau.