cos()

La función cos() en PHP devuelve el coseno de un ángulo. Es una de las funciones trigonométricas incorporadas de PHP y resulta esencial cuando se trabaja con ángulos, ondas, rotaciones o geometría. Esta página cubre la sintaxis, el requisito fundamental de usar radianes, el rango de valores de retorno, ejemplos prácticos y los errores más comunes.

Sintaxis

cos(float $num): float

• $num — el ángulo, expresado en radianes (no en grados).
• Valor de retorno — el coseno de $num, siempre un float en el rango -1 a 1 inclusive.

Radianes, no grados

Este es el error más frecuente con cos(). PHP espera el ángulo en radianes, mientras que habitualmente pensamos en grados. Pasar cos(45) no devuelve el coseno de 45 grados — trata 45 como 45 radianes y retorna algo inesperado.

Para convertir grados a radianes, usa deg2rad(). La relación es:

radians = degrees × (π / 180)

Ejemplo básico

Aquí partimos de 45 grados, los convertimos a radianes con deg2rad() y luego pasamos el resultado a cos(). La salida es aproximadamente 0.70710678118655 — es decir, √2 / 2, el coseno exacto de 45 grados.

Ángulos comunes

La tabla a continuación muestra los valores que devuelve cos() para algunos ángulos conocidos. Nota que cos(M_PI / 2) no retorna exactamente 0: devuelve un número muy pequeño como 6.1232339957368E-17. Esto es normal en el redondeo de punto flotante — π no puede representarse de forma exacta, por lo que el resultado es "muy cercano a cero" en lugar de un cero limpio.

<?php
echo cos(0), "\n";              // 1
echo cos(M_PI), "\n";           // -1
echo cos(M_PI / 2), "\n";       // 6.1232339957368E-17 (≈ 0)
echo cos(deg2rad(60)), "\n";    // 0.5
?>

M_PI es una constante incorporada de PHP para el valor de π. Consulta pi() para la forma como función.

¿Cuándo se usa cos()?

cos() aparece mucho más allá del aula de matemáticas:

• Gráficos y videojuegos — rotar un punto alrededor de un origen o distribuir elementos de forma uniforme a lo largo de un círculo.
• Animación — generar movimiento suave y cíclico (un valor que oscila entre -1 y 1).
• Física y procesamiento de señales — modelar ondas y comportamientos periódicos.

Colocar puntos alrededor de un círculo

Un uso práctico del coseno es calcular la coordenada X de un punto en un círculo de un radio dado:

<?php
$radius = 100;

for ($deg = 0; $deg < 360; $deg += 90) {
    $x = $radius * cos(deg2rad($deg));
    echo "At {$deg}°, x = " . round($x, 2) . "\n";
}
?>

Esto imprime 100, 0, -100 y 0 (las posiciones X en 0°, 90°, 180° y 270°), siendo los valores de 90° y 270° efectivamente cero salvo por pequeños errores de punto flotante.

Funciones relacionadas

• sin() — el seno de un ángulo.
• tan() — la tangente de un ángulo.
• acos() — la inversa: dado un coseno, devuelve el ángulo.
• deg2rad() — convierte grados a radianes antes de llamar a cos().

Conclusión

cos() devuelve el coseno de un ángulo dado en radianes, produciendo siempre un float entre -1 y 1. Lo más importante a recordar es convertir los grados con deg2rad() primero, y esperar pequeños residuos de punto flotante en lugar de ceros exactos para ángulos como 90°. Con eso en mente, cos() es un bloque de construcción fiable para gráficos, animaciones y cualquier cálculo periódico o geométrico.

Práctica