pi()

Die Funktion pi() gibt den Wert von π (Pi) zurück, die mathematische Konstante, die das Verhältnis des Umfangs eines Kreises zu seinem Durchmesser beschreibt — ungefähr 3.1415926535898. Diese Seite behandelt die Syntax, die Beziehung zur Konstante M_PI und praktische Beispiele für Kreis- und Trigonometrieberechnungen.

Syntax

pi(): float

Die Funktion nimmt keine Argumente entgegen und gibt einen float zurück. Da sie niemals eine Ausnahme auslöst und nicht von einer Eingabe abhängt, kann sie überall dort aufgerufen werden, wo die Konstante benötigt wird.

Grundlegende Verwendung

PHP gibt standardmäßig 3.1415926535898 aus. Der gespeicherte Wert hat tatsächlich eine höhere Genauigkeit als angezeigt — die Ausgabe wird durch die ini-Einstellung precision begrenzt (standardmäßig 14 signifikante Stellen).

pi() vs. die Konstante M_PI

PHP stellt π auch als vordefinierte Konstante M_PI zur Verfügung. Beide sind austauschbar — pi() gibt einfach M_PI zurück:

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

echo M_PI; // 3.1415926535898
?>

Verwenden Sie, was in Ihrem Code lesbarer ist. M_PI ist ein konstanter Lookup (geringfügig schneller und in Formeln üblich), während pi() praktisch sein kann, wenn eine aufrufbare Funktion benötigt wird, z. B. um sie als Wert zu übergeben.

Angezeigte Genauigkeit steuern

Der Rohwert hat begrenzte angezeigte Stellen, aber Sie können ihn bei Bedarf mit round() oder number_format() formatieren:

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

Häufige Anwendungsfälle

pi() ist überall dort nützlich, wo Geometrie oder Trigonometrie benötigt wird.

Umfang und Fläche eines Kreises

<?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
?>

Grad in Radiant umrechnen

PHPs trigonometrische Funktionen wie sin() und cos() erwarten Radiant, keine Grad. Die Umrechnung erfolgt mit π (oder mit dem dedizierten Hilfsprogramm deg2rad()):

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

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

Fallstricke

• Die Funktion nimmt keine Argumente entgegen. pi(2) ist keine gültige Verwendung — die Funktion ignoriert jede Eingabe, daher sollte man nicht erwarten, dass der Wert skaliert wird.
• Gleitkomma-Grenzen gelten. π ist irrational; der zurückgegebene float ist eine Annäherung. Vermeiden Sie strikte ==-Vergleiche mit manuell eingegebenen Dezimalzahlen wie 3.14159 — runden Sie zuerst beide Seiten.
• Genauigkeit ist eine Anzeigeeinstellung, kein gespeicherter Wert. Das Ändern der ini-Direktive precision ändert, wie viele Stellen echo anzeigt, nicht die Genauigkeit der Berechnungen.

Fazit

pi() (und die gleichwertige Konstante M_PI) liefert einen einsatzbereiten Wert von π für alle Geometrie- oder Trigonometrieaufgaben in PHP. Kombinieren Sie es mit round(), sqrt() und pow() für sauberere Berechnungen, und sehen Sie sich die vollständige PHP-Math-Referenz für verwandte Funktionen an.

Übungen