PHP Conference Nagoya 2025

inet_ntop

(PHP 5 >= 5.1.0, PHP 7, PHP 8)

inet_ntopConverts a packed internet address to a human readable representation

说明

inet_ntop(string $ip): string|false

This function converts a 32bit IPv4, or 128bit IPv6 address (if PHP was built with IPv6 support enabled) into an address family appropriate string representation.

参数

ip

A 32bit IPv4, or 128bit IPv6 address.

返回值

Returns a string representation of the address 或者在失败时返回 false.

示例

示例 #1 inet_ntop() Example

<?php
$packed
= chr(127) . chr(0) . chr(0) . chr(1);
$expanded = inet_ntop($packed);

/* Outputs: 127.0.0.1 */
echo $expanded;

$packed = str_repeat(chr(0), 15) . chr(1);
$expanded = inet_ntop($packed);

/* Outputs: ::1 */
echo $expanded;
?>

参见

  • long2ip() - 将长整型转化为字符串形式带点的互联网标准格式地址(IPV4)
  • ip2long() - 将 IPV4 的字符串互联网协议转换成长整型数字
  • inet_pton() - Converts a human readable IP address to its packed in_addr representation

添加备注

用户贡献的备注 2 notes

up
52
ryansun81 at gmail dot com
14 years ago
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
up
6
marcus at synchromedia dot co dot uk
9 years ago
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.
To Top