rad2deg()

A função rad2deg() do PHP converte um ângulo medido em radianos para o ângulo equivalente em graus. É o inverso exato de deg2rad(), e é muito útil quando uma função matemática retorna um resultado em radianos, mas você precisa de um valor legível em graus.

O que São Radianos e Graus?

Tanto radianos quanto graus medem ângulos — são apenas duas unidades diferentes, como metros e centímetros.

• Um círculo completo equivale a 360 graus, ou 2π radianos.
• Isso faz com que 1 radiano seja igual a 180/π graus, o que equivale a aproximadamente 57.29578 graus.

As funções trigonométricas embutidas do PHP (sin(), cos(), atan(), …) trabalham todas em radianos, portanto rad2deg() é a ponte que transforma esses resultados de volta em graus que a maioria das pessoas entende.

Sintaxe

rad2deg(float $num): float

• $num — o ângulo em radianos que você deseja converter.
• Valor de retorno — o mesmo ângulo expresso em graus, como um float.

Como Usar a Função rad2deg()

Passe o valor em radianos e rad2deg() retorna o ângulo em graus:

Aqui 1.047 radianos (próximo de π/3) é convertido para aproximadamente 60 graus.

Valores de Referência Comuns

Usando a constante M_PI do PHP (o mesmo valor retornado por pi()), os ângulos conhecidos são convertidos assim:

<?php
echo rad2deg(M_PI);       // 180
echo "\n";
echo rad2deg(M_PI / 2);   // 90
echo "\n";
echo rad2deg(M_PI / 4);   // 45
echo "\n";
echo rad2deg(2 * M_PI);   // 360
?>

rad2deg() vs. deg2rad()

As duas funções são imagens espelhadas uma da outra, portanto converter em um sentido e depois no outro retorna o valor original:

<?php
$degrees = 90;

$radians = deg2rad($degrees);   // 1.5707963267949
$back     = rad2deg($radians);  // 90

echo $back;                     // 90
?>

Use deg2rad() antes de chamar uma função trigonométrica, e rad2deg() depois de uma.

Exemplo Prático: Lendo um Ângulo de cos()

As funções trigonométricas inversas retornam radianos. Converta o resultado com rad2deg() para obter um ângulo legível, e use round() para arredondar o float longo:

<?php
// acos() returns the angle (in radians) whose cosine is 0.5
$radians = acos(0.5);

$degrees = rad2deg($radians);

echo round($degrees, 2);   // 60
?>

Pontos Importantes

• rad2deg() sempre retorna um float, mesmo para resultados com números inteiros como 180. Use round() ou number_format() quando precisar de um valor de exibição mais limpo.
• A função apenas muda a unidade, não o ângulo em si — rad2deg(M_PI) e M_PI descrevem a mesma direção.
• Passar uma string não numérica gera um TypeError no PHP 8+; certifique-se de que o argumento seja numérico.

Conclusão

rad2deg() é um auxiliar pequeno, mas essencial para qualquer código PHP que lida com ângulos. Combine-a com deg2rad(), as funções trigonométricas e pi() para transitar facilmente entre os radianos que o mecanismo matemático usa e os graus que as pessoas entendem.

Prática