PEAR란 무엇입니까?
PEAR는 PHP Extension and Application Repository의 약어입니다. 이는 PHP 확장 및 애플리케이션을 위한 코드 저장소입니다. 간단히 말해서 PEAR는 PHP의 CPAN입니다.
왜 PEAR를 사용하나요?
PHP는 간결하고 효율적인 매우 뛰어난 스크립팅 언어입니다. 4.0이 출시되면서 점점 더 많은 사람들이 이를 사용하여 동적 웹사이트를 개발하고 있습니다. 특히 PHP는 최고의 인터넷 개발 언어 중 하나가 되었습니다. 중소 규모의 비즈니스 애플리케이션을 빠르고 효율적으로 개발할 수 있어야 하는 웹 사이트 개발자가 선택하는 언어입니다. 그러나 PHP 애플리케이션의 수가 증가함에 따라 이러한 애플리케이션에 대한 통일된 표준과 효과적인 관리가 부족하므로 PHP 커뮤니티에서는 PERL 커뮤니티의 사람들만큼 편리하게 서로의 코드와 애플리케이션을 공유하기가 어렵습니다. PHP에는 CPAN과 동일한 표준이 없습니다. 애플리케이션 코드 모듈을 분류하고 관리하기 위한 통합 코드 베이스(PERL에 익숙한 사람은 CPAN이 거대한 PERL 확장 모듈 웨어하우스라는 것을 알고 있습니다. 작성된 애플리케이션 모듈은 CPAN 아래의 적절한 분류 디렉토리에 배치될 수 있습니다. 물론, 애플리케이션 모듈을 작성할 때도 지침을 따라야 합니다.)
이러한 이유로 PEAR가 등장하여 4.04부터 PHP 코어와 함께 배포되었습니다.
PEAR는 나에게 어떤 이점을 가져다 줄 수 있나요?
1. 위에서 언급한 것처럼 PEAR는 특정 카테고리에 따라 PEAR 애플리케이션 코드 베이스를 관리합니다. 귀하의 PEAR 코드는 적절한 디렉토리로 구성될 수 있으며 다른 사람들이 귀하의 결과를 쉽게 검색하고 공유할 수 있습니다.
2. PEAR는 단순한 코드 저장소가 아니라 표준이기도 합니다. 이 표준을 사용하여 PHP 코드를 작성하면 프로그램의 가독성과 재사용성이 향상되고 오류 가능성이 줄어듭니다.
3. PEAR는 소멸자 및 오류 잡기와 같은 기능을 구현하기 위해 2개의 클래스를 제공하여 프레임워크를 구축합니다. 이러한 기능은 상속을 통해 사용할 수 있습니다.
PEAR의 코딩 규칙
PEAR의 코딩 규칙에는 들여쓰기 규칙, 제어 구조, 함수 호출, 함수 정의, 주석, 포함된 코드, PHP 태그, 파일 헤더 주석 블록, CVS 태그, URL 샘플 및 상수 이름 지정이 포함됩니다. 다음은 간단한 소개입니다:
들여쓰기 규칙:
PEAR에서는 코드를 들여쓰기 위해 4개의 공백이 필요하며 TAB은 사용되지 않습니다. VIM을 사용하는 경우 ~/.vimrc에 다음 설정을 지정하세요.
이동폭=4로 설정
set tabstop=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 ?>를 사용하여 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 소스 코드: <code>
함수 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");
</code>
위 코드는 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 객체를 생성하고 반환하기만 하면 됩니다. 다음은 간단한 예입니다. <code>
함수 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()."<BR>n" 인쇄
}
</code>
위 코드에서 볼 수 있듯이 오류가 발생할 수 있는 코드를 실행한 후 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 객체를 생성합니다. 이러한 기본값을 사용자 정의할 수 있습니다. .
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)를 사용하여 해당 오류를 캡처하세요.
자신만의 기능을 구현해보세요.
PHP4.05의 최신 PEAR 코어 릴리스에는 이미 PHPDoc, 캐시, HTML과 같은 우수한 애플리케이션 모듈이 많이 있습니다. 물론 CPAN에 비해 PEAR는 이제 막 시작했으며 PHP 커뮤니티의 인력이 필요합니다. 이를 개선하고 강화하기 위한 우리의 공동 노력을 통해 PHP는 점점 더 강력해질 것입니다.
참고 자료
Pear 홈페이지
PHP 홈페이지
PEAR 애플리케이션 소스 코드에서 JAVADOC와 유사한 API 문서를 생성할 수 있는
XEmacs/Emacs용 PHP 모드를 생성할 수 있는 PHPDoc 홈페이지는 emacs/xemacs에 대한 PHP 구문 지원을 제공하며 pear 코드 스타일 Vim 홈페이지를 잘 지원할 수 있습니다
. PHP를 잘 지원하는 아주 좋은 편집기
저자 소개
Pan Fan (Night Sailer): Beijing Saidi Data Co., Ltd. 엔지니어 주로 데이터 분석 및 변환, 관련 개발 업무를 담당합니다. 개발을 위해 VB, PERL, PHP를 사용하고 Linux에서 중국어 작업을 잘합니다. 나의 최근 관심 분야는 Perl, Php 및 XML의 응용, PHP의 MVC 개발 모델, PERL-GTK의 사용입니다. 이메일: [email protected]을 통해 그에게 연락할 수 있습니다.