PEAR를 사용하여 다음 PHP 프로그램 작성

pear 소개: pear를 사용하여 다음 PHP 프로그램 작성

내용:

ｽｽaｒ는 무엇인가요
왜 ｐｽeaｒ를 사용해야 합니까?
배는 나에게 어떤 효능을 가져다 줄 수 있나요? Beijing Saidi Information Technology Co., Ltd.
2001년 6월
여러분은 이미 PHP의 베테랑이고 훌륭한 코드를 많이 작성했을 수도 있습니다. 그런데 지금 현재 프로젝트에 추가하고 싶다면 좀 어렵겠죠? 당신의 친구는 당신의 코드를 자신의 프로젝트에서 모듈로 사용하고 싶어하지만 당신은 완전히 다른 코딩 스타일을 사용하고 있다는 것을 알게 되었습니다.
저를 따라 Pear 표준을 사용하여 PHP 프로그램을 작성해 보세요. 귀하의 프로그램과 코드는 다른 전문가의 코드와 쉽게 통합될 것입니다. 더 높은 전력을 생성합니다.
배란 무엇인가

배는 PHP Extension and Application Repository의 약어입니다. 간단히 말해서 Pear는 PHP의 cpan입니다.

배를 사용하는 이유는 무엇인가요?
PHP는 간결하고 효율적인 매우 뛰어난 스크립트 언어입니다. 4.0이 출시되면서 점점 더 많은 사람들이 이를 사용하여 동적 웹사이트를 개발하고 있습니다. 특히 중소 규모의 상용 애플리케이션을 빠르고 효율적으로 개발할 수 있어야 하는 웹사이트 개발자의 경우 PHP가 선호되는 언어입니다. 그러나 PHP 애플리케이션의 수가 증가함에 따라 이러한 애플리케이션에 대한 통일된 표준과 효과적인 관리가 부족하므로 PHP 커뮤니티에서는 Perl 커뮤니티만큼 편리하게 서로의 코드와 애플리케이션을 공유하기가 어렵습니다. PHP에는 Cpan과 같은 코드 및 애플리케이션을 공유하는 기능이 부족합니다. 애플리케이션 코드 모듈을 분류하고 관리하기 위한 통합 코드 베이스(Perl에 익숙한 사람이라면 cpan이 거대한 Perl 확장 모듈 웨어하우스라는 것을 알고 있습니다. 작성된 애플리케이션 모듈은 적절한 분류에 배치될 수 있습니다. 물론, 애플리케이션 모듈을 작성할 때도 지침을 따라야 합니다.)
이러한 이유로 Pear가 탄생했고 이후 PHP 코어와 함께 배포되었습니다. 4.04.
배는 나에게 어떤 효능을 가져다 줄 수 있나요?
1. 위에서 언급한 바와 같이 pear는 특정 카테고리에 따라 pear 애플리케이션 코드 기반을 관리하며, 귀하의 pear 코드는 적절한 디렉토리로 구성될 수 있으며 다른 사람들이 귀하의 결과를 쉽게 검색하고 공유할 수 있습니다.
2.pear는 코드 저장소일 뿐만 아니라 표준이기도 합니다. 이 표준을 사용하여 PHP 코드를 작성하면 프로그램의 가독성과 재사용성이 향상되고 오류 가능성이 줄어듭니다.
3.pear는 소멸자, 오류 잡기 등의 기능을 구현하는 2개의 클래스를 제공하여 프레임워크를 구축합니다. 이러한 기능은 상속을 통해 사용할 수 있습니다.
Pea의 코딩 규칙
Pea의 코딩 규칙에는 들여쓰기 규칙, 제어 구조, 함수 호출, 함수 정의, 주석, 포함 코드, PHP 태그, 파일 헤더의 주석 블록, cvs 태그, URL 샘플, 상수가 포함됩니다. 이 11가지 측면을 명명하세요. . 간략한 소개는 다음과 같습니다.
들여쓰기 규칙:
pear에서 코드를 들여쓰기하려면 4개의 공백이 필요하며 탭은 사용되지 않습니다. vim을 사용하는 경우 ~/.vimrc에 다음 설정을 지정하세요.
setexpandtab
setshiftwidth=4
set tabstop=4

