pi()

A função pi() retorna o valor de π (pi), a constante matemática que descreve a razão entre a circunferência de um círculo e seu diâmetro — aproximadamente 3.1415926535898. Esta página aborda sua sintaxe, como ela se relaciona com a constante M_PI e exemplos práticos para cálculos de círculos e trigonometria.

Sintaxe

pi(): float

A função não recebe nenhum argumento e retorna um float. Como nunca lança exceções e nunca depende de entrada, você pode chamá-la em qualquer lugar que precise da constante.

Uso Básico

O PHP exibe 3.1415926535898 por padrão. O valor armazenado tem mais precisão do que o exibido — a saída é limitada pela configuração ini precision (14 dígitos significativos por padrão).

pi() vs a Constante M_PI

O PHP também expõe π como a constante predefinida M_PI. As duas são intercambiáveis — pi() simplesmente retorna M_PI:

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

echo M_PI; // 3.1415926535898
?>

Use aquela que fica mais legível no seu código. M_PI é uma busca de constante (marginalmente mais rápida e convencional dentro de fórmulas), enquanto pi() pode ser útil quando você precisa de um callable, por exemplo ao passá-la como valor.

Controlando a Precisão Exibida

O valor bruto tem dígitos exibidos limitados, mas você pode formatá-lo conforme necessário com round() ou number_format():

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

Casos de Uso Comuns

pi() brilha em qualquer situação que envolva geometria ou trigonometria.

Circunferência e Área de um 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
?>

Convertendo Graus em Radianos

As funções trigonométricas do PHP como sin() e cos() esperam radianos, não graus. Você pode converter usando π (ou usar o auxiliar dedicado deg2rad()):

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

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

Armadilhas

• Não aceita argumentos. pi(2) não é um uso válido — a função ignora qualquer entrada, portanto não espere que ela escale o valor.
• Limites de ponto flutuante se aplicam. π é irracional; o float retornado é uma aproximação. Evite comparações estritas com == usando decimais digitados manualmente como 3.14159 — arredonde ambos os lados primeiro.
• A precisão é uma configuração de exibição, não do valor armazenado. Alterar a diretiva ini precision muda quantos dígitos o echo exibe, não a exatidão dos cálculos.

Conclusão

pi() (e sua constante equivalente M_PI) fornece um valor pronto para uso de π em qualquer trabalho de geometria ou trigonometria no PHP. Combine com round(), sqrt() e pow() para uma matemática mais limpa, e consulte a referência completa de Math do PHP para funções relacionadas.

Prática