利用PHP自定义错误处理器处理出错信息

假如您是PHP老手，当然知道当PHP脚本出错时发生了什么事情。此时PHP解析器将在屏幕上给出错误信息，如 Fatal error: Call to undefined function on line 19 --，因此程序在此处终止。这个信息会吓到客户，他可能立即打电话和你进行咨询。

幸运的是，这里有解决办法。PHP拥有内置工具，可以让开发人员捕捉脚本错误然后将它们转到自定义的错误处理器。此时则可以对处理器进行编程显示更多关于错误的具体信息。还可以将错误写入文件或数据库以采取补救措施。有时候还可以对处理器编写程序忽略错误消息。

本文中，我将阐述如何使用PHP的错误处理API构建用户自定义的错误处理器，并且说明如何以简单而友好的方式显示和治理脚本的错误信息。

错误类型和报告级别

我们从最基本的开始。PHP有三种最基本的错误类型，从低级到高级分别为：注重、警告和错误（或致命错误）。通常情况下，注重和警告不会终止程序；但是致命错误则是危险故障（例如，调用一个没有定义的函数或参考一个不存在的对象），将导致程序中断。这些错误有可能在启动、解析、编译或运行时发生。

要害字如E_NOTICE, E_ERROR等用于表明错误的不同类型和等级。在PHP手册上可以获得它们的具体信息列表。

脚本阶段错误显示由error_reporting()函数进行控制。这一函数针对不同的错误等级设置不同的参数。表A给出了使用此函数报告警告和致命错误的脚本程序。

表A

<?php
// display warnings and errors
error_reporting(E_WARNING | E_ERROR);
// this will generate a notice, which will never be displayed
echo $undefinedVar;
// this will generate a fatal error, which will be displayed
callUndefFunc();
?>

将表B中的代码与上面的进行比较发现，Listing B中隐藏错误信息甚至隐藏致命信息，使得错误信息不会被显示出来。

表B

<?php
// turn off error display
// no errors will be displayed
error_reporting(0);
// this will generate a notice
echo $undefinedVar;
// this will generate a fatal error
callUndefFunc();
?>

表C中的代码将所有错误信息甚至简单的注重事项都显示出来：

表C

<?php
// all errors will be displayed
error_reporting(E_ALL);
// this will generate a notice
echo $undefinedVar;
// this will generate a fatal error
callUndefFunc();
?>

如以上3个例子所示，error_reporting()函数在控制错误发生时，在屏幕上显示内容非常重要。这里的要害字是displayed，其表达的意思是错误不被显示而不是错误没有发生。因此，发生致命错误时（例如不正确的函数调用），程序将被终止；但是，此时没有任何消息显示给用户。

前言：

　　PHP中对各类数据库的操作有着支持，对文件的操作也同样有着很丰富的操作方法，很多朋友现在的操作还是基于文件操作可是有的时候在操作文件的时候还存在不少的困惑和疑点，以下是我在日常编写过程中碰到的以及坛上朋友所碰到的关于文件操作的一些问题收藏吧。

　　问：如何新建一个文件？

　　答：

　　1、使用fopen(要建立的文件名,参数)，参数可选w,w ,a,a

　　2、使用exec(echo '' > 要建立的文件名);这样是使用系统方式建立这个文件，你还可以使用touch这个linux命令来建立

　　问：为什么我无法建立文件？

　　答：

　　1、假如你使用了fopen建立文件，是否正确的使用了参数

　　2、系统权限问题，请询问你的WEBMASTER你的FTP目录是否有写的权限

　　3、FTP权限问题，你要确认你的PHP文件所要写文件所在目录要有写的权限，也就是你的FTP软件登陆后other组要有写这个权限，
假如没有请修改权限后尝试

　　问：如何将文件读入数组？

　　答：使用file函数

　　问：如何将文件全部读出？

　　答：
　
　　1、使用fread($fp);

　　2、假如你的PHP版本>=4.3.0的话可以使用file_get_contents();

　　问：如何判定文件是否存在？

　　答：使用file_exists();

　　再问:为什么不使用fopen()来判定呢？

　　答:原因是有时候是因为权限问题导致fopen返回的数据引导我们错误的判定

　　问：为什么当我读取一个WEB页面的时候出错？

