rad2deg()

La fonction PHP rad2deg() convertit un angle mesuré en radians en l'angle équivalent en degrés. Elle est l'inverse exact de deg2rad() et s'avère très pratique lorsqu'une fonction mathématique renvoie un résultat en radians mais que vous avez besoin d'une valeur lisible en degrés.

Que sont les radians et les degrés ?

Les radians et les degrés mesurent tous deux des angles — ce sont simplement deux unités différentes, comme les mètres et les pieds.

• Un cercle complet vaut 360 degrés, soit 2π radians.
• Cela signifie que 1 radian est égal à 180/π degrés, soit environ 57,29578 degrés.

Les fonctions trigonométriques intégrées de PHP (sin(), cos(), atan(), …) fonctionnent toutes en radians, donc rad2deg() est le pont qui transforme ces résultats en degrés plus facilement compréhensibles.

Syntaxe

rad2deg(float $num): float

• $num — l'angle en radians que vous souhaitez convertir.
• Valeur de retour — le même angle exprimé en degrés, sous forme de float.

Comment utiliser la fonction rad2deg()

Passez la valeur en radians et rad2deg() retourne l'angle en degrés :

Ici, 1.047 radians (proche de π/3) est converti en environ 60 degrés.

Valeurs de référence courantes

En utilisant la constante M_PI de PHP (la même valeur que celle renvoyée par pi()), les angles bien connus se convertissent comme suit :

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

Les deux fonctions sont des images miroir l'une de l'autre : convertir dans un sens puis dans l'autre ramène la valeur d'origine :

<?php
$degrees = 90;

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

echo $back;                     // 90
?>

Utilisez deg2rad() avant d'appeler une fonction trigonométrique, et rad2deg() après.

Exemple pratique : lire un angle depuis cos()

Les fonctions trigonométriques inverses renvoient des radians. Convertissez le résultat avec rad2deg() pour obtenir un angle lisible, et utilisez round() pour arrondir le float à virgule longue :

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

$degrees = rad2deg($radians);

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

Points importants à retenir

• rad2deg() renvoie toujours un float, même pour des résultats entiers comme 180. Utilisez round() ou number_format() pour afficher une valeur soignée.
• Elle ne change que l'unité, pas l'angle lui-même — rad2deg(M_PI) et M_PI décrivent la même direction.
• Passer une chaîne non numérique provoque une TypeError en PHP 8+ ; assurez-vous que l'argument est numérique.

Conclusion

rad2deg() est un petit assistant indispensable pour tout code PHP manipulant des angles. Associez-la à deg2rad(), aux fonctions trigonométriques et à pi() pour passer aisément des radians utilisés par le moteur mathématique aux degrés compris par les humains.

Pratique