앞에서 언급한 것처럼 PEAR는 특정 범주에 따라 PEAR 애플리케이션 코드 베이스를 관리합니다. 귀하의 PEAR 코드는 적절한 디렉토리로 구성될 수 있으며 다른 사람들이 귀하의 결과를 쉽게 검색하고 공유할 수 있습니다. PEAR는 단순한 코드 저장소가 아니라 표준이기도 합니다. 이 표준을 사용하여 PHP 코드를 작성하면 프로그램의 가독성과 재사용성이 향상되고 오류 가능성이 줄어듭니다. PEAR는 소멸자 및 오류 잡기와 같은 기능을 구현하는 두 개의 클래스를 제공하여 프레임워크를 구축합니다. 이러한 기능은 상속을 통해 사용할 수 있습니다.
PEAR의 코딩 규칙에는 들여쓰기 규칙, 제어 구조, 함수 호출, 함수 정의, 주석, 포함된 코드, PHP 태그, 파일 헤더 주석 블록, CVS 태그, URL 샘플 및 상수 이름 지정이 포함됩니다. 간략한 소개는 다음과 같습니다.
들여쓰기 규칙:
PEAR에서는 코드를 들여쓰기 위해 4개의 공백이 필요하며 TAB은 사용되지 않습니다. VIM을 사용하는 경우 ~/.vimrc에 다음 설정을 지정하세요.
이동폭=4로 설정
탭스톱을 4로 설정
Emacs/XEmacs를 사용하는 경우 indent-tabs-mode를 nil로 설정해야 합니다.
하지만 나처럼 (X)Emacs를 사용하여 PHP 파일을 편집하고 싶다면 PEAR 코드를 작성할 때 들여쓰기 스타일이 자동으로 조정되도록 PHP-MODE를 설치하는 것이 좋습니다. 물론 많은 PHP-MODE가 있습니다. MODE 아주 좋은 기능입니다. 리소스 목록에서 최신 버전의 PHP-MODE를 다운로드할 수 있습니다.
제어 구조:
여기에 언급된 제어 구조에는 if for while 스위치 등이 포함됩니다. 제어 구조의 경우 키워드(예: if for ..) 뒤에 공백이 있어야 하고 제어 괄호 뒤에 있어야 함수 호출과 혼동되지 않습니다. 또한 중괄호 {}를 사용해야 합니다. 구문상 선택사항이더라도 최대한 완벽하게. 이렇게 하면 나중에 새로운 코드 줄을 추가해야 할 때 논리적 혼란이나 오류를 방지할 수 있습니다. 다음은 예입니다: if ((조건1) && (조건2)) {
진술 1;
}esleif ((조건 3) || (조건 4)) {
진술 2;
}또 다른 {
진술 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;
} 또 다른 {
$dsninfo = DB::parseDSN($dsn);
}
if (!$dsninfo || !$dsninfo['phptype']) {
$this->raiseError()를 반환합니다.
}
사실을 반환;
}
위에 표시된 것처럼 선택적 매개변수는 매개변수 목록의 끝에 있어야 하며 항상 의미 있는 함수 값을 반환하도록 노력해야 합니다.
댓글 관련:
클래스에 대한 온라인 문서의 경우 JavaDoc과 마찬가지로 PHPDoc으로 변환할 수 있어야 합니다. PHPDoc은 PEAR 애플리케이션이기도 합니다. 더 자세한 소개를 보려면 http://www.phpdoc.de/ 로 이동하여 볼 수 있습니다. 클래스에 대한 온라인 문서 외에도 문서화되지 않은 주석을 사용하여 코드를 설명하는 것이 좋습니다. 코드를 보면 다음과 같은 생각이 들 것입니다. . 그런 다음 이 코드가 어떻게 작동하는지 잊지 않도록 이 코드에 간단한 설명을 제공하는 것이 좋습니다. 주석 형식의 경우 C의 /* */ 및 C++의 //가 모두 좋습니다. 그러나 Perl이나 쉘의 # 주석 방법을 사용하지 마십시오.
코드 포함:
클래스 파일을 무조건 포함해야 할 때마다 require_once를 사용해야 합니다. 클래스 파일을 조건부로 포함해야 하는 경우에는 include_once를 사용해야 합니다. 이렇게 하면 포함하려는 파일이 한 번만 포함됩니다. 동일한 파일 목록을 공유하므로 두 가지가 혼동되는 것에 대해 걱정할 필요가 없습니다. require_once에 파일이 포함되면 include_once는 동일한 파일을 다시 포함하지 않으며 그 반대의 경우도 마찬가지입니다.
PHP 코드 마크업:
단순히 사용하기보다는 항상 PHP 코드를 정의하십시오. 이렇게 하면 PEAR 호환성이 보장되고 크로스 플랫폼 포팅이 용이해집니다.
파일 헤더의 주석 선언:
PEAR 코어 릴리스에 포함되어야 하는 모든 PHP 코드 파일의 경우 파일 시작 부분에 다음 주석문을 추가해야 합니다: /* vim: setexpandtab tabstop=4shiftwidth=4: */
// +---------------------------------- --- ----------+
// | PHP 버전 4.0 |
// +---------------------------------- --- ----------+
// | 저작권 (c) 1997, 1998, 1999, 2000, 2001 PHP 그룹 |
// +---------------------------------- --- ----------+
// | 이 소스 파일에는 PHP 라이센스 버전 2.0이 적용됩니다. |
// | LICENSE 파일에 이 패키지와 함께 제공되며 |
// | 월드와이드웹을 통해 |
// | http://www.php.net/license/2_02.txt |
// | PHP 라이센스 사본을 받지 못했고 다음을 수행할 수 없는 경우 |
// | 월드와이드웹을 통해 얻으려면 |
// | 라이센스@php.net을 통해 즉시 사본을 우편으로 보내드릴 수 있습니다.
// +---------------------------------- --- ----------+
// | 저자: 원저자 |
// | 당신의 이름 |
// +---------------------------------- --- ----------+
//
// $ID$
PEAR 핵심 코드 베이스에 없는 파일의 경우 파일 시작 부분에 저작권, 라이센스, 작성자 등을 나타내는 이와 유사한 주석 블록도 포함하는 것이 좋습니다. 동시에 첫 번째 줄에 VIM의 MODELINE을 추가하면 VIM에서도 PEAR의 코드 스타일이 유지될 수 있습니다.
CVS 마크업:
위와 같이 각 파일에 CVS ID 태그를 추가합니다. 편집하거나 수정하는 파일에 이 태그가 없으면 추가하거나 원본 파일에 있는 유사한 표현(예: "최종 수정" 등)으로 교체하세요. )
URL 샘플:
RFC 2606을 따르고 모든 URL 예제로 " www.example.com "을 사용할 수 있습니다.
상수 이름 지정:
상수는 가능하면 대문자로 작성하고, 이해하기 쉽도록 밑줄을 사용하여 각 단어를 구분합니다. 동시에 상수가 위치한 패키지 이름이나 클래스 이름을 앞에 붙여야 합니다. 예를 들어 Bug 클래스의 상수는 Bug_로 시작해야 합니다. 위 내용은 PEAR의 코딩 규칙입니다. 자세한 코딩 규칙은 PEAR의 CODING_STANDDARD 파일 설명을 참조하세요. 이러한 코딩 규칙을 더 잘 이해하려면 기존 PEAR 코어 모듈의 코드를 참조할 수도 있습니다.
PEAR 시작하기
PEAR 사용은 매우 간단합니다. 다음과 같이 자신만의 PEAR 프로그램을 정의하기만 하면 됩니다: require_once "PEAR.php";
클래스 your_class_name은 PEAR를 확장합니다{
클래스 정의 ...
}
물론 위에서 언급한 PEAR 코딩 규칙을 준수해야 클래스 내에서 원하는 작업을 구현할 수 있습니다. 다음으로 이에 대해 논의해 보겠습니다. 실제로 PEAR는 미리 정의된 클래스 2개를 제공합니다. PEAR: 이는 PEAR의 기본 클래스이며 모든 PEAR 확장은 이 클래스에서 상속 및 파생되어야 합니다. PEAR_Error: PEAR의 오류 처리 기본 클래스로, 자신만의 오류 처리 클래스를 파생하도록 선택할 수 있습니다.
일반적으로 PEAR 인스턴스를 직접 생성해서는 안 되며, 직접 새 클래스를 파생시킨 다음 이 새 클래스의 인스턴스를 생성해야 합니다. 기본 클래스로서 PEAR는 몇 가지 유용한 기능을 제공하며 가장 중요한 기능은 소멸자와 오류 처리
소멸자입니다.
PHP는 생성자를 지원하지만 소멸자를 지원하지 않습니다. 그러나 PHP는 스크립트가 종료되기 전에 등록된 함수를 다시 호출할 수 있는 Register_shutdown_function() 함수를 제공합니다. 따라서 PEAR는 이 기능을 활용하여 소멸자 시뮬레이션을 제공합니다. mypear라는 PEAR 하위 클래스가 있는 경우 mypear 클래스에서 함수 이름은 밑줄과 클래스 이름인 _mypear()입니다. 하지만 이 소멸자는 C++의 소멸자와 다릅니다. 객체가 삭제될 때 실행되지 않고 스크립트가 종료될 때 이는 결국 시뮬레이션일 뿐입니다. Register_shutdown_function()이 사용되므로 인쇄된 정보는 소멸자의 브라우저에 반환되지 않습니다. 또한 생성자에서 상위 클래스의 생성자를 호출해야 합니다. 왜냐하면 PHP는 자동으로 상위 클래스의 생성자를 호출하지 않으며 소멸자는 PEAR의 생성자에 등록되어야 하기 때문입니다. PEAR 소스 코드: function PEAR() {
if (method_exists($this, "_".get_class($this))) {
전역 $_PEAR_destructor_object_list;
$_PEAR_destructor_object_list[] = &this;
}
if ($this->_debug) {
printf("PEAR 생성자가 호출되었습니다. 클래스=%sn",
get_class($this));
}
.....
함수 _PEAR_call_destructors() {
전역 $_PEAR_destructor_object_list;
if (is_array($_PEAR_destructor_object_list) && sizeof($_PEAR_destructor_object_list)) {
재설정($_PEAR_destructor_object_list);
while (list($k, $objref) = 각각($_PEAR_destructor_object_list)) {
$destructor = "_".get_class($objref);
if (method_exists($objref, $destructor)) {
$objref->$소멸자();
}
}
//등록된 객체 목록을 삭제하고,
//반복 호출 방지
$_PEAR_destructor_object_list = 배열();
}}
....
Register_shutdown_function("_PEAR_call_destructors");
위 코드는 PEAR가 소멸자를 구현하는 방법을 보여줍니다. 구성 요소 함수에서 현재 클래스에 소멸자가 있는지 확인하면 현재 클래스의 참조가 PEAR_call_destructors의 전역 목록에 저장됩니다. , 전역 목록의 각 요소에 해당 소멸자가 있는지 확인하고, 그렇다면 호출하고 마지막으로 전역 목록을 지웁니다.
PEAR.php 코드의 마지막 줄에서 _PEAR_call_destructors를 등록하기 위해 Register_shutdown_function("_PEAR_call_destructors")을 호출하면 스크립트가 실행될 때 PHP가 이 함수를 다시 호출합니다. 소멸자를 사용하면 사용자 요청을 처리한 후 종료하기 전에 필요한 "사후 관리" 작업을 수행할 수 있습니다. 일반적인 예로는 열려 있는 파일을 닫고, 데이터베이스와의 연결을 끊고, 특정 데이터를 디스크에 저장할 수 있습니다.
오류 처리
PEAR를 사용하면 다양한 방법으로 오류를 처리할 수 있습니다. 단순히 오류 코드나 오류 정보를 반환할 뿐만 아니라 PEAR_Error 개체 또는 PEAR_Error에서 파생된 새 오류 개체를 반환할 수도 있습니다.
PEAR의 오류 개체는 특정 출력 형식을 제한하지 않고 사용자에게 너무 많은 정보를 반환하지 않고 오류를 캡처할 수도 있고, 동시에 오류 정보를 출력하더라도 특별한 오류 처리 기능을 호출할 수도 있습니다. , HTML 형식을 사용해야 할 수도 있습니다. XML, CSV 형식 또는 직접 정의한 기타 형식을 출력할 수 있습니다. PEAR_Error에서 새 클래스를 파생시킨 다음 이 새 클래스를 생성하고 "던지기"만 하면 됩니다. 적절한 시간에 반대하십시오.
간단한 오류 처리:
PEAR에서 가장 간단한 오류 처리는 PEAR_Error 객체를 생성하고 반환하기만 하면 됩니다. 다음은 간단한 예입니다. function myconnect($host = "localhost", $port = 1080){
$fp = fsockopen($host, $port, $errno, $errstr);
if (!is_resource($fp)) {
새로운 PEAR_Error($errstr, $errno)를 반환합니다.
}
$fp를 반환합니다.
}
$sock = myconnect();
if (PEAR::isError($sock)) {
"연결 오류: ".$sock->getMessage()."n" 인쇄
}
위 코드에서 볼 수 있듯이 오류가 발생할 수 있는 코드를 실행한 후 PEAR의 isError를 사용하여 오류가 있는지 감지해야 하며, PEAR_Error의 getMessage를 사용하여 최신 오류 메시지를 얻을 수 있습니다.
및 raiseError를
사용하십시오.
PHP4.0.5 이후 PEAR에는 2가지 기능이 더 있습니다:
setErrorHandling($mode, $options = null)
raiseError($message = null, $code = null, $mode = null,$options = null, $userinfo = null)
전자는 PEAR의 기본 오류 처리 모드를 설정할 수 있고, 후자는 PEAR_Error 객체를 직접 생성하고 반환하는 래퍼 함수입니다. $mode, $options 등의 매개변수를 생략하면 됩니다. setErrorHandling()을 사용하여 사용자 정의할 수 있는 기본값을 사용하여 이 PEAR_Error 개체를 만듭니다.
PEAR_오류
PEAR_Error는 PEAR 오류 객체의 기본 클래스입니다. 일반적으로 PEAR_Error의 인스턴스를 직접 생성할 수 있습니다. $error = new PEAR_Error($message, $code, $mode, $options, $ userinfo )
$message는 오류 메시지이고 $code는 오류의 오류 번호이며 마지막 세 매개변수는 밀접하게 관련되어 있습니다.
$mode: 오류 처리 모드이며 다음 상수일 수 있습니다.
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: 현재 전체 오류 메시지인 문자열을 반환합니다.
혼합 getCallback: 콜백되는 함수의 이름이거나 (객체, 메소드)의 배열일 수 있는 현재 콜백 정보를 반환합니다.
int getCode: 정수 오류 코드를 반환합니다.
string getType: 현재 클래스 이름인 string인 잘못된 유형을 반환합니다.
string getUserInfo: 추가 사용자 정보, 문자열을 반환합니다.
string getDebugInfo: 내용은 위와 동일합니다.
string toString: 오류 처리 모드, 수준, 오류 정보, 오류 코드, 관련 콜백 함수 등을 포함하여 현재 개체에 대한 자세한 문자열 설명을 반환합니다.
요약
하면PEAR 소개가 끝났습니다. 요약하자면, PEAR 확장 애플리케이션을 만들고 싶다면 다음과 같이 해야 합니다:
require_once "PEAR.php"
your_pear_extend 클래스 PEAR{}를 사용하여 새 클래스를 정의하세요.
클래스 생성자에서 상위 클래스 PEAR의 생성자를 호출합니다. function your_pear_extend{
$this->PEAR();
...
}
필요한 경우 소멸자 _your_pear_extend를 정의합니다.
필요한 경우 PEAR_Error에서 자체 오류 처리 클래스를 파생하여 오류 처리 모드를 설정하고 적절한 경우 오류를 트리거합니다.
오류를 생성할 수 있는 코드를 실행한 후 PEAR::isError($obj)를 사용하여 해당 오류를 캡처하세요.
자신만의 기능을 구현해보세요.
PEAR 코어 릴리스에는 PHPDoc, Cache 및 HTML과 같은 우수한 애플리케이션 모듈이 이미 많이 있습니다.