[CodeIgniter4]-错误处理

错误处理

CodeIgniter 通过 SPL collection 和一些框架内自定义异常来生成系统错误报告。错误处理的行为取决于你部署环境的设置，当一个错误或异常被抛出时，只要应用不是在 production 环境下运行，就会默认展示出详细的错误报告。在这种情况下，应为用户显示一个更为通用的信息来保证最佳的用户体验。

• 使用异常处理
• 配置
• 自定义异常
  • PageNotFoundException
  • ConfigException
  • UnknownFileException
  • UnknownClassException
  • UnknownMethodException
  • UserInputException
  • DatabaseException

使用异常处理

本节为新手程序员或没有多少异常处理使用经验的开发人员做一个简单概述。

异常处理是在异常被”抛出”的时候产生的事件。它会暂停当前脚本的执行，并将捕获到的异常发送到错误处理程序后显示适当的错误提示页

throw new Exception("Some message goes here");

如果你调用了一个可能会产生异常的方法，你可以使用 try/catch block 去捕获异常

try {
        $user = $userModel->find($id);
}
catch (Exception $e)
{
        die($e->getMessage());
}

如果 $userModel 抛出了一个异常，那么它就会被捕获，并执行 catch 代码块内的语句。在这个样例中，脚本终止并输出了 UserModel 定义的错误信息。

在这个例子中，我们可以捕捉任意类型的异常。如果我们仅仅想要监视特定类型的异常，比如 UnknownFileException，我们就可以把它在 catch 参数中指定出来。这样一来，其它异常和非监视类型子类的异常都会被传递给错误处理程序

catch (CodeIgniterUnknownFileException $e)
{
        // do something here...
}

这便于你自己进行错误处理或是在脚本结束前做好清理工作。如果你希望错误处理程序正常运行，可以在 catch 语句块中再抛出一个新的异常

catch (CodeIgniterUnknownFileException $e)
{
        // do something here...

        throw new RuntimeException($e->getMessage(), $e->getCode(), $e);
}

配置

默认情况下，CodeIgniter 将在 development 和 testing 环境中展示所有的错误，而在 production 环境中不展示任何错误。你可以在主 index.php 文件的顶部找到环境配置部分来更改此设置。

重要

如果发生错误，禁用错误报告将不会阻止日志的写入。

自定义异常

下列是可用的自定义异常:

PageNotFoundException

这是用来声明 404 ，页面无法找到的错误。当异常被抛出时，系统将显示后面的错误模板 /application/views/errors/html/error_404.php。你应为你的站点自定义所有错误视图。如果在 Config/Routes.php 中，你指定了404 的重写规则，那么它将代替标准的 404 页来被调用

if (! $page = $pageModel->find($id))
{
        throw new CodeIgniterPageNotFoundException();
}

你可以通过异常传递消息，它将在 404 页默认消息位置被展示。

ConfigException

当配置文件中的值无效或 class 类不是正确类型等情况时，请使用此异常

throw new CodeIgniterConfigException();

它将 HTTP 状态码置为 500，退出状态码被置为 3.

UnknownFileException

在文件没有被找到时，请使用此异常

throw new CodeIgniterUnknownFileException();

它将 HTTP 状态码置为 500，退出状态码被置为 4.

UnknownClassException

当一个类没有被找到时，请使用此异常

throw new CodeIgniterUnknownClassException($className);

它将 HTTP 状态码置为 500，退出状态码被置为 5.

UnknownMethodException

当一个类的方法不存在时，请使用此异常

throw new CodeIgniterUnknownMethodException();

它将 HTTP 状态码置为 500，退出状态码被置为 6.

UserInputException

当用户的输入无效时，请使用此异常

throw new CodeIgniterUserInputException();

它将 HTTP 状态码置为 500，退出状态码被置为 7.

DatabaseException

当产生如连接不能建立或连接临时丢失的数据库错误时，请使用此异常

throw new CodeIgniterDatabaseException();

它将 HTTP 状态码置为 500，退出状态码被置为 8.