emacs/xemacs를 사용하는 경우 다음이 필요합니다. indent-tabs-mode를 nil로 설정합니다.
그러나 저처럼 (x)emacs를 사용하여 php 파일을 편집하고 싶다면 php-mode를 설치하여 pear 코드를 작성할 때 자동으로 들여쓰기 스타일을 조정하는 것이 좋습니다. 모드 훌륭한 기능이 많이 있으며 리소스 목록에서 최신 버전의 php-mode를 다운로드할 수 있습니다.
제어 구조:
여기서 언급된 제어 구조에는 while 스위치 등이 포함됩니다. 제어 구조의 경우 키워드(예: if for ..) 뒤에 공백이 있어야 하고 제어 괄호 뒤에 있어야 함수 호출과 혼동되지 않습니다. 또한 중괄호 {}를 사용해야 합니다. 구문상 선택사항이더라도 최대한 완벽하게. 이렇게 하면 나중에 새로운 코드 줄을 추가해야 할 때 논리적 혼란이나 오류를 방지할 수 있습니다. 예는 다음과 같습니다.
if ((조건 1) && (조건 2)) {
문 1
}esleif ((조건 3) || (조건 4)) {

문 2; ;

}else {
문 3;
}


함수 호출:
함수 호출의 경우 함수 이름과 왼쪽 대괄호 사이에 공백이 있어서는 안 됩니다( , 함수 매개변수의 경우 쉼표와 다음 매개변수 사이에 동일한 공백 구분이 있어야 하며, 마지막 매개변수와 닫는 괄호 사이에는 공백이 없어야 합니다. 다음은 표준 함수 호출입니다.
$result = foo($ param1) , $param2, $param3);
불규칙한 쓰기:
$result=foo ($param1,$param2,$param3);
$result=foo( $param1,$param2, $ param3 );

또한, 함수의 반환 결과를 할당하려면 등호와 할당된 변수 사이에 공백이 있어야 하며, 동시에 일련의 관련 할당문인 경우에는 다음과 같이 적절한 공백을 추가하여 정렬합니다.
$result1 = $foo($param1, $param2, $param3);
$var2 = $foo($param3);
$var3 = $foo($param4 , $param5);

함수 정의:
함수 정의는 "하나의 참 중괄호" 규칙을 따릅니다.
function connect(&$dsn, $percious = false )
{
if (is_array($dsn)) {
$dsninfo = &$dsn;
} else {
$dsninfo = db::parsedsn($dsn);
}
if (!$dsninfo || !$dsninfo['phptype']) {
return $this->raiseerror();
}
return true;
}

위와 같이 선택적 매개변수는 매개변수 목록의 마지막에 있어야 하며, 항상 의미 있는 함수값을 반환하도록 노력해야 합니다.
코멘트 관련:
클래스의 온라인 문서는 javadoc과 마찬가지로 phpdoc로 변환할 수 있어야 합니다. phpdoc도 배 애플리케이션입니다. 더 자세한 소개를 보려면 http://www.phpdoc.de/로 이동하여 볼 수 있습니다. 클래스에 대한 온라인 문서 외에도 문서화되지 않은 주석을 사용하여 코드를 설명하는 것이 좋습니다. 코드를 보면 다음과 같은 생각이 들 것입니다. . 그런 다음 이 코드가 어떻게 작동하는지 잊지 않도록 간단한 설명을 제공하는 것이 좋습니다. 주석 형식의 경우 c의 /* */ 및 C++의 // 둘 다 좋습니다. 그러나 Perl이나 Shell의 # 주석 방법을 사용하지 마십시오.
포함 코드:
클래스 파일에 무조건 포함해야 하는 경우 require_once를 사용해야 합니다. 클래스 파일에 조건부로 포함해야 하는 경우에는 include_once를 사용해야 합니다. 파일은 한 번만 포함되며 이 두 문은 동일한 파일 목록을 공유하므로 두 문이 혼동되는 것에 대해 걱정할 필요가 없습니다. require_once에 파일이 포함되면 include_once는 동일한 파일을 다시 포함하지 않으며 그 반대의 경우도 마찬가지입니다. .
php 코드 태그:
단순히 를 사용하는 대신 항상 를 사용하면 크로스 플랫폼에도 도움이 됩니다. 포팅.
파일 헤더의 주석문:
pear 코어 릴리스에 포함되어야 하는 모든 PHP 코드 파일의 경우 파일 시작 부분에 다음 주석문을 추가해야 합니다:
/* vim: set Expandtab tabstop=4 Shiftwidth=4: */
// +--------------------------------- -------- ------------------+
// | PHP 버전 4.0 |
// +- ----------------------------- -------- ----+
// | copyright (c) 1997, 1998, 1999, 2000, 2001 PHP 그룹 |
// +- ------------------------------ ------- ----+
// | 이 소스 파일에는 php 라이센스 버전 2.0이 적용됩니다. |
/ / | 파일 라이센스에 이 패키지와 함께 제공되며 |
// |http://www.php.net/license에서 월드와이드 웹을 통해 사용할 수 있습니다. /2_02.txt.
// | PHP 라이센스 사본을 받지 못했고 월드와이드 웹을 통해 얻을 수 없다면 |
// | License@php.net즉시 사본을 우편으로 보내드릴 수 있습니다. |
// +------------ -------- --------------+
// | 저자: 원저자 |
// | 귀하의 이름 |
// +------------------------- -------- ------------------------+
/ /
// $id $

