...
Eroare PHP · Erori de sintaxă (Parse error)

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

Pe scurt

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

Greșit
PHP
<?php
$versiune = '1.0';
namespace App;
Corect
PHP
<?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

Greșit
PHP
 <?php
namespace App;
Corect
PHP
<?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

Greșit
PHP
<?php
require 'vendor/autoload.php';
namespace App\Controllers;
Corect
PHP
<?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ă tu

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.

Codul care dă eroarea
PHP
<?php
$versiune = '1.0';

namespace App;

function salut(): string
{
    return 'Salut din ' . __NAMESPACE__;
}

echo salut() . "\n";
echo "Versiunea $versiune\n";
După reparație, programul afișează
Salut din App
Versiunea 1.0
Indiciu

Linia namespace App; trebuie să fie imediat după <?php.

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 3
  • Fatal error: Namespace declaration statement has to be the very first statement in the script in index.php on line 3
  • Fatal 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, eventual declare(strict_types=1);, apoi namespace ...;, apoi use ...;.
  • 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

← 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.