inet_ntop
(PHP 5 >= 5.1.0, PHP 7)
inet_ntop — Конвертирует упакованный интернет адрес в читаемый формат
Описание
string inet_ntop
( string
$in_addr
)Эта функция конвертирует 32-битный IPv4 или 128-битный IPv6 адрес (если PHP был собран с поддержкой IPv6) в соответствующее строковое представление адреса.
Список параметров
-
in_addr
-
32-битный IPv4, или 128-битный IPv6 адрес.
Возвращаемые значения
Возвращает строковое представление адреса или FALSE
в случае возникновения ошибки.
Примеры
Пример #1 Пример использования inet_ntop()
<?php
$packed = chr(127) . chr(0) . chr(0) . chr(1);
$expanded = inet_ntop($packed);
/* Выведет: 127.0.0.1 */
echo $expanded;
$packed = str_repeat(chr(0), 15) . chr(1);
$expanded = inet_ntop($packed);
/* Выведет: ::1 */
echo $expanded;
?>
Список изменений
Версия | Описание |
---|---|
5.3.0 | Эта функция стала доступна на платформах Windows. |
Смотрите также
- long2ip() - Конвертирует (IPv4) адрес Интернет сети в стандартную строку с точками
- ip2long() - Конвертирует строку, содержащую (IPv4) Интернет адрес с точками в допустимый адрес
- inet_pton() - Конвертирует читаемый IP адрес в упакованное in_addr представление
- checkdnsrr
- closelog
- define_syslog_variables
- dns_check_record
- dns_get_mx
- dns_get_record
- fsockopen
- gethostbyaddr
- gethostbyname
- gethostbynamel
- gethostname
- getmxrr
- getprotobyname
- getprotobynumber
- getservbyname
- getservbyport
- header_register_callback
- header_remove
- header
- headers_list
- headers_sent
- http_response_code
- inet_ntop
- inet_pton
- ip2long
- long2ip
- openlog
- pfsockopen
- setcookie
- setrawcookie
- socket_get_status
- socket_set_blocking
- socket_set_timeout
- syslog
Коментарии
For people who need this function but don't have it, I could write a function which should give almost the same result.
<?php
function my_inet_ntop($ip) {
if (strlen($ip)==4) {
// ipv4
list(,$ip)=unpack('N',$ip);
$ip=long2ip($ip);
} elseif(strlen($ip)==16) {
// ipv6
$ip=bin2hex($ip);
$ip=substr(chunk_split($ip,4,':'),0,-1);
$ip=explode(':',$ip);
$res='';
foreach($ip as $seg) {
while($seg{0}=='0') $seg=substr($seg,1);
if ($seg!='') {
$res.=($res==''?'':':').$seg;
} else {
if (strpos($res,'::')===false) {
if (substr($res,-1)==':') continue;
$res.=':';
continue;
}
$res.=($res==''?'':':').'0';
}
}
$ip=$res;
}
return $ip;
}
?>
I followed IPv6 reprenstation rules :
- A series of "0"s in a 16bit block can by represented by "0".
- A series of blocks containing only "0"s can be suppressed and represented by "::" (this can be done only once)
(source : http://www.ipv6style.jp/en/faq/latest.shtml#2003022112 )
Example:
<?php
$packed = str_repeat(chr(0), 15) . chr(1);
$expanded = my_inet_ntop($packed);
/* Outputs: ::1 */
echo $expanded;
?>
I checked in CVS (2005-04-25) and didn't find the inet_ntop function (I really needed to handle IPv6) so I implemented it myself !
For people who wondering what the meaning of this function name:
pton: a presentation(printable) format address to network address
ntop: a network address to presentation(printable) format address
PHP's inet_ntop function is not compatible with the binary representation used by MySQL's INET6_ATON function, assuming you are using the recommended method of storing both IPv4 and IPv6 addresses in a VARBINARY(16) field. You need to convert it like this:
/**
* Convert a MySQL binary v4 (4-byte) or v6 (16-byte) IP address to a printable string.
* @param string $ip A binary string containing an IP address, as returned from MySQL's INET6_ATON function
* @return string Empty if not valid.
*/
function inet6_ntop($ip) {
$l = strlen($ip);
if ($l == 4 or $l == 16) {
return inet_ntop(pack('A' . $l, $ip));
}
return '';
}
You don't need a function going the other way because MySQL's INET6_NTOA is already compatible with PHP's inet_pton function.