PHP trigger_error()用法及代码示例

trigger_error() 函数是 PHP 中的一个内置函数，能够充当 内置 错误处理程序。该函数通常被程序员用来触发或生成用户级错误、通知或消息。它返回一个布尔值，即在表达式成功时返回 TRUE，在表达式失败时返回 FALSE。

用法:

bool trigger_error(string $message, int $error_level);

这里，$message 参数是要显示的消息，它是字符串类型，而 $error_level 用于描述必须显示的错误类型，它是整数类型。对于任何 trigger_error() 函数，$message 是必需的，$error_level 可以根据用户要求是可选的，$message 的最大长度为 1024 字节。

范例1：在此示例中，用户定义的函数 doFunction($var) 接受一个值作为该函数内的参数，如果该值是数字，则将检查参数，然后 $var.“is numeric” 将被打印，否则将引发错误带有消息“变量必须是数字”，这是通过 trigger_error() 函数完成的。

<?php
  
function doFunction($var) {
    if(is_numeric($var)) {
        echo $var.' is numeric';
    } 
      else {
        trigger_error('variable must be numeric');
    }
}
  
$new_var = 'GFG';
doFunction($new_var);
  
?>

输出：

PHP Notice: variable must be numeric in 
/home/d87c8897dcede28086b7e4f06f5fafc7.php on line 9\

范例2：默认情况下，使用 trigger_error() 函数将生成 PHP 通知，但用户也可以通过在 trigger_error() 函数中添加参数来生成 PHP 错误或 PHP 警告，如下例所示。

在此示例中，我们创建了一个除法函数，如果 $second 的值等于 0，则该函数接受两个参数，trigger_error() 函数将抛出 PHP 致命错误，因为在参数中 E_USER_ERROR 与错误消息一起传递给 trigger_error()，如果$second 的值不等于 0，然后 $first 将除以 $second 并显示结果。

<?php
    
function divide($first,$second) {
    
    if ($second == 0) {
        trigger_error("Cannot divide by zero", E_USER_ERROR);
      }
      else {
        echo $first/$second ;    
      }
}
  
divide(2,0)
  
?>

输出：

PHP Fatal error: Cannot divide by zero in 
/home/5152fc6f9b996848e7b1f855e7d0b5b9.php on line 6

参考： https://www.php.net/manual/en/function.trigger-error.php