pear 핵심 코드 베이스에 없는 파일의 경우 파일 시작 부분에 저작권을 나타내는 이와 유사한 주석 블록을 두는 것이 좋습니다. 계약서, 저자 등 동시에 vim의 모델라인도 첫 번째 줄에 추가되어 vim에서 pear의 코드 스타일을 유지할 수 있습니다.

cvs 태그:

위와 같이 각 파일에 cvs id 태그를 추가하세요. 편집하거나 수정하는 파일에 이 태그가 없으면 추가하거나 원본 파일과 유사한 태그로 바꾸세요. 표현식 형식(예: "최종 수정" 등)
URL 샘플:
rfc 2606을 참조하고 모든 URL 샘플로 "http://www.example.com"을 사용할 수 있습니다.
상수 명명:
상수는 최대한 대문자로 표기해야 이해가 쉽도록 각 단어를 구분하는 데 밑줄을 사용합니다. 동시에 상수가 위치한 패키지 이름이나 클래스 이름을 앞에 붙여야 합니다. 예를 들어, 버그 클래스의 상수는 bug_로 시작해야 합니다. 위 내용은 pear의 코딩 규칙입니다. 자세한 코딩 규칙은 pear의coding_standard 파일 설명을 참조하세요. 이러한 코딩 규칙을 더 잘 이해하기 위해 기존 pear 코어 모듈의 코드를 참조할 수도 있습니다.
배 사용 시작
배
배 사용은 매우 간단합니다. 다음과 같이 자신만의 배 프로그램을 정의하기만 하면 됩니다.
require_once "pear.php";
class your_class_name은 배를 확장합니다.{
클래스 정의...
}

