user_error()

user_error() — Alias of trigger_error().

Built-in function of PHP 8.5. The manual lists it as available in PHP 4, PHP 5, PHP 7, PHP 8. This page is the reference card: signature, parameters and return value, plus the changelog and the example the manual provides.

user_error() is an alias of trigger_error(): same parameters, same return value.

Signature

user_error(string $message, int $error_level = E_USER_NOTICE): true

Parameters

Parameter	Type	What it takes
$message	string	The designated error message for this error. It's limited to 1024 bytes in length. Any additional characters beyond 1024 bytes will be truncated.
$error_level	int	The designated error type for this error. It only works with the E_USER_* family of constants, and will default to E_USER_NOTICE.

Return value

Always returns true.

Example

A runnable snippet:

$password = $_POST['password'] ?? ''; if ($password === '') { trigger_error("Using an empty password is unsafe", E_USER_WARNING); } $hash = password_hash($password, PASSWORD_DEFAULT);

All PHP 8.5 built-in functions

Reference card built from the PHP manual page user_error() (PHP documentation, CC BY 3.0). The page is generated from the manual, so the wording of the parameter and return value text follows php.net.