rad2deg()

La función rad2deg() de PHP convierte un ángulo medido en radianes al ángulo equivalente en grados. Es la inversa exacta de deg2rad(), y resulta muy útil cuando una función matemática devuelve un resultado en radianes pero necesitas un valor legible en grados.

¿Qué son los radianes y los grados?

Tanto los radianes como los grados miden ángulos — simplemente son dos unidades diferentes, como metros y pies.

• Un círculo completo equivale a 360 grados, o 2π radianes.
• Eso significa que 1 radián equivale a 180/π grados, es decir, aproximadamente 57.29578 grados.

Las funciones trigonométricas incorporadas de PHP (sin(), cos(), atan(), …) trabajan todas en radianes, por lo que rad2deg() es el puente que convierte esos resultados de vuelta a grados que la mayoría de las personas puede leer.

Sintaxis

rad2deg(float $num): float

• $num — el ángulo en radianes que deseas convertir.
• Valor de retorno — el mismo ángulo expresado en grados, como un float.

Cómo usar la función rad2deg()

Pasa el valor en radianes y rad2deg() devuelve el ángulo en grados:

Aquí 1.047 radianes (cercano a π/3) se convierte a aproximadamente 60 grados.

Valores de referencia comunes

Usando la constante M_PI de PHP (el mismo valor que devuelve pi()), los ángulos conocidos se convierten así:

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

Las dos funciones son imágenes especulares la una de la otra, de modo que convertir en un sentido y volver al otro devuelve el valor original:

<?php
$degrees = 90;

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

echo $back;                     // 90
?>

Usa deg2rad() antes de llamar a una función trigonométrica, y rad2deg() después de una.

Ejemplo práctico: leer un ángulo desde cos()

Las funciones trigonométricas inversas devuelven radianes. Convierte el resultado con rad2deg() para obtener un ángulo legible, y usa round() para recortar el float largo:

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

$degrees = rad2deg($radians);

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

Cosas a tener en cuenta

• rad2deg() siempre devuelve un float, incluso para resultados de número entero como 180. Usa round() o number_format() cuando necesites un valor de visualización limpio.
• Solo cambia la unidad, no el ángulo en sí — rad2deg(M_PI) y M_PI describen la misma dirección.
• Pasar una cadena no numérica genera un TypeError en PHP 8+; asegúrate de que el argumento sea numérico.

Conclusión

rad2deg() es un ayudante pequeño pero esencial para cualquier código PHP que trabaje con ángulos. Combínalo con deg2rad(), las funciones trigonométricas y pi() para moverte cómodamente entre los radianes que usa el motor matemático y los grados que entienden las personas.

Práctica