1. OOPS PHP Libary 란 이 php libary 는 JSBoard Open Project 의 소산물로서 JSBoard 에서 사용되어진 유용한 함수들중 일반적으로 널리 사용할수 있는 함수들을 따로 골라서 소스의 재사용을 할수 있도록 하기 위해 이 루어진 프로젝트 이다. 2. 사용환경 apache web server 와 php-4.0.3 이상이 연동되어 있어야 하며 httpd.conf 의 php4 설정중 AddType application/x-httpd-php .php .php3 .phtml .ph .ins 에서 위와 같이 .ph 가 등록이 되어 있어야 한다. 또한 php.ini에서 다음이 설정되어 있어야 한다. include_path = "/usr/lib/php/include" 3. 목차 function_check.ph : 체크에 관련된 함수 check_email_lib() check_meta_char_lib() check_url_lib() is_alpha_lib() is_hangul_lib() function_get.ph : 어떠한 값을 얻어 오는 함수 file_operate_lib() get_agent_lib() get_file_lib() get_filetype_lib() get_html_src_lib() get_hostname_lib() get_microtime_lib() human_fsize_lib() function_parse.ph : 문자열을 파싱하는데 관련된 함수 cut_string_lib() auto_link_lib() unhtmlspecialchars_lib() function_print.ph : 어떠한 문자열을 출력하는 함수 move_page_lib() print_error_lib() print_notice_lib() function_mail.ph : 메일발송을 위한 함수 sendmail_lib() 4. 체크 관련 함수 (function_check.ph) check_email_lib() : email 이 정확한지 체크 check_meta_char_lib() : cracking 에 위험한 메타문자들을 체크 check_url_lib() : url 이 정확한지 체크 is_alpha_lib() : 문장에 영어가 들어 있는지를 체크 is_hangul_lib() : 문장에 한글이 들어 있는지를 체크 check_email_lib() 작성 김병찬 <http://linux.sarang.net> 문법 check_email_lib(email) 설명 E-MAIL 주소가 정확한 것인지 검사하는 함수. email 주소가 맞으면 email 주소를 리턴하고 틀리면 null 값을 리턴한다. check_meta_char_lib() 작성 김정균 <http://www.oops.org> 문법 check_meta_char_lib(string,message) 설명 주로 경로명이나 변수를 넘겨 줄때 불법적인 접근을 막기 위해 사용을 한다. 문자열에 메타 캐릭터 가 존재할 경우 2번째 인자에 지정한 메세지를 출력하고 이전 화면으로 돌아가게 된다. 이 함수에서 걸리는 문자는 한글,알파벳, _, -, . 문자를 제외하고는 모두 에러메세지가 출력된다. dot(.) 는 허용이 되지만 연속된 dot 문자 (..) 는 에러 메세지가 출력이 된다. 예제 $s = "asdf..asdf"; check_meta_char_lib($s,"사용할수 없는 문자가 들어 있습니다"); check_url_lib() 작성 김병찬 <http://linux.sarang.net> 문법 check_url_lib(url) 설명 url 이 정확한 것인지 검사하는 함수. url 이 맞으면 url을 리턴하고 틀리면 null 값을 리턴한다. is_alpha_lib() 작성 김병찬 <http://linux.sarang.net> 문법 is_alpha_lib(string) 설명 이 함수에 들어온 문자열에 알파벳이 존재 하는지, 그리고 또 대문자 (0x41 - 0x5a) 또는 소문자 (0x61 - 0x7a) 의 존재 여부를 체크한다. 대문자가 존재하면 2를 반환하고 소문자가 존재하면 1 을 반환한다. is_hangul_lib() 작성 김병찬 <http://linux.sarang.net> 문법 is_hangul_lib(string) 설명 이 함수에 들어온 문자열에 한글의 범위 내 (0xA1A1 - 0xFEFE) 에 들어 있는 문자가 존재 하는지를 테스트하여 존재하면 1을 반환한다. 없으면 0을 반환한다. 5. 어떠한 값을 구하는 함수 (function_get.ph) file_operate_lib() : 파일 읽기, 쓰기, 파일 끝부터 쓰기를 제어 get_agent_lib() : 접속자의 브라우져 유형을 구함 get_file_lib() : 파일의 내용을 변수도 받음 get_filetype_lib() : 파일의 확장자를 구함 get_html_src_lib() : 특정 페이지의 html source 를 변수로 만듬 get_hostname_lib() : 접속자의 ip 주소나 hostname 을 구함 get_microtime_lib() : 어떠한 실행 시간을 micro time 으로 구함 human_fsize_lib() : 용량을 byte, kbyte, mbyte, gbyte 별로 자동으로 변환 file_operate_lib() 작성 김정균 <http://www.oops.org> 문법 file_operate_lib(path,mode,msg,string,size) 설명 file_operate_lib() 함수는 파일에 대한 여러가지 작업을 복합적으로 제어할 수 있도록 한다. 각각 의 파라미터들은 다음의 의미한다. path -> 파일 경로 mode -> 파일 작동 모드(r-읽기,w-쓰기,a-파일끝부터 쓰기) msg -> 실패시 에러 메세지 string -> 쓰기모드에서는 쓸내용 size -> 읽기모드에서 사이즈 만큼 받을 것인지 아니면 배열로 파일 전체를 받을 것인지 결정 1 으로 지정을 하면 해당 파일을 한줄씩 배열로 전체를 받으며, 0으로 지정을 하면 파일 사이즈 만큼의 내용을 하나의 변수로 받음. string 의 경우에는 읽기 모드에서는 아무런 영향을 미치지 않으며, size 역시 쓰기 모드에서는 아 무런 영향을 미치지 않는다. 예제 [파일 내용] : /path/a.txt abcdefghijklmnopqrstuvwxyz 가나다라마바사아차카타파하 [ 읽기모드 ] $path = /path/a.txt 파일전체를 배열로 읽어올때. $txt = file_operate_lib($path,"r","Can't open $path",0,1); for($i=0;$i<$count($i);$i++) { echo $txt[$i]."\n"; } 파일을 10 byte 만 읽어올 때 $txt = file_operate_lib($path,"r","Can't open $path",0,0); echo $txt; [ 쓰기모드 ] 새로운 파일을 쓰거나 또는 기존의 파일을 덮어씌울 때 file_operate_lib($path,"w","Can't write $path",&qout;$string"); 기존의 파일의 끝에 덧붙일 경우 file_operate_lib($path,"a","Can't write $path",&qout;$string"); get_agent_lib() 작성 김병찬 <http://linux.sarang.net> 작성 김정균 <http://www.oops.org> 문법 get_agent_lib() 설명 get_agent_lib() 함수는 접속하는 유저의 브라우져의 정보를 배열값으로 구하게 된다. 구할수 있는 브라우져의 정보는 다음과 같다. [br] 브라우져 종류 MSIE : Internet Explorere 각 버젼은 [vr] 로 구분을 함 MOZL : Netscape 3.x, 4.x 6.x mozilla 각 버젼은 [vr] 로 구분을 함 OTHER : 위의 브라우져 외의 것들 [os] 운영체제 WIN : Windows 9x NT(2000) : Windows NT or Windows 2000 LINUX : Linux OTHER : 위의것 외의 OS [ln] 언어 (netscape, mozila) KO : 한국어판. 결과값이 없을 경우에는 영문판으로 간주. [vr] 브라우져 버젼 정보 IE 의 경우에는 정확하나 그 이외의 브라우져에서는 정상 작동 확인 못함. IE 의 경우 5.5 버젼의 차이 때문에 구분 필요함. Mozilla 나 Netscape 6 의 경우 [vr] 값 6 으로 체크를 할 수 있음. 예제 $a = get_agent_lib(); echo "browser : $a[br]\n". "os : $a[os]\n". "lang : $a[lang]\n". "version : $a[vr]\n"; 위의 결과는 Windows 2000 의 IE5.x 에서 접속했을 경우 browser : MSIE os : NT4.0 lang : version : 6.0 과 같이 출력 된다. get_file_lib() 작성 김정균 <http://www.oops.org> 문법 get_file_lib(path,size) 설명 특정 파일의 내용을 변수로 받아 들인다. path 는 변수로 받을 파일의 경로를 지정하며 size 를 지 정할 경우 해당 파일의 처음 부터 지정한 크기 만큼만 받으며 지정하지 않을 경우에는 해당파일 전 체를 받는다. 예제 $path = "./doc/example.txt"; $text = get_file_lib($path,250); get_filetype_lib() 작성 이진우 <jinoos@hanmail.net> 작성 김정균 <http://www.oops.org> 문법 get_filetype_lib(파일이름) 설명 이 함수에 파일 이름을 통과 시킬 경우 해당 파일의 확장자를 변수로 받는다. 예제 $a = get_filetype_lib("aaa.txt"); echo $a => txt get_html_src_lib() 작성 김정균 <http://www.oops.org> 문법 get_html_src_lib(DOMAIN,SIZE,URI,TYPE) 설명 원하는 외부의 html page 의 소스를 변수로 받는 함수이다. 이 함수는 html 1.1을 지원하므로 가상 호스트로 이루어진 홈페이지의 파일 역시 받아 올수 있다. DOMAIN : url중 도메인 부분만 의미한다. 예를들어 http://domain.com/aaa/bbb.html 이라면 DOMAIN 은 domain.com 만을 의미한다. http:// 역시 생략한다. SIZE : 해당 페이지에서 원하는 만큼의 byte 만 받는다. URI : url 중 domain 을 제외한 나머지 경로를 의미한다. http://domain.com/aaa/bbb.html 에서 는 /aaa/bbb.html 이 URI 가 된다. TYPE : socket 방식으로 접근을 할지 fopen 방식으로 접근을 할지를 결정한다. 1 또는 0 의 값을 가진다. 예제 $a = get_html_src_lib("oops.org",20000,"/index.html",1); get_hostname_lib() 작성 김정균 <http://www.oops.org> 작성 김병찬 <http://linux.sarang.net> 문법 get_hostname_lib(REVERSE,IP_ADDR) 설명 reverse 는 ip address 의 hostname 을 찾을것인지 여부를 결정한다. 값은 0 과 1 로 지정을 한다. 0 은 hostname 을 찾지않으며, 1 은 hostname 을 검색을 하게 된다. IP_ADDR 은 REVERSE 의 값이 1 일때만 지정을 한다. 0 일 경우에는 지정할 필요가 없다. IP_ADDR 을 지정할 경우는 이 함수의 외부에서 이미 ip address 를 구해 놓았고 이 ip address 의 hostname 을 검색하고 싶을 경우에 사용을 한다.(예제1) IP_ADDR 을 지정 하지 않을 경우에는 이 함수 자체에서 IP address 를 구해야 할 경우에 사용을 한 다.(예제2) 예제1 $a = "111.111.111.111"; $b = get_hostname_lib(1,$a); echo "$a 의 hostname 은 $b 입니다."; 위의 결과값은 111.111.111.111 의 hostname 은 domain.com 입니다. 또는 111.111.111.111 의 hostname 은 111.111.111.111 입니다. 의 결과를 보이게 된다. 이는 hostname lookup 성공과 실패여부에 따라 출력되는 결과가 다르기 때 문이다. get_hostname_lib(0,$a) 는 아무 의미가 없다. 이미 ip address 가 구해져 있는데 REVERSE 를 0 으 로 지정하면 ip address 값을 구하겠다는 것이 되므로 하나마나한 결과를 나오게 된다. 예제2 $a = get_hostname_lib(0); echo $a; 위의 결과값은 111.111.111.111 을 가지게 된다. $a = get_hostname_lib(1); echo $a; 위의 결과값은 111.111.111.111 또는 domain.com 을 가지게 된다. get_microtime_lib() 작성 김병찬 <http://linux.sarang.net> 문법 get_microtime_lib(시작시간,끝난시간) 설명 php 의 microtime 을 이용하여 얻어지는 값을 비교하여 경과 시간을 밀리초로 구하는 함수 예제 $time1 = microtime(); ...... 어떠한 루틴 ...... $time2 = microtime(); $time = get_microtime_lib($time1,$time2); echo "$time sec" 위의 결과는 2.75 sec 와 같이 출력이 된다. human_fsize_lib() 작성 김칠봉 <http://linuxchannel.net> 문법 human_fsize_lib(BYTE_VALUE,SUB) 설명 byte 의 값을 이함수를 거쳐 byte, kbyte, mbyte 로 자동으로 표현을 해 준다. SUB 의 값은 1 과 0 을 가지며 1 일 경우에는 변환된 값 뒤에 원 byte 값을 표시를 해 준다. 예제 $a = human_fsize_lib(1024); echo $a => 1K $a = human_fsize_lib(1024,1); echo $a => 1K (1024 Bytes) 6. 문자열을 파싱하는데 관련된 함수 (function_parse.ph) cut_string_lib() : 문자열을 원하는 글자로 자름 auto_link_lib() : 문자열중 url 및 email 을 자동으로 링크 unhtmlspecialchars_lib() : html 특수 문자를 일반 문자로 변환. htmlspecialcars() 함수의 역함수 cut_string_lib() 작성 벌레잡이(?) <jdy@lgic.co.kr> 문법 cut_string_lib(string,자를문자열수) 설명 문자열을 일정한 길이로 자른다. 한글의 경우 2 byte 문자이기 때문에 마지막 글자가 깨질 위험이 있으므로 이를 자동으로 처리를 하여주며, 대문자가 많이사용된 경우에는 소문자와의 크기 비율 정 도(1.5)에 따라 문자열을 자른다. $str = cut_string_lib($str,80); auto_link_lib() 작성 김정균 <http://www.oops.org> 문법 auto_link_lib(string) 설명 문자열에 들어 있는 url 과 email 주로를 자동으로 hyper link 를 만든다. 예제 $str = auto_link_lib($str); unhtmlspecialchars_lib() 작성 김정균 <http://www.oops.org> 문법 unhtmlspecialchars_lib(string) 설명 htmlspecialchars 함수의 역함수이다. 문자열을 이함수에 걸르게 되면 html 문자열로 되어 있는 문 자열을 일반 특수 문자로 변환해 준다. 예제 $str = "&quot;DJ 가 안했다&quot; &lt;&lt; 테스트에요"; $str = unhtmlspecialchars_lib($str); echo $str; 의 결과는 "DJ 가 안했다" << 테스트에요 와 같이 &quot; 와 &lt; 를 일반 특수 문자로 변환을 시킨다. 7. 어떠한 문자열을 출력하는 함수 (function_print.ph) move_page_lib() : 원하는 페이지로 이동 print_error_lib() : error message 를 출력 print_notice_lib() : 경고 메세지를 출력 move_page_lib() 작성 김정균 <http://www.oops.org> 문법 move_page_lib(경로,시간) 설명 원하는 페이지로 지정한 시간 이후에 reflesh 한 상태로 이동을 시켜준다. 예제 move_page_lib("http://www.oops.org",30); print_error_lib() 작성 김정균 <http://www.oops.org> 문법 print_error_lib(string) 설명 에러 메세지를 출력하고 이전 화면으로 돌아간다. 예제 if(!$string) print_error_lib("문자열이 비었습니다."); print_notice_lib() 작성 김정균 <http://www.oops.org> 문법 print_notice_lib(string) 설명 지정한 문자열을 JAVA script ALERT (경고) 으로 출력을 하고 다음을 진행한다. print_error 와의 차이는 print_error 는 에러메세지를 출력하고 이전화면으로 전환되는 것에 비해 print_notice 는 메세지를 출력하고 그 다음을 진행하게 된다. 예제 print_notice_lib("경고 예제 입니다.") echo "이 메세지가 보여야 합니다."; 8. 메일발송을 위한 함수 (function_mail.ph) sendmail_lib() : 소켓타입 또는 php mail() 함수를 사용하여 메일을 발송함 sendmail_lib() 작성 김정균 <http://www.oops.org> 문법 sendmail_lib(array) 설명 sendmail_lib() 함수는 소켓방식 또는 php 의 mail() 함수를 이용하여 메일을 발송한 다. sendmail_lib() 함수는 메일을 발송하기 위해서는, 배열로 필요한 값들을 넘겨주 어야 한다. sendamil_lib() 로 메일을 발송하기 위한 파라미터들은 다음과 같다. ln -> 언어 타입 (ko, en 등) ko 로 지정을 하면 한글 characterset 을 사용할 수 있다. 기본값은 en 이다. smtp -> 메일 발송을 php 의 mail() 함수가 아니라 직접 소켓으로 접속 하여 메일을 발송하고 싶을 경우 relay 가 허용이 된 smtp 의 주소를 적도록 한다. 이값 을 지정하지 않으면 php 의 mail() 함수를 이용해서 발송을 한다. ctype -> 발송할 메일의 content type 을 지정한다. html 방식으로 메일을 발송 하려 면 text/html 로 지정을 한다. 기본값은 text/plain 이다. from -> 메일을 보내는 사람의 주소 to -> 메일을 받을 사람의 주소 title -> 메일 제목 text -> 메일 본문 ln, smtp, ctype 은 선택이며, {from, to, title, text} 는 필수로 지정을 해줘야 한 다. 예제 [ php 의 mail() 함수방식 ] $arraymail[ln] = "ko"; $arraymail[ctype] = "text/plain"; $arraymail[from] = "from@from.com"; $arraymail[to] = "to@to.com"; $arraymail[title] = "html type mail test"; $arraymail[text] = "test 중이랍니다.\n"; sendmail($arraymail); [ 소켓으로 메일을 발송하는 방식 ] $arraymail[ln] = "ko"; $arraymail[smtp] = "127.0.0.1"; $arraymail[ctype] = "text/html"; $arraymail[from] = "from@from.com"; $arraymail[to] = "to@to.com"; $arraymail[title] = "html type mail test"; $arraymail[text] = "<HTML>\n". "<BODY>\n". "<TABLE width=100% height=700 border=0>\n". "<TR><TD align=center valign=center>\n". "test 중이랍니다.\n". "</TD></TR>\n". "</TABLE>\n". "</BODY>\n". "</HTML>\n"; sendmail($arraymail); 9. 저작권 OOPS PHP Libary 는 GPL 2 를 따른다. JSBoard 의 License 가 GPL2 를 따르기 때문에 당연히 OOPS PHP Libary 역시 JSBoard 의 License 에 귀속이 된다.