pear簡介:用pear來寫你的下一個php程序;

內(nèi)容：

什么是ｐｅａｒ為什么要使用ｐｅａｒ？ｐｅａｒ能給我?guī)硎裁春锰?？ｐｅａｒ的編碼規(guī)則開始使用ｐｅａｒ總結(jié)相關(guān)資源作者簡介

潘凡(night sailer) (nightsailer@hotmail.com)北京賽迪網(wǎng)信息技術(shù)有限公司2001 年 6 月你可能已經(jīng)是個php的老手了，寫了很多非常棒的代碼。但是，如果你現(xiàn)在要把它們加入到你現(xiàn)在的項目中去，是否有些吃力？你的朋友想使用你的代碼作為他的項目中的一個模塊，但是你發(fā)現(xiàn)你們使用了截然不同的編碼風(fēng)格，讓他適應(yīng)，甚至不如重寫一個！請跟我來，使用pear標(biāo)準(zhǔn)編寫你的php程序吧，你的程序?qū)碛懈蟮幕盍?，你的程序和代碼將會很方便地和其他高手的代碼融合在一起，pear就象cpan對于perl一樣，會讓php產(chǎn)生更高的能量。什么是ｐｅａｒｐｅａｒ是ｐｈｐ擴(kuò)展與應(yīng)用庫（the php extension and application repository）的縮寫。它是一個ｐｈｐ擴(kuò)展及應(yīng)用的一個代碼倉庫，簡單地說，ｐｅａｒ就是ｐｈｐ的ｃｐａｎ。為什么要使用ｐｅａｒ？php是一個非常優(yōu)秀的腳本語言，簡潔、高效，隨著4.0的發(fā)布，越來越多的人使用它來進(jìn)行動態(tài)網(wǎng)站的開發(fā)，可以說，php已經(jīng)成為最優(yōu)秀的internet開發(fā)語言之一，尤其對于那些需要能夠快速、高效地開發(fā)中小規(guī)模的商業(yè)應(yīng)用的網(wǎng)站開發(fā)人員，php是其首選的語言。但是隨著php的應(yīng)用的不斷增多，對于這些應(yīng)用缺乏統(tǒng)一的標(biāo)準(zhǔn)和有效的管理，因此，php社區(qū)很難象perl社區(qū)的人們那樣方便的共享彼此的代碼和應(yīng)用，因為php缺乏象cpan那樣的統(tǒng)一的代碼庫來分類管理應(yīng)用的代碼模塊（熟悉perl的人都知道，cpan是一個巨大的perl的擴(kuò)展模塊倉庫，編寫的應(yīng)用模塊可以放在cpan下面的適當(dāng)?shù)姆诸惸夸浵旅?，其他的人可以很方便地?fù)用，當(dāng)然，你編寫應(yīng)用模塊時候也需要遵守其中的準(zhǔn)則。）為此，pear就應(yīng)運而生了，并且從4.04開始，隨著php核心一起被分發(fā)。ｐｅａｒ能給我?guī)硎裁春锰帲?.如前所述，pear按照一定的分類來管理pear應(yīng)用代碼庫，你的pear代碼可以組織到其中適當(dāng)?shù)哪夸浿校渌娜丝梢苑奖愕貦z索并分享到你的成果。2.pear不僅僅是一個代碼倉庫，它同時也是一個標(biāo)準(zhǔn)，使用這個標(biāo)準(zhǔn)來書寫你的php代碼，將會增強(qiáng)你的程序的可讀性，復(fù)用性，減少出錯的幾率。3.pear通過提供2個類為你搭建了一個框架，實現(xiàn)了諸如析構(gòu)函數(shù)，錯誤捕獲功能，你通過繼承就可以使用這些功能。ｐｅａｒ的編碼規(guī)則pear的編碼規(guī)則包括縮進(jìn)規(guī)則，控制結(jié)構(gòu)，函數(shù)調(diào)用，函數(shù)定義，注釋，包含代碼，php標(biāo)記，文件頭的注釋塊，cvs標(biāo)記，url樣例，常量的命名這11方面。下面簡要地介紹一下：縮進(jìn)規(guī)則：pear中需要使用4個空格來縮排代碼，并且不使用tab。如果你使用vim，將下列設(shè)置放入你的~/.vimrc中：set expandtabset shiftwidth=4set tabstop=4

