...
Eroare PHP · Funcții și argumente

Fatal error: A void function must not return a value in index.php on line 4

Pe scurt

Funcția e declarată cu tipul de retur void (nu întoarce nimic), dar are un return cu valoare. Decide: dacă funcția trebuie să întoarcă ceva, schimbă tipul (: string, : float...); dacă nu, scrie doar return; fără valoare.

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

Ce înseamnă

: void după parametri promite că funcția nu întoarce nimic: doar face ceva (afișează, salvează, modifică un obiect). PHP verifică promisiunea la compilare: orice return valoare; din corpul funcției, chiar și return null;, oprește tot fișierul.

Cel mai des se întâmplă când o funcție care doar afișa a fost schimbată ca să întoarcă un rezultat, dar tipul void a rămas. Pentru return null;, mesajul adaugă o sugestie: did you mean "return;" instead of "return null;"?. Un return; gol e permis în void, ca să ieși mai devreme din funcție.

De ce apare: cauzele frecvente

1Funcția întoarce acum un rezultat

Greșit
PHP
<?php
function total(array $p): void {
    return array_sum($p);
}
Corect
PHP
<?php
function total(array $p): float {
    return array_sum($p);
}

Tipul de retur trebuie să descrie ce întoarce funcția.

2return null; pentru ieșire timpurie

Greșit
PHP
<?php
function trimite(string $email): void {
    if ($email === '') return null;
    echo "Trimis la $email";
}
Corect
PHP
<?php
function trimite(string $email): void {
    if ($email === '') return;
    echo "Trimis la $email";
}

Într-o funcție void, ieșirea se face cu return; gol.

Repară tu

Repară eroarea, direct în pagină

Funcția pretRedus calculează prețul după reducere, dar e declarată void și scriptul nu pornește: A void function must not return a value. Repară declarația funcției, ca programul să afișeze Preț redus: 90 și Preț redus: 42.5.

Codul care dă eroarea
PHP
<?php
function pretRedus(float $pret, int $procent): void
{
    return round($pret * (100 - $procent) / 100, 2);
}

echo 'Preț redus: ' . pretRedus(100, 10) . "\n";
echo 'Preț redus: ' . pretRedus(50, 15) . "\n";
După reparație, programul afișează
Preț redus: 90
Preț redus: 42.5
Indiciu

Funcția întoarce un număr, deci tipul de retur trebuie să fie float.

Alte forme ale mesajului

  • Fatal error: A void function must not return a value (did you mean "return;" instead of "return null;"?) in index.php on line 4
  • Fatal error: A never-returning function must not return in index.php on line 4
  • PHP Fatal error: A void function must not return a value in /var/www/html/src/Mailer.php on line 4

Cum o eviți pe viitor

  • Când schimbi ce face o funcție, actualizează și tipul de retur.
  • Folosește : void doar pentru funcții care au efecte (afișează, salvează) și : ?Tip pentru cele care uneori nu au rezultat.
  • Preferă funcțiile care întorc valori și lasă afișarea în afara lor: sunt mai ușor de testat.

Întrebări frecvente

Ce primește cine apelează o funcție void?

Dacă scrii $x = afiseaza();, $x va fi null. PHP nu dă eroare la apelare, dar valoarea nu are niciun sens.

Ce diferență e între void și never?

void înseamnă că funcția se termină normal, fără valoare. never (PHP 8.1) înseamnă că funcția nu se termină niciodată normal: aruncă mereu o excepție sau apelează exit. Într-o funcție never nici return; nu e permis.

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.