ip2long
Manual de PHP
AnteriorSiguiente

ip2long

(PHP 4, PHP 5)

ip2long --  Convierte una cadena que contiene una direcci贸n con puntos del Protocolo de Internet (IPv4) en una direcci贸n apropiada

Descripci贸n

int ip2long ( string direccion_ip )

La funci贸n ip2long() genera una direcci贸n de red Internet IPv4 desde su representaci贸n en formato est谩ndar de Internet (cadena con puntos). Si direccion_ip es inv谩lida, entonces se devuelve -1. Note que -1 no eval煤a a FALSE en PHP.

Nota: A partir de PHP 5.0.0, ip2long() devuelve FALSE cuando ip_address es inv谩lido.

Ejemplo 1. Ejemplo de ip2long()

<?php
$ip = gethostbyname('www.example.com');
$salida = "Las siguientes URLs son equivalentes:<br />\n";
$salida .= 'http://www.example.com/, http://' . $ip . '/, y http://' . sprintf("%u", ip2long($ip)) . "/<br />\n";
echo $salida;
?>

Nota: Ya que el tipo entero de PHP tiene signo, y muchas direcciones IP resultar谩n en enteros negativos, necesita usar el especificador de formato "%u" de sprintf() o printf() para obtener la representaci贸n de cadena de la direcci贸n IP sin signo.

Este segundo ejemplo muestra c贸mo imprimir una direcci贸n convertida con la funci贸n printf() tanto en PHP 4 como en PHP 5:

Ejemplo 2. Desplegar una direcci贸n IP (PHP 4)

<?php
$ip   = gethostbyname('www.example.com');
$long = ip2long($ip);

if ($long == -1 || $long === FALSE) {
    echo 'IP inv&aacute;lida, por favor intente de nuevo';
} else {
    echo $ip   . "\n";           // 192.0.34.166
    echo $long . "\n";           // -1073732954
    printf("%u\n", ip2long($ip)); // 3221234342
}
?>

ip2long() no deber铆a usarse como la 煤nica forma de validaci贸n de IP. Comb铆nela con long2ip():

Ejemplo 3. Validaci贸n de IP

<?php
// asegurarse de que las IP son validas. tambien convierte una IP
// no-completa en un cuarteto debidamente separado con puntos, como
// se explica mas adelante.
$ip = long2ip(ip2long("127.0.0.1")); // "127.0.0.1"
$ip = long2ip(ip2long("10.0.0")); // "10.0.0.0"
$ip = long2ip(ip2long("10.0.256")); // "10.0.1.0"
?>

ip2long() trabajar谩 tambi茅n con direcciones IP no-completas. Lea http://publibn.boulder.ibm.com/doc_link/en_US/a_doc_lib/libs/commtrf2/inet_addr.htm para m谩s informaci贸n.

Nota: ip2long() devolver谩 FALSE para la IP 255.255.255.255 en PHP 5 <= 5.0.2. Fue corregido en PHP 5.0.3 cuando devolv铆a -1 (al igual que en PHP 4).

Vea tambi茅n long2ip() y sprintf().

AnteriorInicioSiguiente
inet_ptonSubirlong2ip