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.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Un fișier PHP care declară un namespace trebuie să înceapă cu el: înainte pot sta doar <?php, comentarii și declare(strict_types=1);. Orice altă instrucțiune (o variabilă, un echo, un require) sau orice text în afara tagului PHP face ca namespace-ul să nu mai fie primul, iar PHP refuză fișierul la compilare.
Cazul greu de văzut: fișierul pare corect, dar mesajul tot apare. De obicei e vorba de un rând gol sau un spațiu înainte de <?php, sau de BOM (trei octeți invizibili pe care unele editoare îi pun la începutul fișierelor UTF-8). Editorul nu îi arată, dar PHP îi trimite ca text, deci namespace-ul nu mai e primul.
De ce apare: cauzele frecvente
1Cod înainte de namespace
<?php
$versiune = '1.0';
namespace App;<?php
namespace App;
$versiune = '1.0';Variabila e o instrucțiune; după ce o muți sub namespace, fișierul e valid.
2Spațiu, HTML sau BOM înainte de <?php
<?php
namespace App;<?php
namespace App;Orice caracter înainte de <?php e text trimis la ieșire. Salvează fișierul ca „UTF-8” (fără BOM) și șterge rândurile goale de sus.
3require pus deasupra namespace-ului
<?php
require 'vendor/autoload.php';
namespace App\Controllers;<?php
namespace App\Controllers;
require 'vendor/autoload.php';Și require este o instrucțiune. De regulă, autoload-ul se include în fișierul de intrare (index.php), nu în clase.
Repară eroarea, direct în pagină
Fișierul definește o funcție în namespace-ul App, dar nu pornește: Namespace declaration statement has to be the very first statement. Reordonează codul, ca programul să afișeze Salut din App și pe linia următoare Versiunea 1.0.
<?php
$versiune = '1.0';
namespace App;
function salut(): string
{
return 'Salut din ' . __NAMESPACE__;
}
echo salut() . "\n";
echo "Versiunea $versiune\n";Salut din App Versiunea 1.0
Indiciu
Linia namespace App; trebuie să fie imediat după <?php.
Reparația
<?php
namespace App;
$versiune = '1.0';
function salut(): string
{
return 'Salut din ' . __NAMESPACE__;
}
echo salut() . "\n";
echo "Versiunea $versiune\n";De ce merge
PHP trebuie să știe de la început în ce namespace se află tot codul fișierului, de aceea namespace trebuie să fie prima instrucțiune. Atribuirea $versiune = '1.0'; era deasupra lui, așa că fișierul a fost respins la compilare.
După mutare, variabila e definită în același fișier, doar mai jos. Variabilele nu țin de namespace (doar clasele, funcțiile și constantele), deci $versiune funcționează la fel.
Alte forme ale mesajului
PHP Fatal error: Namespace declaration statement has to be the very first statement or after any declare call in the script in /var/www/html/src/Controller.php on line 3Fatal error: Namespace declaration statement has to be the very first statement in the script in index.php on line 3Fatal error: No code may exist outside of namespace {} in index.php on line 9
Cum o eviți pe viitor
- Începe fiecare fișier de clasă la fel:
<?php, eventualdeclare(strict_types=1);, apoinamespace ...;, apoiuse ...;. - Setează editorul să salveze „UTF-8” fără BOM (în VS Code: Save with Encoding → UTF-8).
- Ține un singur namespace per fișier, ca în PSR-4, și nu amesteca într-un fișier clase cu cod care rulează.
Întrebări frecvente
Cum văd dacă fișierul are BOM?
În VS Code, în bara de jos scrie „UTF-8 with BOM”. Din terminal, head -c 3 fisier.php | xxd arată efbbbf la început dacă există BOM.
Pot pune comentarii înainte de namespace?
Da. Comentariile nu sunt instrucțiuni, deci un bloc /** ... */ cu licența sau descrierea fișierului poate sta între <?php și namespace.
Erori înrudite
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. Warning: Cannot modify header information - headers already sent by (output started at index.php:3) in index.php on line 6 Apelezi header() (sau setcookie, session_start) după ce scriptul a trimis deja ceva către browser: un echo, HTML, un spațiu sau o linie goală înainte de <?php. Mută header() înaintea oricărei afișări; locul afișării e cel din output started at. Fatal error: Uncaught Error: Class "Produs" not found in index.php:9 PHP nu găsește definiția clasei: numele e scris greșit, fișierul clasei nu e inclus (sau autoload-ul Composer nu e configurat), ori clasa e într-un namespace și lipsește use. Verifică numele, require-ul sau use-ul. Î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.
