用PEAR来写一个php程序

PEAR中可以让你有很多的方式来处理错误，你不仅仅是简单地返回一个错误代码，或者错误的信息，而是可以返回一个PEAR_Error对象，或者是由PEAR_Error派生出来的新的错误对象。

PEAR中的错误对象的并没有限定具体的输出形式，它可以仅仅是捕获错误，不给用户返回太多的信息，也可以是去回调一个特殊错误处理函数，同时，即使输出错误信息，它也强迫你必须要是HTML形式，你可以输出XML，CSV形式，或者是其他你自己定义的形式，你只需要从PEAR_Error派生一个新的类，然后在适当的时候创建并"抛出"这个新类的对象就可以了。

在PEAR中，最简单的错误处理是"抛出"这个错误，你只要简单地创建并返回一个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>

PEAR_Error是PEAR的错误对象的一个基类，和PEAR不同，一般来说，你可以直接创建PEAR_Error的实例，创建方式：
$error = new PEAR_Error($message, $code, $mode, $options, $userinfo);

• $message是你的错误信息，$code是该错误的错误号，后3个参数是紧密联系的：
• $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必须是E_USER_NOTICE, E_USER_WARNING 或 E_USER_ERROR这3个常量的一个，同PHP中trigger_error的值一致。如果$mode是PEAR_ERROR_CALLBACK，$options可以是一个字符串，内容是要回调的函数名，也可以是一个2元素的数组，分别是一个对象变量，和一个字符串（标明要调用的方法）。
• $userinfo:存放附加的用户信息，你可以把相关的调试信息放在这里。

PEAR_Error中有一些常用的方法，这些方法在PHP文挡没有描述，这里一一列出：

• int getMode：返回当前的错误处理模式,整型。
• string getMessage：返回当前完整的错误信息，字符串。
• mixed getCallback：返回当前的回调信息，可能是所回调的函数名，或者是（对象，方法）的数组。
• int getCode：返回整型的错误代码。
• string getType：返回错误的类型，也就是当前的类名，字符串。
• string getUserInfo：返回附加的用户信息，字符串。
• string getDebugInfo：内容同上。
• string toString：返回当前对象的详细字符串描述，内容包括错误处理的模式，级别，错误信息，错误代码，相关回调函数等等。