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
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,DomainExceptionsau 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
<?php
function imparte(float $a, float $b): float
{
if ($b == 0) {
trigger_error('Împărțire la zero', E_USER_ERROR);
}
return $a / $b;
}<?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
<?php
if (!getenv('DB_HOST')) {
trigger_error('Lipsește DB_HOST', E_USER_ERROR);
}<?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ă
<?php
trigger_error('Funcția veche va dispărea', E_USER_ERROR);<?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ă 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.
<?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";Eroare: Împărțire la zero
Indiciu
throw new InvalidArgumentException('Împărțire la zero'); iar apelul pune-l într-un try/catch.
Reparația
<?php
function imparte(float $a, float $b): float
{
if ($b == 0) {
throw new InvalidArgumentException('Împărțire la zero');
}
return $a / $b;
}
try {
echo imparte(10, 0) . "\n";
} catch (InvalidArgumentException $e) {
echo 'Eroare: ' . $e->getMessage() . "\n";
}De ce merge
E_USER_ERROR e învechit din PHP 8.4: genera o eroare fatală care nu putea fi prinsă și oprea tot scriptul.
Cu throw new InvalidArgumentException(...), funcția semnalează problema, iar codul care o apelează decide ce face: aici o prinde în catch și afișează un mesaj, fără să oprească programul.
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 22Fatal 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_errordoar pentruE_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
Fatal error: Uncaught Exception: Stoc insuficient pentru Rucsac in index.php:6 Codul aruncă o excepție (cu throw) pe care nu o prinde nimeni, așa că scriptul se oprește. Pune apelul care poate eșua într-un try și tratează excepția în catch (de exemplu afișezi mesajul și continui). Fatal error: Uncaught DivisionByZeroError: Division by zero in index.php:4 Împarți un număr la zero, de obicei la o variabilă care a ajuns 0 (o listă goală, un câmp necompletat). Verifică împărțitorul înainte de împărțire sau prinde DivisionByZeroError cu try/catch. Deprecated: Constant E_STRICT is deprecated since 8.4, the error level was removed in index.php on line 3 Codul tău (de obicei un error_reporting(E_ALL & ~E_STRICT) dintr-un fișier de configurare vechi) folosește constanta E_STRICT, scoasă din uz în PHP 8.4. Nivelul E_STRICT nu mai e folosit din PHP 8.0. Șterge pur și simplu partea cu E_STRICT: error_reporting(E_ALL & ~E_DEPRECATED). Î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.
