pi()

La funzione pi() restituisce il valore di π (pi greco), la costante matematica che descrive il rapporto tra la circonferenza di un cerchio e il suo diametro — approssimativamente 3.1415926535898. Questa pagina tratta la sua sintassi, la relazione con la costante M_PI e esempi pratici per la matematica di cerchi e trigonometria.

Sintassi

pi(): float

La funzione non accetta alcun argomento e restituisce un float. Poiché non lancia mai eccezioni e non dipende da alcun input, puoi chiamarla ovunque tu abbia bisogno della costante.

Utilizzo di Base

PHP stampa 3.1415926535898 per impostazione predefinita. Il valore memorizzato ha in realtà una precisione maggiore di quella mostrata — l'output è limitato dall'impostazione ini precision (14 cifre significative per impostazione predefinita).

pi() vs la Costante M_PI

PHP espone π anche come costante predefinita M_PI. Le due sono intercambiabili — pi() restituisce semplicemente M_PI:

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

echo M_PI; // 3.1415926535898
?>

Usa quella che risulta più leggibile nel tuo codice. M_PI è una ricerca di costante (marginalmente più veloce e convenzionale all'interno delle formule), mentre pi() può essere utile quando vuoi un callable, ad esempio per passarlo come valore.

Controllo della Precisione Visualizzata

Il valore grezzo ha un numero limitato di cifre visualizzate, ma puoi formattarlo secondo le tue esigenze con round() o number_format():

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

Casi d'Uso Comuni

pi() eccelle ovunque si faccia geometria o trigonometria.

Circonferenza e Area di un Cerchio

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

Conversione da Gradi a Radianti

Le funzioni trigonometriche di PHP come sin() e cos() si aspettano radianti, non gradi. Puoi convertire con π (oppure usare l'helper dedicato deg2rad()):

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

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

Attenzioni

• Non accetta argomenti. pi(2) non è un utilizzo valido — la funzione ignora qualsiasi input, quindi non aspettarti che scali il valore.
• Si applicano i limiti dei numeri in virgola mobile. π è irrazionale; il float restituito è un'approssimazione. Evita confronti stretti == con decimali scritti a mano come 3.14159 — arrotonda entrambi i lati prima.
• La precisione è un'impostazione di visualizzazione, non il valore memorizzato. Modificare la direttiva ini precision cambia quante cifre mostra echo, non l'accuratezza dei calcoli.

Conclusione

pi() (e la sua equivalente costante M_PI) ti fornisce un valore pronto all'uso di π per qualsiasi lavoro di geometria o trigonometria in PHP. Abbinala a round(), sqrt() e pow() per una matematica più pulita, e consulta il riferimento completo di PHP Math per le funzioni correlate.

Pratica