　　答：

　　1、可能是你的传递参数错，当读取WEB页面的时候你只可以使用r方式读取页面

　　2、确保你要读取的WEB页面可以访问

　　问：我如何才能获得文件的相关属性？

　　答：PHP提供了一组获得文件属性的方法，例如 filemtime(),fileowner(),filegroup(),filectime(),fileatime()...具体的使用请参阅手册。

　　问：PHP打开文件后是否可以象C一样进行文件“游标”的定位呢？

　　答：可以的，使用fseek();

　　问：我想在访问文件的时候不答应其他人也访问此文件，怎么办？

　　答：

　　1、你可以采用其他方面程序限制用户接入文件操作的页面

最近在写bbs中，遇上代码转换问题。寻找了很久，才得到一个比较完善的解决办法，可以彻底还原发文者的原文。
以下贴出，供大家指正。
系统：linux php4 oracle8i

<?
//--标题,名字等字段入库处理(去首尾空格)
function trans_string_trim($str) {
$str=trim($str);
$str=eregi_replace("'","''",$str);
$str=stripslashes($str);
return $str;
}

//--文章入库处理，即textarea字段；
function trans_string($str) {
$str=eregi_replace("'","''",$str);
$str=stripslashes($str);
return $str;
}

//--从库中显示在表单中；在text中以trans转换,在textarea中,无需转换,直接显示

//--显示在WEB页面，过滤HTML代码；包括链接地址
function trans($string) {
$string=htmlspecialchars($string);
$string=ereg_replace(chr(10),"<br>",$string);
$string=ereg_replace(chr(32)," ",$string);
return $string;
}

//--显示在WEB页面，不过滤HTML代码；
function trans_web($string) {
$string=ereg_replace(chr(10),"<br>",$string);
$string=ereg_replace(chr(32)," ",$string);
return $string;
}

//--显示在WEB页面，过滤HTML代码及头尾空格,主要用于显示用户昵称
function trans_trim($string) {
$string=trim($string);
$string=htmlspecialchars($string);
$string=ereg_replace(chr(10),"<br>",$string);
$string=ereg_replace(chr(32)," ",$string);
return $string;
}

