18.3 cgitb – CGI脚本的追踪管理器
2.2版本中新的特性。cgitb模块为Python脚本提供一个指定异常处理。（它的名称有点使人误解。它原本地设计是为CGI脚本显示广泛的追踪信息。后来被推广为也用简单的文本显示这些信息。）该模块被激活后，如果一个不能捕获的异常发生，一个详细的，格式化的报告将被显示。报告包含一个每个级别的源代码追踪显示摘要，不但参数的值而且当前运行函数的本地变量，帮助你调试问题。可选地，你可以保存这些信息到一个文件中替代发送到客户端。
启用这个功能，简单地在你的CGI脚本头部添加一行:
import cgitb; cgitb.enable()
enable()函数控制可选是否报告显示在浏览器中和是否报告为以后的解析被记录到一个文件中。
enable([display[, logdir[, context[, format]]]])
这个函数导致cgitb模块覆盖编译器通过sys.excepthook的值设置的缺省处理。
可选参数display缺省为1，可以被设置为0禁止发送追踪到浏览器。如果参数logdir是present，追踪报告被写入文件中。logdir的值应该是一个这些文件将被放置的文件夹。可选参数context是要显示的追踪中源代码当前行周围的上下文的行数；缺省为5。如果可选参数format是”html”，输出被格式为HTML。任何其他的值强制简单的文本输出。缺省值是”html”。
handler([info])
这个函数用缺省的设置处理一个异常（在浏览器中显示报告，但是不记录到文件中）。当你已经捕捉到一个异常并想用cgitb报告它时可以使用。可选info参数应该是一个3元组，包含一个异常类型，异常值，追踪对象，绝对像由sys.exc_info()返回的元组。如果info参数没有被提供，当前的异常从sys.exe_info()中获取。
出处PYTHON中国（[url=http://www.okpython.com]www.okpython.com[/url]），关于翻译的任何事情请EMAIL给我zkfarmer([email]zkfarmer@gmail.com[/email]),更多文档在我的站点([url=http://www.zkfarmer.org]www.zkfarmer.org[/url])。[color=Green]请参阅官方英文文档[/color]。
页:
[1]