PHP使用pear擴展包的方法

這篇文章主要講解了“PHP使用pear擴展包的方法”，文中的講解內容簡單清晰，易于學習與理解，下面請大家跟著小編的思路慢慢深入，一起來研究和學習“PHP使用pear擴展包的方法”吧！

PEAR的編碼規則包括縮進規則，控制結構，函數調用，函數定義，注釋，包含代碼，PHP標記，文件頭的注釋塊，CVS標記，URL樣例，常量的命名這11方面。下面簡要地介紹一下

apt-get install php-pear

pear install channel://pear.php.net/PHP_ArrayOf-0.2.1

pear download channel://pear.php.net/PHP_ArrayOf-0.2.1

ＰＥＡＲ的編碼規則

PEAR的編碼規則包括縮進規則，控制結構，函數調用，函數定義，注釋，包含代碼，PHP標記，文件頭的注釋塊，CVS標記，URL樣例，常量的命名這11方面。下面簡要地介紹一下：

縮進規則：

PEAR中需要使用4個空格來縮排代碼，并且不使用TAB。如果你使用VIM，將下列設置放入你的~/.vimrc中：

set expandtabset shiftwidth=4set tabstop=4

如果，你使用Emacs/XEmacs,需要把indent-tabs-mode 設置成nil。

不過你象我一樣喜歡用(X)Emacs編輯PHP文件，我強烈推薦你安裝PHP-MODE，這樣當你編寫PEAR代碼的時候，它會自動調整你的縮排風格，當然PHP-MODE還有許多很優秀的特性，你可以從資源列表中的地方下載最新版的PHP-MODE。

控制結構：

這里所說的控制結構包括: if for while switch 等。對于控制結構，在關鍵字（如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);

函數定義：

函數定義遵循"one true brace"習俗：

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;
  }

如上所示，可選參數要在參數表的末端，并且總是盡量返回有意義的函數值。          

關于注釋：          

對于類的在線文檔，應該能夠被PHPDoc轉換，就象JavaDoc那樣。PHPDoc也是一個PEAR的應用程序，更詳細的介紹你可以去 http://www.phpdoc.de/ 查看。除了類的在線文檔，建議你應該使用非文檔性質的注釋來詮釋你的代碼，當你看到一段代碼時想：哦，我想不需要在文檔里去仔細描述它吧。那么你最好給這段代碼作一個簡單的注釋，這樣防止你會忘記它們是如何工作的。對于注釋的形式，C的 /* */和C++的//都不錯，不過，不要使用Perl或者shell的#注釋方式。

包含代碼：          

無論什么時候，當你需要無條件包含進一個class文件，你必須使用requre_once;當你需要條件包含進一個class文件，你必須使用include_once;這樣可以保證你要包含的文件只會包含一次，并且這2個語句共用同一個文件列表，所以你無須擔心二者會混淆，一旦require_once 包含了一個文件，include_once不會再重復包含相同的文件，反之亦然。

PHP代碼標記：          

任何時候都要使用<?php ?>定義你的php代碼，而不要簡單地使用<? ?>,這樣可以保證PEAR的兼容性，也利于跨平臺的移植。

文件頭的注釋聲明：          

所有需要包含在PEAR核心發布的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.net so we can mail you a copy immediately.               |// +----------------------------------------------------------------------+// | Authors: Original Author                         |// |          Your Name                                  |// +----------------------------------------------------------------------+//// $Id$

對于不在PEAR核心代碼庫中的文件，建議你也在文件的開始處有這樣一個類似的注釋塊，標明版權，協議，作者等等。同時也在第一行加入VIM的MODELINE，這樣在VIM中能夠保持PEAR的代碼風格。

CVS標記：

如上面所展示那樣，在每個文件中加入CVS的ID標記，如果你編輯或修改的文件中沒有這個標記，那么請加入，或者是替換原文件中相類似的表現形式（如"Last modified"等等）

URL樣本：          

你可以參照RFC 2606,使用"www.example.com"作為所有的URL樣本。

常量命名：          

常量應該盡量使用大寫，為了便于理解，使用下劃線分割每個單詞。同時，你應該常量所在的包名或者是類名作為前綴。比如，對于Bug類中常量應該以Bug_開始。以上是PEAR的編碼規則，詳細的編碼規則可以參考PEAR中的CODING_STANDDARD文件的說明。為了更好地理解這些編碼規則，你也可以參考一下現有PEAR核心模塊的代碼。

感謝各位的閱讀，以上就是“PHP使用pear擴展包的方法”的內容了，經過本文的學習后，相信大家對PHP使用pear擴展包的方法這一問題有了更深刻的體會，具體使用情況還需要大家實踐驗證。這里是億速云，小編將為大家推送更多相關知識點的文章，歡迎關注！