...
Eroare PHP · Mesaje Deprecated la upgrade de versiune

Deprecated: Passing E_USER_ERROR to trigger_error() is deprecated since 8.4, throw an exception or call exit with a string message instead in index.php on line 5

Pe scurt

Din PHP 8.4 nu mai e recomandat să oprești scriptul cu trigger_error('...', E_USER_ERROR). Aruncă o excepție (throw new RuntimeException('...')) și prinde-o unde poți trata eroarea, sau, într-un script CLI, oprește-te cu exit('mesaj').

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

trigger_error($mesaj, E_USER_ERROR) genera o eroare fatală „de utilizator”: PHP afișa mesajul și oprea scriptul. Problema e că o astfel de eroare nu poate fi prinsă cu try/catch, nu rulează blocurile finally și sare peste curățenia normală. Din PHP 8.4, folosirea lui E_USER_ERROR afișează acest Deprecated, înainte de eroarea fatală propriu-zisă.

Mesajul îți dă alternativele:

  • excepții (throw new RuntimeException(...), InvalidArgumentException, DomainException sau o clasă proprie) când codul care apelează poate reacționa;
  • exit('mesaj') într-un script de linie de comandă, unde chiar vrei să oprești totul.

E_USER_WARNING, E_USER_NOTICE și E_USER_DEPRECATED rămân valide pentru avertismente care nu opresc execuția.

De ce apare: cauzele frecvente

1Validare care oprește scriptul

Greșit
PHP
<?php
function imparte(float $a, float $b): float
{
    if ($b == 0) {
        trigger_error('Împărțire la zero', E_USER_ERROR);
    }
    return $a / $b;
}
Corect
PHP
<?php
function imparte(float $a, float $b): float
{
    if ($b == 0) {
        throw new InvalidArgumentException('Împărțire la zero');
    }
    return $a / $b;
}

Excepția poate fi prinsă de cel care apelează funcția, iar finally rulează normal.

2Configurare lipsă într-un script CLI

Greșit
PHP
<?php
if (!getenv('DB_HOST')) {
    trigger_error('Lipsește DB_HOST', E_USER_ERROR);
}
Corect
PHP
<?php
if (!getenv('DB_HOST')) {
    fwrite(STDERR, "Lipsește DB_HOST\n");
    exit(1);
}

Scriptul se oprește explicit, cu mesaj pe ieșirea de erori și cod de ieșire diferit de 0.

3Avertisment care nu trebuie să oprească

Greșit
PHP
<?php
trigger_error('Funcția veche va dispărea', E_USER_ERROR);
Corect
PHP
<?php
trigger_error('Funcția veche va dispărea', E_USER_DEPRECATED);

Pentru anunțuri, E_USER_DEPRECATED sau E_USER_WARNING sunt nivelul potrivit.

Repară tu

Repară eroarea, direct în pagină

Funcția imparte oprește scriptul cu trigger_error(..., E_USER_ERROR), iar PHP 8.4 afișează Deprecated: Passing E_USER_ERROR to trigger_error() is deprecated. Aruncă o InvalidArgumentException și prinde-o la apel, ca programul să afișeze Eroare: Împărțire la zero.

Codul care dă eroarea
PHP
<?php
function imparte(float $a, float $b): float
{
    if ($b == 0) {
        trigger_error('Împărțire la zero', E_USER_ERROR);
    }
    return $a / $b;
}

echo imparte(10, 0) . "\n";
După reparație, programul afișează
Eroare: Împărțire la zero
Indiciu

throw new InvalidArgumentException('Împărțire la zero'); iar apelul pune-l într-un try/catch.

Alte forme ale mesajului

  • PHP Deprecated: Passing E_USER_ERROR to trigger_error() is deprecated since 8.4, throw an exception or call exit with a string message instead in /var/www/html/src/Validator.php on line 22
  • Fatal error: Împărțire la zero in index.php on line 5

Cum o eviți pe viitor

  • Folosește excepții pentru erorile din funcții și clase; alege clase cu sens (InvalidArgumentException, RuntimeException) sau creează-ți propriile excepții.
  • Păstrează trigger_error doar pentru E_USER_WARNING, E_USER_NOTICE, E_USER_DEPRECATED.
  • Caută E_USER_ERROR în proiect când treci la PHP 8.4.
  • Un handler global (set_exception_handler) poate afișa o pagină de eroare prietenoasă pentru excepțiile neprinse.

Întrebări frecvente

Scriptul tot se oprește. De ce mai contează?

Pentru că o eroare fatală nu poate fi tratată: nu o poți prinde, nu poți închide frumos o tranzacție, nu poți afișa o pagină de eroare. Cu excepții, toate acestea devin posibile.

set_error_handler mai prinde E_USER_ERROR?

Da, încă îl primește, dar nivelul e învechit și va dispărea. Mută logica în excepții și în set_exception_handler.

Erori înrudite

← Toate erorile PHP

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Învață PHP de la zero, cu exerciții la fiecare lecție

Curs PHP: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.