HOWTO · PHP
Obtener la dirección IP del usuario en PHP
Este tutorial demuestra cómo obtener la dirección IP del usuario en PHP
En esta página
Para leer la dirección de red asociada a una solicitud PHP, empiece con $_SERVER['REMOTE_ADDR']. Esta identifica al par que se conectó al servidor web. Si hay un proxy inverso delante de la aplicación, ese par puede ser el proxy y no el visitante. Las cabeceras de solicitud relacionadas con proxies solo se pueden usar cuando la aplicación tiene una configuración explícita de confianza para el proxy que las proporciona y valida.
Leer la dirección de conexión con $_SERVER['REMOTE_ADDR']
$_SERVER es una superglobal de PHP que contiene información del servidor y de la solicitud. Su elemento REMOTE_ADDR contiene la dirección del par conectado al servidor que gestiona la solicitud. En una conexión directa, normalmente será el cliente que se conecta. Detrás de un balanceador de carga o un proxy inverso, por lo general será la dirección del proxy. La configuración del servidor web y del proxy determina qué recibe PHP, por lo que no se debe describir este valor como una dirección garantizada del usuario final.
En una solicitud local, el par puede ser la dirección IPv6 de bucle invertido ::1. Las direcciones de bucle invertido hacen referencia a la máquina local; ::1 es la dirección IPv6 de bucle invertido, equivalente a 127.0.0.1 en IPv4. El valor exacto depende del servidor local y de la conexión. Consulte esta explicación sobre las direcciones de bucle invertido.
El siguiente ejemplo ejecutable asigna un valor representativo del servidor para que la consulta sea autónoma. Mantiene display_output en false, por lo que realiza la consulta sin mostrar nada; en una aplicación, use el valor según las necesidades de respuesta o registro. El texto literal del ejemplo permanece en inglés.
<?php
$_SERVER['REMOTE_ADDR'] = '::1';
$peerAddress = $_SERVER['REMOTE_ADDR'];
$display_output = false;
if ($display_output) {
echo "The connected peer is: " . $peerAddress . PHP_EOL;
}
?>
En una solicitud real, use el valor $_SERVER['REMOTE_ADDR'] proporcionado por el servidor en lugar de asignar un valor de muestra. La referencia de variables del servidor del Manual de PHP describe las entradas disponibles de $_SERVER.
Interpretar las cabeceras del proxy solo cuando se confía en él
PHP puede exponer las cabeceras de solicitud como entradas de $_SERVER, por ejemplo, HTTP_X_FORWARDED_FOR y HTTP_CLIENT_IP. Que estén presentes no demuestra que contengan la dirección del visitante: un cliente puede enviar sus propios valores de cabecera, y un proxy puede conservarlos, añadirles valores o reemplazarlos. En particular, HTTP_X_FORWARDED_FOR puede contener una cadena de direcciones separadas por comas, no una sola dirección. No elija el primer valor y lo considere la dirección real del cliente sin aplicar las reglas de confianza documentadas para su infraestructura.
Use un valor reenviado solo cuando el par de conexión coincida con un proxy en el que la aplicación confíe explícitamente y ese proxy esté configurado para eliminar o validar las cabeceras de reenvío enviadas por el cliente. La lista de proxies de confianza debe corresponder a su despliegue; no copie direcciones de ejemplo como configuración de producción. Si no se confía en el par, use REMOTE_ADDR. HTTP_CLIENT_IP presenta el mismo problema de confianza y no debe usarse como respuesta especial para conexiones compartidas a Internet.
Este fragmento ejecutable representa un despliegue en el que el proxy de confianza sobrescribe X-Forwarded-For con una dirección validada. Sustituya la dirección de muestra del proxy y la política de validación por los valores definidos para su infraestructura. Imprime la dirección reenviada seleccionada para estos valores representativos; no implementa el análisis de una cadena con varios proxies. Cualquier etiqueta textual del ejemplo permanece en inglés.
<?php
$_SERVER['REMOTE_ADDR'] = '192.0.2.10';
$_SERVER['HTTP_X_FORWARDED_FOR'] = '198.51.100.24';
$trustedProxies = ['192.0.2.10'];
$peerAddress = $_SERVER['REMOTE_ADDR'];
if (in_array($peerAddress, $trustedProxies, true)
&& isset($_SERVER['HTTP_X_FORWARDED_FOR'])
&& filter_var($_SERVER['HTTP_X_FORWARDED_FOR'], FILTER_VALIDATE_IP) !== false) {
$clientAddress = $_SERVER['HTTP_X_FORWARDED_FOR'];
} else {
$clientAddress = $peerAddress;
}
echo "Selected address: " . $clientAddress . PHP_EOL;
?>
Selected address: 198.51.100.24
La documentación de filter_var() explica la función de validación que se usa aquí. Validar que una cadena sea una dirección IP no demuestra que proceda de una fuente de confianza; esa decisión depende de comprobar el par y de la configuración del proxy. Si el proxy reenvía una cadena, use un framework o código revisado cuidadosamente que recorra la cadena según las reglas exactas de confianza para proxies de su despliegue.
Usar una expresión condicional como alternativa compacta
Un bloque legible if/elseif/else suele ser más fácil de auditar, sobre todo si incluye una comprobación de confianza del proxy. Una expresión condicional puede representar la misma elección de forma compacta, pero no vuelve segura una cabecera que no es de confianza. El siguiente ejemplo ejecutable comprueba si se confía en el proxy y aplica la misma política de una sola dirección sobrescrita descrita antes. Sus valores del servidor son representativos; imprime la dirección reenviada seleccionada. Las etiquetas textuales que aparecen en el ejemplo permanecen en inglés.
<?php
$_SERVER['REMOTE_ADDR'] = '192.0.2.10';
$_SERVER['HTTP_X_FORWARDED_FOR'] = '198.51.100.24';
$trustedProxies = ['192.0.2.10'];
$peerAddress = $_SERVER['REMOTE_ADDR'];
$forwardedAddress = $_SERVER['HTTP_X_FORWARDED_FOR'] ?? '';
$clientAddress = in_array($peerAddress, $trustedProxies, true)
&& filter_var($forwardedAddress, FILTER_VALIDATE_IP) !== false
? $forwardedAddress
: $peerAddress;
echo "Selected address: " . $clientAddress . PHP_EOL;
?>
Selected address: 198.51.100.24
El orden de la alternativa es deliberado: acepte la dirección reenviada validada solo cuando el par conectado esté en la lista de proxies de confianza; de lo contrario, conserve la dirección del par conectado. Los paréntesis pueden aclarar las expresiones condicionales anidadas, pero un ternario anidado es más difícil de mantener y no sustituye las comprobaciones de confianza. Mantenga alineados el comportamiento de las cabeceras del proxy y la lista de permitidos de la aplicación para que un cliente no pueda convertir su propia cabecera en una entrada de confianza.