ip2long

(PHP 4, PHP 5)

ip2long --  Pontozott IP címet tartalmazó karakterláncot valódi IP cimmé alakít

Leírás

int ip2long ( string ip_cím )

Az ip2long() függvény IPv4 formátumú IP címmé alakítja az ip_cím paraméterben megadott szabványos, pontozott formátumú IP-t. Az IP címek valójában ebben a 4 byteos egész szám formátumban tárolódnak. Ha az ip_cím paraméter nem helyes, a függvény értékeként -1-et kapunk vissza. Vigyázat, a -1-et a PHP nem tekinti FALSE értéknek.

Megjegyzés: A PHP 5.0.0 változattól kezdve az ip2long() FALSE értékkel tér vissza, ha a megadott ip_cím helytelenül lett megadva.

Példa 1. ip2long() példa

<?php
$ip
= gethostbyname('hu.php.net');
$out = "Az alábbi URL-ek egyenértékűek:<br />\n";
$out .= 'http://hu.php.net/, http://' . $ip . '/, és ';
$out .= 'http://' . sprintf('%u', ip2long($ip)) . "/<br />\n";
echo
$out;
?>

Megjegyzés: Mivel a PHP előjeles egésszám ábrázolást alkalmaz, és az IP címek negatív számokat eredményezhetnek ezáltal, szükséged lehet a sprintf() vagy printf() függvény "%u" formázó elemére. Ezáltal a megjelenített szám ábrázolása előjel nélküli lesz.

Eme második példa pedig azt mutatja meg, hogy a printf() segítségével hogy tudjuk ezt a lekonvertált címet kiíratni a php 4-es illetve 5-ös változataiban:

Példa 2. IP cím kiíratása

<?php
$ip
= gethostbyname("www.example.com");
$long = ip2long($ip);
if (
$long === -1 || $long === FALSE) {
    echo
'Helytelen IP cím, próbáld újra!';
} else {
    echo
$ip   . "\n";           // 192.0.34.166
    
echo $long . "\n";           // -1073732954
    
printf("%u\n", ip2long($ip)); // 3221234342
}
?>

Az ip2long() függvényt érdemes párban használni a long2ip() függvénnyel IP cím ellenőrzésre.

Példa 3. IP cím ellenőrzés

<?php
// legyünk biztosak benne, hogy az IP cím rendben van. Ráadásul
// még a nem teljes IP címeink is átalakulnak a megfelelő teljes
// pontozott alakká. Hogy hogyan, arról később lesz szó.
$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"
?>

Az ip2long() függvény képes nem teljes IP címekkel is dolgozni. További információk az http://publibn.boulder.ibm.com/doc_link/en_US/a_doc_lib/libs/commtrf2/inet_addr.htm oldalon olvashatók.

Megjegyzés: Az ip2long() függvény a 255.255.255.255 IP címre -1 (PHP 4) vagy FALSE (PHP 5) értéket fog visszaadni.

Lásd még: long2ip() és sprintf().