pi()

La función pi() devuelve el valor de π (pi), la constante matemática que describe la relación entre la circunferencia de un círculo y su diámetro — aproximadamente 3.1415926535898. Esta página cubre su sintaxis, cómo se relaciona con la constante M_PI y ejemplos prácticos de cálculos de geometría y trigonometría.

Sintaxis

pi(): float

La función no acepta argumentos y devuelve un float. Dado que nunca lanza excepciones ni depende de ninguna entrada, puedes llamarla en cualquier lugar donde necesites la constante.

Uso básico

PHP imprime 3.1415926535898 por defecto. El valor almacenado tiene en realidad más precisión de la que se muestra — la salida está limitada por la configuración ini precision (14 dígitos significativos por defecto).

pi() vs la constante M_PI

PHP también expone π como la constante predefinida M_PI. Ambas son intercambiables — pi() simplemente devuelve M_PI:

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

echo M_PI; // 3.1415926535898
?>

Usa la que mejor lea en tu código. M_PI es una búsqueda de constante (marginalmente más rápida y convencional dentro de fórmulas), mientras que pi() puede ser útil cuando necesitas un callable, por ejemplo al pasarla como valor.

Controlar la precisión mostrada

El valor bruto tiene dígitos mostrados limitados, pero puedes formatearlo según sea necesario con round() o number_format():

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

Casos de uso comunes

pi() brilla en cualquier lugar donde realices geometría o trigonometría.

Circunferencia y área de un círculo

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

Convertir grados a radianes

Las funciones trigonométricas de PHP como sin() y cos() esperan radianes, no grados. Puedes convertir con π (o usar la función auxiliar dedicada deg2rad()):

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

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

Advertencias

• No acepta argumentos. pi(2) no es un uso válido — la función ignora cualquier entrada, así que no esperes que escale el valor.
• Se aplican los límites de punto flotante. π es irracional; el float devuelto es una aproximación. Evita comparaciones estrictas con == usando decimales escritos a mano como 3.14159 — redondea ambos lados primero.
• La precisión es una configuración de visualización, no el valor almacenado. Cambiar la directiva ini precision cambia cuántos dígitos muestra echo, no la exactitud de los cálculos.

Conclusión

pi() (y su equivalente la constante M_PI) te proporciona un valor de π listo para usar en cualquier trabajo de geometría o trigonometría en PHP. Combínala con round(), sqrt() y pow() para matemáticas más limpias, y consulta la referencia completa de Math de PHP para funciones relacionadas.

Práctica