File Source for ipcalc.php

<?php
/**
* Project: IPCALC :: IP calculator / subnetting<br>
* File: IPCALC.php
*
* 이 class는 IP 계산과 서브네팅을 지원한다.
*
* @category Networking
* @package IPCALC
* @author JoungKyun.Kim <http://oops.org>
* @copyright (c) 2018, JoungKyun.Kim
* @license LGPL
* @link http://pear.oops.org/package/ipcalc
* @since File available since release 0.0.1
* @example IPCALC/test.php Sample code of IPCLAC class
* @filesource
*/
/**
* import IPCALCLogic class
*/
require_once 'IPCALC/IPCALC.php';
/**
* IPCALC 의 frontend Class
* @package IPCALC
*/
class IPCALC extends IPCALCLogic
{
// {{{ (void) IPCALC::__construct (void)
/**
* Initialize IPCALC class
*
* @access public
* @return void
*/
function __construct () { }
// }}}
// {{{ (long) IPCALC::ip2long ($ip)
/**
* Dot로 구분된 IPv4 주소를 정수형 주소로 변환
*
* PHP의 ip2long API가 singed 형이기 때문에 음수의 값이 나올 수
* 있어, 이 API를 제공하여 항상 양수의 값이 나올 수 있도록 지원.
*
* {@example IPCALC/test.php 18 3}
*
* @access public
* @return long unsigned 형의 정수형 네트워크 주소
* @param string Dot로 구분된 IPv4 주소
*/
static function ip2long ($ip) {
return parent::ip2long ($ip);
}
// }}}
/**
* alias IPCALC::valid_ipv4_addr
*/
static function is_ipaddr ($ip) {
return parent::valid_ipv4_addr ($ip);
}
// {{{ (boolean) IPCALC::valid_ipv4_addr ($ip)
/**
* 인자로 주어진 값이 정상적인 IPv4 주소인지를 체크
*
* {@example IPCALC/test.php 24 2}
*
* @access public
* @return boolean 정상적인 IP일 경우 true, 그 외 false
* @param string Dot로 구분된 IPv4 주소
*/
static function valid_ipv4_addr ($ip) {
return parent::valid_ipv4_addr ($ip);
}
// }}}
// {{{ (string) IPCALC::prefix2mask ($prefix)
/**
* 네트워크 prefix를 네트워크 mask로 변환
*
* {@example IPCALC/test.php 29 2}
*
* @access public
* @return string 네트워크 mask
* @param integer 네트워크 prefix
*/
static function prefix2mask ($prefix) {
$r = parent::prefix2long ($prefix);
return long2ip ($r);
}
// }}}
// {{{ (int) IPCALC::mask2prefix ($mask)
/**
* 네트워크 mask를 네트워크 prefix로 변환
*
* {@example IPCALC/test.php 33 2}
*
* @access public
* @return int 네트워크 prefix
* @param string 네트워크 mask
*/
static function mask2prefix ($mask) {
$mask = ip2long ($mask);
return parent::long2prefix ($mask);
}
// }}}
// {{{ (string) IPCALC::network ($ip, $mask) {
/**
* 주어진 IPv4 주소와 네트워크 mask로 구성된 서브넷의 네트워크
* 주소를 반환
*
* {@example IPCALC/test.php 37 2}
*
* @access public
* @return string 해당 서브넷의 네트워크 주소
* @param string IPv4 주소
* @param string 네트워크 mask 또는 prefix
*/
static function network ($ip, $mask) {
$r = parent::network ($ip, $mask);
return long2ip ($r);
}
// }}}
// {{{ (string) IPCALC::broadcast ($ip, $mask)
/**
* 주어진 IPv4 주소와 네트워크 mask로 구성된 서브넷의 브로드캐스트
* 주소를 반환
*
* {@example IPCALC/test.php 41 2}
*
* @access public
* @return string 해당 서브넷의 브로드캐스트 주소
* @param string IPv4 주소 또는 long형 주소값
* @param string 네트워크 mask
*/
static function broadcast ($ip, $mask) {
$r = parent::broadcast ($ip, $mask);
return long2ip ($r);
}
// }}}
// {{{ (int) IPCALC::guess_prefix ($start, $end)
/**
* 시작 주소와 마지막 주소를 포함한 서브넷의 prefix를 반환
*
* {@example IPCALC/test.php 45 2}
*
* @access public
* @return int 네트워크 prefix
* @param string 범위의 시작 IPv4 주소
* @param string 범위의 마지막 IPv4 주소
*/
static function guess_prefix ($start, $end) {
return parent::guess_prefix ($start, $end);
}
// }}}
// {{{ (string) IPCALC::guess_netmask ($start, $end)
/**
* 시작 주소와 마지막 주소를 포함한 서브넷의 최소 mask를 반환
*
* {@example IPCALC/test.php 49 2}
*
* @access public
* @return string 네트워크 mask
* @param string 범위의 시작 IPv4 주소
* @param string 범위의 마지막 IPv4 주소
*/
static function guess_netmask ($start, $end) {
return parent::guess_netmask ($start, $end);
}
// }}}
// {{{ (binary) IPCALC::htonl ($v)
/**
* 4 Byte unsigned 정수를 host byte order에서 network byte
* order로 변환
*
* x86/x86_64 cpu에서는 little endian을 big endian으로 변환
* 하는 것과 동일 함
*
* @access public
* @return binary network byte order로 변환된 binary
* @param int 4 Byte 양수형 정수
*/
static function htonl ($v) {
return pack ('N', $v);
}
// }}}
// {{{ (long) IPCALC::ntohl ($v)
/**
* Network oerder byte로 구성된 4 Byte 정수 binary data를
* signed 정수로 변환
*
* x86/x86_64 cpu에서는 big endian을 little endian으로 변환
* 하는 것과 동일 함
*
* @access public
* @return long 4 Byte signed 정수
* @param binary Network byte order로 구성된 4Byte 정수 binary
*/
static function ntohl ($v) {
for ( $i=3; $i>=0; $i-- )
$v1 .= $v[$i];
$val = unpack ('ilittle', $v1);
return $val['little'];
}
// }}}
}
/*
* Local variables:
* tab-width: 4
* c-basic-offset: 4
* End:
* vim600: noet sw=4 ts=4 fdm=marker
* vim<600: noet sw=4 ts=4
*/
?>

Source for file ipcalc.php