Fatal error: strict_types declaration must be the very first statement in the script in index.php on line 3
declare(strict_types=1); trebuie să fie prima instrucțiune din fișier, imediat după <?php. Mută linia sus; înaintea ei pot sta doar comentarii.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
declare(strict_types=1); schimbă felul în care PHP verifică tipurile parametrilor: cu el, pret(float $x) nu mai acceptă textul '12', ci aruncă TypeError. Pentru că modul strict se aplică întregului fișier, PHP cere ca declarația să fie prima instrucțiune.
Dacă deasupra ei e o variabilă, un require, un namespace, un echo sau un text în afara tagului PHP (inclusiv BOM sau un rând gol înainte de <?php), compilarea se oprește cu acest mesaj. Ordinea corectă este: <?php, declare(strict_types=1);, namespace ...;, use ...;, apoi restul codului.
De ce apare: cauzele frecvente
1declare pus după cod
<?php
$tva = 0.19;
declare(strict_types=1);<?php
declare(strict_types=1);
$tva = 0.19;Mutată sus, declarația se aplică întregului fișier, cum cere PHP.
2declare pus după namespace
<?php
namespace App;
declare(strict_types=1);<?php
declare(strict_types=1);
namespace App;declare vine înaintea lui namespace, nu după.
Repară eroarea, direct în pagină
Scriptul calculează prețul cu TVA, dar nu pornește: strict_types declaration must be the very first statement in the script. Mută declarația unde trebuie, ca programul să afișeze Preț cu TVA: 119.
<?php
$tva = 0.19;
declare(strict_types=1);
function pretCuTva(float $pret, float $tva): float
{
return round($pret * (1 + $tva), 2);
}
echo 'Preț cu TVA: ' . pretCuTva(100, $tva) . "\n";Preț cu TVA: 119
Indiciu
Linia declare(strict_types=1); trebuie să fie imediat după <?php.
Reparația
<?php
declare(strict_types=1);
$tva = 0.19;
function pretCuTva(float $pret, float $tva): float
{
return round($pret * (1 + $tva), 2);
}
echo 'Preț cu TVA: ' . pretCuTva(100, $tva) . "\n";De ce merge
Modul strict afectează tot fișierul, așa că PHP vrea să-l afle înainte de orice instrucțiune. Atribuirea $tva = 0.19; era deasupra, deci declarația nu mai era prima, iar compilarea s-a oprit.
După mutare, codul rulează. Chiar și în modul strict, 100 (int) e acceptat pentru un parametru float: e singura conversie automată permisă, pentru că nu pierde informație.
Alte forme ale mesajului
PHP Fatal error: strict_types declaration must be the very first statement in the script in /var/www/html/src/Cos.php on line 3Fatal error: strict_types declaration must not use block mode in index.php on line 2
Cum o eviți pe viitor
- Folosește un șablon fix pentru fiecare fișier nou:
<?php+declare(strict_types=1);pe primele două linii. - Unelte precum PHP-CS-Fixer (
declare_strict_types) adaugă și mută automat declarația. - Nu pune nimic înainte de
<?php, nici măcar un rând gol, și salvează fișierele fără BOM.
Întrebări frecvente
Se aplică strict_types și fișierelor incluse?
Nu. Declarația ține doar de fișierul în care e scrisă și privește apelurile făcute din acel fișier. Fiecare fișier trebuie să o declare separat.
Merită să folosesc strict_types?
De obicei da: prinde devreme conversiile ascunse (un preț venit ca text, un null uitat). Ca începător, poate da mai multe erori la început, dar ele arată exact problemele reale.
Erori înrudite
Fatal error: Namespace declaration statement has to be the very first statement or after any declare call in the script in index.php on line 3 Linia namespace trebuie să fie prima instrucțiune din fișier (sau imediat după declare). Mută namespace sus, imediat după <?php. Dacă e deja sus, înainte de <?php ai un spațiu, HTML sau BOM-ul invizibil al fișierului salvat ca UTF-8 cu BOM. Fatal error: Uncaught TypeError: calculeazaRata(): Argument #1 ($luni) must be of type int, string given, called in index.php on line 8 and defined in index.php:2 Funcția cere un int, dar primește un text care nu e număr (de exemplu "12 luni" sau ""). Convertește și validează valoarea înainte de apel, de exemplu cu (int) sau filter_var, sau corectează datele trimise. Î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.