如果，你使用emacs/xemacs,需要把indent-tabs-mode 設(shè)置成nil。不過你象我一樣喜歡用(x)emacs編輯php文件，我強(qiáng)烈推薦你安裝php-mode，這樣當(dāng)你編寫pear代碼的時候，它會自動調(diào)整你的縮排風(fēng)格，當(dāng)然php-mode還有許多很優(yōu)秀的特性，你可以從資源列表中的地方下載最新版的php-mode?？刂平Y(jié)構(gòu)：這里所說的控制結(jié)構(gòu)包括: if for while switch 等。對于控制結(jié)構(gòu)，在關(guān)鍵字（如if for ..）后面要空一個格，然后再跟控制的圓括號，這樣，不至于和函數(shù)調(diào)用混淆，此外，你應(yīng)該盡量完整的使用花括號{}，即使從語法上來說是可選的。這樣可以防止你以后需添加新的代碼行時產(chǎn)生邏輯上的疑惑或者錯誤。這里是一個樣例：if ((條件1) && (條件2)) {語句1；}esleif ((條件3) || (條件4)) {語句2；}else {語句3；}

函數(shù)調(diào)用：對于函數(shù)調(diào)用，函數(shù)名和左括號( 之間不應(yīng)該有空格，對于函數(shù)參數(shù)，在分隔的逗號和下一個參數(shù)之間要有相同的空格分離，最后一個參數(shù)和右括號之間不能有空格。下面是一個標(biāo)準(zhǔn)的函數(shù)調(diào)用；$result = foo($param1, $param2, $param3);不規(guī)范的寫法：$result=foo ($param1,$param2,$param3);$result=foo( $param1,$param2, $param3 );

此外，如果要將函數(shù)的返回結(jié)果賦值，那么在等號和所賦值的變量之間要有空格，同時，如果是一系列相關(guān)的賦值語句，你添加適當(dāng)?shù)目崭?，使它們對齊，就象這樣：$result1 = $foo($param1, $param2, $param3);$var2 = $foo($param3);$var3 = $foo($param4, $param5);

函數(shù)定義：函數(shù)定義遵循'one true brace'習(xí)俗：function connect(&$dsn, $persistent = false){if (is_array($dsn)) {$dsninfo = &$dsn;} else {$dsninfo = db::parsedsn($dsn);}if (!$dsninfo || !$dsninfo['phptype']) {return $this->raiseerror();}return true;}

如上所示，可選參數(shù)要在參數(shù)表的末端，并且總是盡量返回有意義的函數(shù)值。關(guān)于注釋：對于類的在線文檔，應(yīng)該能夠被phpdoc轉(zhuǎn)換，就象javadoc那樣。phpdoc也是一個pear的應(yīng)用程序，更詳細(xì)的介紹你可以去http://www.phpdoc.de/查看。除了類的在線文檔，建議你應(yīng)該使用非文檔性質(zhì)的注釋來詮釋你的代碼，當(dāng)你看到一段代碼時想：哦，我想不需要在文檔里去仔細(xì)描述它吧。那么你最好給這段代碼作一個簡單的注釋，這樣防止你會忘記它們是如何工作的。對于注釋的形式，c的 /* */和c++的//都不錯，不過，不要使用perl或者shell的#注釋方式。包含代碼：無論什么時候，當(dāng)你需要無條件包含進(jìn)一個class文件，你必須使用requre_once;當(dāng)你需要條件包含進(jìn)一個class文件，你必須使用include_once;這樣可以保證你要包含的文件只會包含一次，并且這2個語句共用同一個文件列表，所以你無須擔(dān)心二者會混淆，一旦require_once 包含了一個文件，include_once不會再重復(fù)包含相同的文件，反之亦然。php代碼標(biāo)記：任何時候都要使用<?php ?>定義你的php代碼，而不要簡單地使用<? ?>,這樣可以保證pear的兼容性，也利于跨平臺的移植。文件頭的注釋聲明：所有需要包含在pear核心發(fā)布的php代碼文件，在文件開始的時候，你必須加入以下的注釋聲明：/* vim: set expandtab tabstop=4 shiftwidth=4: */// +----------------------------------------------------------------------+// | php version 4.0 |// +----------------------------------------------------------------------+// | copyright (c) 1997, 1998, 1999, 2000, 2001 the php group; |// +----------------------------------------------------------------------+// | this source file is subject to version 2.0 of the php license,; |// | that is bundled with this package in the file license, and is |// | available at through the world-wide-web at; |// |http://www.php.net/license/2_02.txt.; |// | if you did not receive a copy of the php license and are unable to; |// | obtain it through the world-wide-web, please send a note to |// |license@php.netso we can mail you a copy immediately.; |// +----------------------------------------------------------------------+// | authors: original author; |// | your name |// +----------------------------------------------------------------------+//// $id$

