pi()

La fonction pi() retourne la valeur de π (pi), la constante mathématique qui décrit le rapport entre la circonférence d'un cercle et son diamètre — approximativement 3.1415926535898. Cette page couvre sa syntaxe, sa relation avec la constante M_PI, et des exemples pratiques pour les calculs de cercle et de trigonométrie.

Syntaxe

pi(): float

La fonction ne prend aucun argument et retourne un float. Comme elle ne lève jamais d'exception et ne dépend d'aucune entrée, vous pouvez l'appeler partout où vous avez besoin de la constante.

Utilisation de base

PHP affiche 3.1415926535898 par défaut. La valeur stockée possède en réalité plus de précision que ce qui est affiché — la sortie est limitée par le paramètre ini precision (14 chiffres significatifs par défaut).

pi() vs la constante M_PI

PHP expose également π sous forme de constante prédéfinie M_PI. Les deux sont interchangeables — pi() retourne simplement M_PI :

<?php
var_dump(pi() === M_PI); // bool(true)

echo M_PI; // 3.1415926535898
?>

Utilisez celui qui est le plus lisible dans votre code. M_PI est une consultation de constante (légèrement plus rapide et conventionnel dans les formules), tandis que pi() peut être pratique lorsque vous souhaitez un callable, par exemple pour le passer comme valeur.

Contrôler la précision affichée

La valeur brute affiche un nombre limité de chiffres, mais vous pouvez la formater selon vos besoins avec round() ou number_format() :

<?php
echo round(pi(), 2);            // 3.14
echo PHP_EOL;
echo number_format(pi(), 4);    // 3.1416
?>

Cas d'utilisation courants

pi() est idéal partout où vous faites de la géométrie ou de la trigonométrie.

Circonférence et aire d'un cercle

<?php
$radius = 5;

$circumference = 2 * pi() * $radius;
$area          = pi() * $radius ** 2;

echo "Circumference: " . round($circumference, 4); // 31.4159
echo PHP_EOL;
echo "Area: " . round($area, 4);                   // 78.5398
?>

Conversion de degrés en radians

Les fonctions trigonométriques de PHP comme sin() et cos() attendent des radians, pas des degrés. Vous pouvez convertir avec π (ou utiliser le helper dédié deg2rad()) :

<?php
$degrees = 180;
$radians = $degrees * (pi() / 180);

echo $radians;            // 3.1415926535898
echo PHP_EOL;
echo round(sin($radians), 4); // ~0 (sine of 180°)
?>

Points d'attention

• Elle ne prend aucun argument. pi(2) n'est pas une utilisation valide — la fonction ignore toute entrée, donc n'attendez pas qu'elle mette la valeur à l'échelle.
• Les limites des nombres flottants s'appliquent. π est irrationnel ; le float retourné est une approximation. Évitez les comparaisons strictes == avec des décimales saisies manuellement comme 3.14159 — arrondissez les deux membres en premier.
• La précision est un paramètre d'affichage, pas la valeur stockée. Modifier la directive ini precision change le nombre de chiffres affichés par echo, pas la précision des calculs.

Conclusion

pi() (et son équivalent, la constante M_PI) vous fournit une valeur de π prête à l'emploi pour tout travail de géométrie ou de trigonométrie en PHP. Combinez-la avec round(), sqrt() et pow() pour des calculs plus clairs, et consultez la référence complète des mathématiques PHP pour les fonctions associées.

Pratique