//--显示在span中；
function trans_span($string) {
$string=ereg_replace(chr(10),"n",$string);
$string=ereg_replace(chr(32)," ",$string);
$string=ereg_replace('"',""",$string);
return $string;
}

//--在WEB上显示cookie,过滤html
function trans_cookie($str) {
$str=trans($str);
$str=stripslashes($str);
$str=eregi_replace("''","'",$str);
return $str;
}
?>
---------------------------
最后，顺带补充一点，假如在span中显示文章中的一段，采用substr取定长字符串时，记得在span的参数后面多加一个空格，否则遇上截到半个汉字时，会搞乱html代码。

本文举例说明了创建可配置 PHP 应用程序的几种方法。文中也探讨了应用程序中理想的配置点，并在应用程序过分可配置和过分封闭之间寻求一个平衡点。

　　假如计划让其他人或公司可以使用您的 PHP 应用程序，需要确保该程序是可配置的。至少，要答应用户以一种安全的方式设置数据库登录及密码，从而使其中的材料不会对外公开。

　　本文展示了几种用于存储配置设置及编辑这些设置的技术。另外，文中也为哪些元素需要设为可配置以及如何避免陷入配置过度或者配置不足的困境提供了指导。

　　使用 INI 文件进行配置

　　PHP 内建了对配置文件的支持。这是通过 php.ini 文件这样的初始化文件（INI）机制实现的，在 php.ini 文件中定义了数据库连接超时或会话如何存储等常量。假如愿意的话，可以在这个 php.ini 文件中为应用程序定制配置。为了说明，我将下列代码行添加到 php.ini 文件中。

　　myapptempdir=foo

　　然后，我编写了一个小 PHP 脚本来读取这个配置项，如清单 1 所示。

　　清单 1. ini1.php

<?php
function get_template_directory()
{
　$v = get_cfg_var( "myapptempdir" );
　return ( $v == null ) ? "tempdir" : $v;
}

echo( get_template_directory()."n" );
?>

　　当在命令行中运行这段代码时，得到如下结果：

% php ini1.php
foo
%

　　太棒了。但为什么不能用标准的 INI 函数来获取 myapptempdir 配置项的值呢？我研究了一下，发现在大多数情况下，定制配置项不能使用这些方法来获取。然而，使用 get_cfg_var 函数却是可以访问的。

　　为使这个方法更加简单，将对变量的访问封装在第二个函数中，该函数使用配置键名及一个缺省值作为参数，如下所示。

　　清单 2. ini2.php

function get_ini_value( $n, $dv )
{
　$c = get_cfg_var( $n );
　return ( $c == null ) ? $dv : $c;
}

function get_template_directory()
{
　return get_ini_value( "myapptempdir", "tempdir" );
}

　　这是对如何访问 INI 文件的一个很好的概括，所以，假如要使用一个不同的机制或将这个 INI 文件存储到其他位置，就不需要为更改大量的函数而大费周折。

　　我不推荐使用 INI 文件作为应用程序的配置，这有两个理由。首先，虽然这样做较轻易读取 INI 文件，但却几乎不可能安全地写 INI 文件。所以这样做只适合于只读配置项。第二，php.ini 文件在服务器的所有应用程序上共享，所以我认为特定于应用程序的配置项不应该写在该文件中。

　　需要对 INI 文件了解什么呢？最重要的是如何重置 include 路径来添加配置项，如下所示。

　　清单 3. ini3.php

<?php
echo( ini_get("include_path")."n" );
ini_set("include_path",
ini_get("include_path").":./mylib" );
echo( ini_get("include_path")."n" );
?>

　　在本例中，我将我的本地 mylib 目录添加到了 include 路径中，所以能够从该目录中 require PHP 文件，而不需要将该路径添加到 require 语句中。

　　PHP 中的配置

　　通常对于在 INI 文件中存储配置条目的一个替代办法是使用一个简单的 PHP 脚本来保持数据。如下是一个样例。

　　清单 4. config.php

<?php
# Specify the location of the temporary directory
#
$TEMPLATE_DIRECTORY = "tempdir";
?>

　　使用该常量的代码如下所示。

测试硬件说明：
测试使用的是我的爱机，配置如下：
CPU：C433
内存：128M
硬盘：酷鱼2代20G

测试软件说明：
WIN32下用的是windows nt server4,sp5,apache 1.3.12,php3.0.15和php4rc1,mysql 3.22.29,oracle 8.0.5
linux下用的是bluepoint linux1.0, apache 1.3.12, php4rc1,mysql 3.22.32

测试代码说明：
使用一个很简单的表，mysql和oracle使用的表结构是一样的，都只有三个字段，结构如下：
mysql的表结构：
CREATE TABLE board (
board_id smallint(6) NOT NULL auto_increment,
board_name char(16) NOT NULL,
board_manager char(20),
PRIMARY KEY (board_id)
);
oracle的结构：
CREATE TABLE PHP_ORACLE."BOARD"
("BOARD_ID" FLOAT,
"BOARD_NAME" CHAR(16) NOT NULL,
"BOARD_MANAGER" CHAR(20)) ;

我们只测试了INSERT操作花的时间，对于select，并未作测试。
因为win32下只有PHP3才能连接oracle数据库，所以只测试了用PHP3连接oracle的性能。相
信在PHP4的正式版本出来后，用PHP4连接oracle的速度应该有所提升。
而在LINUX下，因为我没有装oracle，所以只测试了mysql的性能。据说在LINUX下，oracle
的性能不错，只是无法测试。
并且我们将所有的用于数据库连接和oracle用来分析sql语句的代码都放在了统计代码之外
，所以测试得出的时间只是用于执行SQL操作所花费的时间。

用来测试mysql的程序：

<?php
$dblink=mysql_connect("localhost","root","shh123");
mysql_select_db("bbs");
$counter=1;
set_time_limit(300);
$query="insert into board (board_name,board_manager) values ('test','test')";
$begin_time=time();
for ($i=1;$i<=10000;$i ){
mysql_db_query("bbs",$query);
$counter ;
}
$end_time=time();
mysql_close($dblink);
echo "test db speed...<br>";
echo "begin time:".$begin_time."<BR>";
echo "<BR>end time:".$end_time."<BR>";