inet_ntop
(PHP 5 >= 5.1.0)
inet_ntop — Converts a packed internet address to a human readable representation
Description
string inet_ntop
( string
$in_addr
)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.
Parameters
-
in_addr -
A 32bit IPv4, or 128bit IPv6 address.
Return Values
Returns a string representation of the address or FALSE on failure.
Examples
Example #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;
?>
Changelog
| Version | Description |
|---|---|
| 5.3.0 | This function is now available on Windows platforms. |
See Also
- long2ip() - Converts an (IPv4) Internet network address into a string in Internet standard dotted format
- ip2long() - Converts a string containing an (IPv4) Internet Protocol dotted address into a proper address
- inet_pton() - Converts a human readable IP address to its packed in_addr representation
- 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 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.