물론 위에서 언급한 배 코딩 규칙을 준수해야 클래스 내에서 원하는 것을 구현할 수 있습니다. 다음으로 이에 대해 논의해 보겠습니다. 실제로 pear는 사전 정의된 클래스 2개를 제공합니다.
pear: 이것은 pear의 기본 클래스이며 모든 pear 확장은 이 클래스에서 상속 및 파생되어야 합니다.
pear_error: Pear 오류 처리의 기본 클래스입니다. 자체 오류 처리 클래스를 파생하도록 선택할 수 있습니다.
일반적으로 pear 인스턴스를 직접 생성하는 것이 아니라 직접 새 클래스를 파생시킨 다음 이 새 클래스의 인스턴스를 생성해야 합니다. 기본 클래스로서 pear는 몇 가지 유용한 함수를 제공하며 그 중 가장 중요한 것은 소멸자와 오류 처리입니다.
소멸자
PHP는 생성자를 지원하지만 소멸자를 지원하지 않습니다. 스크립트가 종료되기 전에 등록된 함수를 콜백하므로 pear는 이 기능을 사용하여 소멸자 시뮬레이션을 제공합니다. mypear라는 pear의 하위 클래스가 있는 경우 mypear 클래스에서 함수 이름은 밑줄과 클래스 이름인 _mypear()입니다. 하지만 이 소멸자는 C++의 소멸자와 다릅니다. 객체가 삭제될 때 실행되지 않고 스크립트가 종료될 때 이는 결국 시뮬레이션일 뿐입니다. Register_shutdown_function()이 사용되므로 소멸자에 인쇄된 정보는 브라우저에 반환되지 않습니다. 또한 생성자에서 상위 클래스의 생성자를 호출해야 합니다. 왜냐하면 PHP는 자동으로 상위 클래스의 생성자를 호출하지 않으며 소멸자는 pear의 생성자에 등록되어야 하기 때문입니다. pear 소스 코드:
<br>function pear() {<br>if (method_exists($this, "_".get_class($this))) {<br>global $_pear_destructor_object_list;<br>$_pear_destructor_object_list[] = &$this;<br>}<br>if ($this->_debug) {<br>printf("pear 생성자 호출, class=%sn",<br> get_class($this ));<br>}<br>....<br>function _pear_call_destructors() {<br>global $_pear_destructor_object_list;<br>if (is_array($_pear_destructor_object_list) && sizeof($_pear_destructor_object_list)) {<br> 재설정($_pear_destructor_object_list);<br>while (list($k, $objref) = Each($_pear_destructor_object_list)) {<br>$destructor = "_".get_class($objref);<br>if (method_exists ( $objref, $destructor)) {<br>$objref->$destructor();<br>}<br>}<br>//등록된 객체 목록 지우기, <br>//반복 호출 방지 <br>$_pear_destructor_object_list = array();<br>}<br>}<br>....<br>register_shutdown_function("_pear_call_destructors");<br>

위의 코드는 pear가 소멸자를 구현하는 방법을 보여줍니다. 구성 요소 함수에서 현재 클래스에 소멸자가 있는지 확인합니다. 그렇다면 현재 클래스의 참조가 전역 목록에 저장됩니다. 전역 목록의 각 요소에 해당 소멸자가 있는지 여부, 그렇다면 이를 호출하고 마지막으로 전역 목록을 지웁니다.
pear.php 코드의 마지막 줄에서 _pear_call_destructors를 등록하기 위해 Register_shutdown_function("_pear_call_destructors")을 호출하면 스크립트가 실행될 때 PHP가 이 함수를 콜백합니다. 소멸자를 사용하면 사용자 요청을 처리한 후 종료하기 전에 필요한 "사후 관리" 작업을 수행할 수 있습니다. 일반적인 예로는 열려 있는 파일을 닫고, 데이터베이스와의 연결을 끊고, 특정 데이터를 디스크에 저장할 수 있습니다.
오류 처리
Pear를 사용하면 단순히 오류 코드나 오류 정보를 반환할 뿐만 아니라 pear_error 개체를 반환하거나 pear_error에서 파생될 수도 있습니다. 밖으로.
pear의 오류 개체는 특정 출력 형식을 제한하지 않습니다. 사용자에게 너무 많은 정보를 반환하지 않고 오류를 캡처할 수도 있고, 동시에 특수 오류 처리 기능을 호출할 수도 있습니다. 오류 메시지가 출력되면 xml, csv 형식 또는 직접 정의한 다른 형식을 출력할 수도 있습니다. 그런 다음 pear_error에서 새 클래스를 생성하고 "던지기"하면 됩니다. 적절한 시간에 새 클래스의 개체가 수행됩니다.
간단한 오류 처리:
pear에서 가장 간단한 오류 처리는 오류를 "던지는" 것입니다. 간단히 pear_error 개체를 만들고 반환하면 됩니다. 다음은 간단한 예입니다.
<br>function myconnect($host = "localhost", $port = 1080)<br>{<br>$fp = fsockopen($host, $port, $ errno, $errstr);<br>if (!is_resource($fp)) {<br>return new pear_error($errstr, $errno);<br>}<br>return $fp;<br>}<br>$sock = myconnect();<br>if (pear::iserror($sock)) {<br>print "connect error: ".$sock->getmessage()."<br>n" <br>}<br>

위 코드에서 볼 수 있듯이 오류가 발생할 수 있는 코드 조각을 실행한 후 pear의 iserror를 사용하여 오류가 있는지 감지해야 하며, pear_error의 getmessage를 사용하여 최신 오류 메시지를 얻을 수 있습니다. 참고: 주요 위치에서 pear::iserror
를 사용하고 raiseerror를 사용하세요
php4.0.5 이후 pear에는 2가지 기능이 더 있습니다:
seterrorhandling($mode, $options = null)
raiseerror ($message = null, $code = null, $mode = null,$options = null, $userinfo = null)

전자는 pear의 기본 오류 처리 모드를 설정할 수 있고 후자는 래퍼 함수입니다. pear_error 객체를 직접 생성하고 반환하는 것과는 약간 다른 pear_error 객체를 반환합니다. $mode, $options 등의 매개변수를 생략하면 이러한 기본값을 사용하여 pear_error 객체를 생성합니다. , seterrorhandling()을 사용하여 사용자 정의할 수 있습니다.
pear_error
pear_error는 pear의 오류 객체의 기본 클래스입니다. 일반적으로 pear_error의 인스턴스를 직접 생성할 수 있습니다. 생성 방법은 다음과 같습니다.
$error = new pear_error($message, $ code, $mode, $options, $userinfo);
$message는 오류 메시지이고 $code는 오류의 오류 번호이며 마지막 세 매개변수는 밀접하게 관련되어 있습니다.
$mode: is this error 처리 모드는 다음 상수일 수 있습니다:
pear_error_return: 오류 객체만 반환합니다(기본 모드)
pear_error_print: 빌드 함수에서 이 오류 메시지를 인쇄하지만 현재 프로그램은 계속 실행됩니다.
pear_error_trigger: 오류를 발생시키려면 PHP의 Trigger_error()를 사용하세요. 오류 처리 기능을 설정했거나 PHP의 오류 처리 수준을 e_user_error로 설정한 경우 현재 프로그램이 종료됩니다.
pear_error_die: 오류를 인쇄하고 종료하면 프로그램이 종료됩니다.
pear_error_callback: 콜백 함수나 메소드를 사용하여 현재 오류를 처리하고 프로그램을 종료합니다.
$options: 이 매개변수는 $mode가 pear_error_trigger 및 pear_error_callback인 경우에만 작동합니다. pear_error_trigger인 경우 $options는 PHP의 Trigger_error 값과 일치하는 세 가지 상수 e_user_notice, e_user_warning 또는 e_user_error 중 하나여야 합니다. $mode가 pear_error_callback인 경우 $options는 콜백할 함수의 이름을 포함하는 문자열이거나 각각 개체 변수와 문자열(호출할 메서드를 나타냄)의 2개 요소 배열일 수 있습니다.
$userinfo: 추가 사용자 정보를 여기에 저장합니다.
pear_error에는 일반적으로 사용되는 몇 가지 메소드가 있습니다. 이러한 메소드는 PHP 문서에 하나씩 나열되어 있습니다.
int getmode: 현재 오류 처리 모드인 정수를 반환합니다.
string getmessage: 현재 전체 오류 메시지인 문자열을 반환합니다.
mixed getcallback: 현재 콜백 정보를 반환합니다. 이는 콜백되는 함수의 이름이거나 (객체, 메소드)의 배열일 수 있습니다.
int getcode: 정수 오류 코드를 반환합니다.
string gettype: 현재 클래스 이름인 string인 잘못된 유형을 반환합니다.
string getuserinfo: 추가 사용자 정보, 문자열을 반환합니다.
string getdebuginfo: 내용은 위와 동일합니다.
string tostring: 오류 처리 모드, 수준, 오류 정보, 오류 코드, 관련 콜백 함수 등을 포함하여 현재 개체에 대한 자세한 문자열 설명을 반환합니다.
요약
배 소개는 이것으로 끝입니다. 요약하자면, pear의 확장 애플리케이션을 만들려면 다음을 수행해야 합니다.
require_once "pear.php"
your_pear_extend 확장 pear 클래스{}를 사용하여 새 클래스를 정의합니다.
클래스 생성자에서 상위 클래스 pear의 생성자를 호출합니다.
function your_pear_extend{
$this->pear();
...
}

필요한 경우 소멸자 _your_pear_extend를 정의하세요
필요한 경우 pear_error에서 고유한 오류 처리 클래스를 파생하세요
오류 처리 모드를 설정하고 적절한 경우 오류를 트리거하세요.
오류가 발생할 수 있는 코드를 실행한 후 pear::iserror($obj)를 사용하여 해당 오류를 캡처하세요.
자신만의 기능을 구현해 보세요.
php4.05의 최신 Pear Core 릴리스에는 이미 phpdoc, 캐시, html과 같은 우수한 애플리케이션 모듈이 많이 있습니다... 물론 cpan에 비해 Pear는 이제 막 시작했으며 PHP가 필요합니다. PHP를 개선하고 향상시키려는 커뮤니티 사람들의 노력으로 인해 PHP는 점점 더 강력해질 것입니다.
관련 리소스
pear 홈페이지
php 홈페이지
pear 애플리케이션 소스 코드에서 javadoc과 유사한 API 문서를 생성할 수 있는 phpdoc 홈페이지
emacs/에 제공되는 xemacs/emacs용 php-mode xemacs PHP의 구문 지원은 Pear 코드 스타일을 매우 잘 지원할 수 있습니다.
매우 뛰어난 편집기인 vim 홈페이지도 PHP를 잘 지원합니다.