Écrire ses fonctions et découper le site avec include et require

Déclarer et appeler une fonction

function prixTtc(float $ht, float $tva = 0.20): float
{
    $ttc = $ht * (1 + $tva);
    return round($ttc, 2);
}

echo prixTtc(100);         // 120
echo prixTtc(100, 0.10);   // 110
$total = prixTtc(30) * 3;  // le résultat s'utilise comme une valeur

• float $ht : le paramètre est typé ; PHP vérifie ce qu’on lui passe.
• $tva = 0.20 : valeur par défaut, utilisée si l’argument est omis (les paramètres par défaut se placent à la fin).
• : float après la parenthèse : le type de retour. void signifie « ne renvoie rien ».
• return renvoie la valeur et quitte la fonction immédiatement.

La portée des variables

$tva = 0.20;
function ttc(float $ht): float
{
    return $ht * (1 + $tva);   // Warning: Undefined variable $tva
}

Solutions propres : passer la valeur en paramètre, ou utiliser une constante (const TVA = 0.20;), visible partout.

Des fonctions prêtes à l’emploi

PHP fournit des milliers de fonctions natives : strlen, date, count, round, rand, max… La documentation officielle (php.net, en français) donne pour chacune ses paramètres et un exemple : prenez l’habitude d’y chercher avant d’écrire votre propre fonction.

include et require : réutiliser des fichiers

Organisation habituelle d’un petit site :

souk/
├── index.php
├── catalogue.php
└── inc/
    ├── fonctions.php   ← prixTtc(), badgeStock()...
    ├── entete.php      ← <!DOCTYPE html>, <head>, menu
    └── pied.php        ← footer, </body></html>

<?php
require_once __DIR__ . '/inc/fonctions.php';
$titre = "Catalogue";              // variable utilisée par entete.php
require __DIR__ . '/inc/entete.php';
?>
<p>Contenu propre à cette page</p>
<?php require __DIR__ . '/inc/pied.php'; ?>

Le fichier inclus voit les variables de l’endroit où il est inclus : c’est pour cela que entete.php peut afficher $titre.