對于不在pear核心代碼庫中的文件，建議你也在文件的開始處有這樣一個類似的注釋塊，標(biāo)明版權(quán)，協(xié)議，作者等等。同時也在第一行加入vim的modeline，這樣在vim中能夠保持pear的代碼風(fēng)格。cvs標(biāo)記：如上面所展示那樣，在每個文件中加入cvs的id標(biāo)記，如果你編輯或修改的文件中沒有這個標(biāo)記，那么請加入，或者是替換原文件中相類似的表現(xiàn)形式（如'last modified'等等）url樣本：你可以參照rfc 2606,使用'http://www.example.com'作為所有的url樣本。常量命名：常量應(yīng)該盡量使用大寫，為了便于理解，使用下劃線分割每個單詞。同時，你應(yīng)該常量所在的包名或者是類名作為前綴。比如，對于bug類中常量應(yīng)該以bug_開始。以上是pear的編碼規(guī)則，詳細(xì)的編碼規(guī)則可以參考pear中的coding_standdard文件的說明。為了更好地理解這些編碼規(guī)則，你也可以參考一下現(xiàn)有pear核心模塊的代碼。開始使用ｐｅａｒpear使用pear很簡單，你只需這樣定義你自己的pear程序：require_once 'pear.php';class your_class_name extends pear{你的類定義...}

