trigger_error使用方法

1. trigger_error
2. (PHP 4 >= 4.0.1, PHP 5)
4. trigger_error -- 产生用户级别的 错误/警告/注意 信息
5. 说明
6. bool trigger_error ( string error_msg [, int error_type] )
8. 在脚本中用户输入数据的位置，当用户的输入无效时触发错误的很有用的。
10. 使用trigger_error()函数在处理错误上会更具优势，更易于处理错误。
11. trigger_error()接受一个错误信息和一个常量作为参数。常量为：
13. E_USER_ERROR - 致命的用户生成的 run-time 错误。错误无法恢复。脚本执行被中断。
14. E_USER_WARNING - 非致命的用户生成的 run-time 警告。脚本执行不被中断。
15. E_USER_NOTICE - 默认。用户生成的 run-time 通知。脚本发现了可能的错误，也有可能在脚本运行正常时发生。
17. 返回值：如查错误类型不对，则返回FALSE，否则返回 TRUE
19. 范例
21. $test=2;
22. if ($test>1)
23. {
24. trigger_error("Value must be 1 or below");
25. }
27. 可以设计一个错误处理器，然后再定义一个处理器选择函数set_error_handler()来使用这个错误处理器。
29. 我们或许可以通过trigger_error()生成一个用户警告来代替，使程序更具有灵活性。
31. Index2.php
33. view plaincopy to clipboardprint?
35. // PHP 4
36. require_once('cmd_php4/Command.php');
37. class CommandManager {
38. var $cmdDir = "cmd_php4";
40. function getCommandObject($cmd) {
41. $path = "{$this->cmdDir}/{$cmd}.php";
42. if (!file_exists($path)) {
43. trigger_error("Cannot find $path", E_USER_ERROR);
44. }
45. require_once $path;
47. if (!class_exists($cmd)) {
48. trigger_error("class $cmd does not exist", E_USER_ERROR);
49. }
51. $ret = new $cmd();
52. if (!is_a($ret, 'Command')) {
53. trigger_error("$cmd is not a Command", E_USER_ERROR);
54. }
55. return $ret;
56. }
57. }
59. // PHP 4
60. require_once('cmd_php4/Command.php');
61. class CommandManager {
62. var $cmdDir = "cmd_php4";
64. function getCommandObject($cmd) {
65. $path = "{$this->cmdDir}/{$cmd}.php";
66. if (!file_exists($path)) {
67. trigger_error("Cannot find $path", E_USER_ERROR);
68. }
69. require_once $path;
71. if (!class_exists($cmd)) {
72. trigger_error("class $cmd does not exist", E_USER_ERROR);
73. }
75. $ret = new $cmd();
76. if (!is_a($ret, 'Command')) {
77. trigger_error("$cmd is not a Command", E_USER_ERROR);
78. }
79. return $ret;
80. }
81. }
83. 如果你使用trigger_error()函数来替代die()，你的代码在处理错误上会更具优势，对于客户程序员来说更易于处理错误。trigger_error()接受一个错误信息和一个常量作为参数。常量为：
85. 常量 含义
86. E_USER_ERROR A fatal error
87. E_USER_WARNING A non-fatal error
88. E_USER_NOTICE A report that may not represent an error
90. 你可以设计一个错误处理器，然后再定义一个处理器选择函数set_error_handler()来使用这个错误处理器。
92. Index2.php 后半段
94. view plaincopy to clipboardprint?
96. // PHP 4
97. function cmdErrorHandler($errnum, $errmsg, $file, $lineno) {
98. if($errnum == E_USER_ERROR) {
99. print "error: $errmsg\n";
100. print "file: $file\n";
101. print "line: $lineno\n";
102. exit();
103. }
104. }
106. $handler = set_error_handler('cmdErrorHandler');
107. $mgr = new CommandManager();
108. $cmd = $mgr->getCommandObject('realcommand');
109. $cmd->execute();
111. // PHP 4
112. function cmdErrorHandler($errnum, $errmsg, $file, $lineno) {
113. if($errnum == E_USER_ERROR) {
114. print "error: $errmsg\n";
115. print "file: $file\n";
116. print "line: $lineno\n";
117. exit();
118. }
119. }
121. $handler = set_error_handler('cmdErrorHandler');
122. $mgr = new CommandManager();
123. $cmd = $mgr->getCommandObject('realcommand');
124. $cmd->execute();
126. set_error_handler()接受一个函数名作为参数。如果触发了一个错误，参数中的这个函数会被调用来处理错误。函数需要传入四个参数：错误标志，错误信息，出错文件，出错处的行数。你也可以将一组数组传递给set_error_handler()。数组中的第一个元素必须是错误处理器将调用的对象，第二个元素是错误处理函数的名称。可以看出，我们的错误处理器相当简单简陋，还可以改进。然而尽管你可以在错误处理器添加某些功能，如记录出错信息，输出debug数据等，这仍然是一个过于粗糙的错误处理途径。你的选择仅限于已经考虑到的出错情况。例如捕捉一个E_USER_ERROR错误
127. 如果你愿意的话可以不中止脚本的执行(不使用exit()和die())，但如果这样做的话，可能会引起一些很微妙的bug，本来应该中止的程序却继续执行了。