當(dāng)然，你需要遵守前面說的pear的編碼規(guī)則，之后你就可以在你的類內(nèi)部實現(xiàn)你要做的事情了。下面，我們展開討論一下，實際上pear為我們提供了2個預(yù)定義類：pear:這是pear的基類，所有的pear擴(kuò)展都要從它繼承派生出來。pear_error：pear的錯誤處理的基類，你可以選擇派生出自己的錯誤處理的類。一般來說，你不應(yīng)該直接創(chuàng)建pear的實例，而是要自己派生出一個新的類，然后再創(chuàng)建這個新類的實例。作為基類，pear給我們提供了一些有用的功能，最主要的就是析構(gòu)函數(shù)和錯誤處理析構(gòu)函數(shù)php支持構(gòu)造函數(shù)，但是并不支持析構(gòu)函數(shù)，不過，php提供register_shutdown_function()這個函數(shù)，從而能夠在腳本終止前回調(diào)注冊的函數(shù)，因此pear利用這個特性，提供了析構(gòu)函數(shù)的仿真。假如你有一個pear的子類，叫做mypear,那么在mypear類中，你可以定義一個函數(shù)，函數(shù)名是下劃線加上你的類名，_mypear(),這個函數(shù)就是這個類的析構(gòu)函數(shù)。不過這個析構(gòu)函數(shù)和c++中的析構(gòu)函數(shù)不太一樣，它不會在對象被刪除的時候執(zhí)行，而是在腳本結(jié)束的時候，畢竟這只是一個仿真。由于是使用了register_shutdown_function()，所以在你的析構(gòu)函數(shù)里，打印的信息將不會返回瀏覽器中。此外，在你的構(gòu)造函數(shù)中，需要調(diào)用一下它的父類的構(gòu)造函數(shù)，因為php不會自動調(diào)用父類的構(gòu)造函數(shù)，而析構(gòu)函數(shù)需要在pear的構(gòu)造函數(shù)中注冊，我們可以看看pear的源代碼：<code>function pear() {if (method_exists($this, '_'.get_class($this))) {global $_pear_destructor_object_list;$_pear_destructor_object_list[] = &$this;}if ($this->_debug) {printf('pear constructor called, class=%sn',get_class($this));}.....function _pear_call_destructors() {global $_pear_destructor_object_list;if (is_array($_pear_destructor_object_list) && sizeof($_pear_destructor_object_list)) {reset($_pear_destructor_object_list);while (list($k, $objref) = each($_pear_destructor_object_list)) {$destructor = '_'.get_class($objref);if (method_exists($objref, $destructor)) {$objref->$destructor();}}//清空已注冊的對象列表，//防止重復(fù)調(diào)用$_pear_destructor_object_list = array();}}....register_shutdown_function('_pear_call_destructors');</code>

上面這段代碼展示了pear是如何實現(xiàn)析構(gòu)函數(shù)的,在構(gòu)件函數(shù)中，將檢查當(dāng)前類中是否有析構(gòu)函數(shù)，如果有，那么將把當(dāng)前類的引用放入一個全局列表中，在_pear_call_destructors中，則檢查這個全局列表中的每個元素是否存在相應(yīng)的析構(gòu)函數(shù)，如果有，則調(diào)用它，最后將全局列表清空。在pear.php的最后一行代碼，則調(diào)用register_shutdown_function('_pear_call_destructors')，注冊_pear_call_destructors，這樣，當(dāng)腳本執(zhí)行完畢的時候，php會回調(diào)這個函數(shù)。使用析構(gòu)函數(shù)，你可以在處理完用戶的請求，退出之前做一些必要的'善后'工作，典型的例子是，你可以關(guān)閉打開的文件，斷開數(shù)據(jù)庫的連接，將某些數(shù)據(jù)存入磁盤等等。錯誤處理pear中可以讓你有很多的方式來處理錯誤，你不僅僅是簡單地返回一個錯誤代碼，或者錯誤的信息，而是可以返回一個pear_error對象，或者是由pear_error派生出來的新的錯誤對象。pear中的錯誤對象的并沒有限定具體的輸出形式，它可以僅僅是捕獲錯誤，不給用戶返回太多的信息，也可以是去回調(diào)一個特殊錯誤處理函數(shù)，同時，即使輸出錯誤信息，它也強(qiáng)迫你必須要是html形式，你可以輸出xml，csv形式，或者是其他你自己定義的形式，你只需要從pear_error派生一個新的類，然后在適當(dāng)?shù)臅r候創(chuàng)建并'拋出'這個新類的對象就可以了。簡單的錯誤處理：在pear中，最簡單的錯誤處理是'拋出'這個錯誤，你只要簡單地創(chuàng)建并返回一個pear_error的對象就可以了。下面是一個簡單的例子：<code>function myconnect($host = 'localhost', $port = 1080){$fp = fsockopen($host, $port, $errno, $errstr);if (!is_resource($fp)) {return new pear_error($errstr, $errno);}return $fp;}$sock = myconnect();if (pear::iserror($sock)) {print 'connect error: '.$sock->getmessage().'<br>n'}</code>

如上面代碼所展示的，在執(zhí)行一段可能產(chǎn)生錯誤的代碼后，你需要使用pear的iserror來檢測是否存在錯誤，并且可以使用pear_error的getmessage來取得最近一次的錯誤信息。注意：一定要在關(guān)鍵的地方使用使用pear::iserror使用raiseerrorphp4.0.5以后，pear多了2個函數(shù)：seterrorhandling($mode, $options = null)raiseerror($message = null, $code = null, $mode = null,$options = null, $userinfo = null)

前者可以設(shè)置pear缺省的錯誤處理模式，后者是一個包裝函數(shù)，返回一個pear_error的對象，和直接創(chuàng)建并返回pear_error的對象略有不同的是，如果省略$mode,$options等參數(shù)，它會使用缺省值來創(chuàng)建這個pear_error的對象，這些缺省值你可以使用seterrorhandling()來定制。pear_errorpear_error是pear的錯誤對象的一個基類，和pear不同，一般來說，你可以直接創(chuàng)建pear_error的實例，創(chuàng)建方式：$error = new pear_error($message, $code, $mode, $options, $userinfo);$message是你的錯誤信息，$code是該錯誤的錯誤號，后3個參數(shù)是緊密聯(lián)系的：$mode:是這個錯誤的處理模式，可以下列常量：pear_error_return：僅僅返回該錯誤對象（缺省方式）pear_error_print：在構(gòu)建函數(shù)中打印這個錯誤信息，但是當(dāng)前程序會繼續(xù)運行。pear_error_trigger：使用php的trigger_error() 觸發(fā)一個錯誤，如果你已經(jīng)設(shè)置了錯誤處理函數(shù)，或者你把php的錯誤處理級別設(shè)置為e_user_error，那么當(dāng)前程序?qū)唤K止。pear_error_die：打印錯誤并退出，程序終止。pear_error_callback：使用一個回調(diào)函數(shù)或者方法來處理當(dāng)前錯誤，程序終止。$options：這個參數(shù)只有在$mode是pear_error_trigger和pear_error_callback的時候才起作用，如果是pear_error_trigger，$options必須是e_user_notice, e_user_warning 或 e_user_error這3個常量的一個，同php中trigger_error的值一致。如果$mode是pear_error_callback，$options可以是一個字符串，內(nèi)容是要回調(diào)的函數(shù)名，也可以是一個2元素的數(shù)組，分別是一個對象變量，和一個字符串（標(biāo)明要調(diào)用的方法）。$userinfo:存放附加的用戶信息，你可以把相關(guān)的調(diào)試信息放在這里。pear_error中有一些常用的方法，這些方法在php文擋沒有描述，這里一一列出：int getmode：返回當(dāng)前的錯誤處理模式,整型。string getmessage：返回當(dāng)前完整的錯誤信息，字符串。mixed getcallback：返回當(dāng)前的回調(diào)信息，可能是所回調(diào)的函數(shù)名，或者是（對象，方法）的數(shù)組。int getcode：返回整型的錯誤代碼。string gettype：返回錯誤的類型，也就是當(dāng)前的類名，字符串。string getuserinfo：返回附加的用戶信息，字符串。string getdebuginfo：內(nèi)容同上。string tostring：返回當(dāng)前對象的詳細(xì)字符串描述，內(nèi)容包括錯誤處理的模式，級別，錯誤信息，錯誤代碼，相關(guān)回調(diào)函數(shù)等等?？偨Y(jié)至此，對于pear的介紹就結(jié)束了。概括地說，如果你要做一個pear的擴(kuò)展應(yīng)用，需要這么做：require_once 'pear.php'使用class your_pear_extend extends pear{}定義你的新類。在你的類的構(gòu)造函數(shù)中，調(diào)用父類pear的構(gòu)造函數(shù)：function your_pear_extend{$this->pear();...}

如果需要，定義你的析構(gòu)函數(shù) _your_pear_extend如果需要，從pear_error派生出你自己的錯誤處理類設(shè)置你的錯誤處理模式，并在適當(dāng)?shù)臅r候觸發(fā)錯誤。在執(zhí)行可能產(chǎn)生錯誤的代碼后，用pear::iserror($obj)捕獲相應(yīng)的錯誤。實現(xiàn)你自己的功能。在最新的php4.05的pear核心發(fā)布里，已經(jīng)有不少優(yōu)秀的應(yīng)用模塊了，比如：phpdoc，cache,html...當(dāng)然，相對于cpan來說，pear只是剛剛起步，需要php社區(qū)的人們的共同努力，來完善它，增強(qiáng)它,php才會越來越強(qiáng)大。相關(guān)資源pear主頁php主頁phpdoc主頁，可以從你的pear應(yīng)用源碼產(chǎn)生類似javadoc的api文檔php-mode for xemacs/emacs,為emacs/xemacs提供php的語法支持，能夠很好支持pear代碼風(fēng)格vim主頁，非常優(yōu)秀的一個編輯器，對php的支持也很好