Fatal error: A void function must not return a value in index.php on line 4
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
<?php
function total(array $p): void {
return array_sum($p);
}<?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
<?php
function trimite(string $email): void {
if ($email === '') return null;
echo "Trimis la $email";
}<?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ă 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.
<?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";Preț redus: 90 Preț redus: 42.5
Indiciu
Funcția întoarce un număr, deci tipul de retur trebuie să fie float.
Reparația
<?php
function pretRedus(float $pret, int $procent): float
{
return round($pret * (100 - $procent) / 100, 2);
}
echo 'Preț redus: ' . pretRedus(100, 10) . "\n";
echo 'Preț redus: ' . pretRedus(50, 15) . "\n";De ce merge
: void spunea că funcția nu întoarce nimic, dar corpul ei avea return round(...). PHP a observat contradicția la compilare și n-a rulat nimic.
Cu : float, declarația spune adevărul: funcția întoarce un număr cu zecimale. PHP verifică acum și la rulare că valoarea întoarsă e chiar 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 4Fatal error: A never-returning function must not return in index.php on line 4PHP 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
: voiddoar pentru funcții care au efecte (afișează, salvează) și: ?Tippentru 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
Fatal error: Uncaught TypeError: calculeazaReducere(): Return value must be of type float, none returned in index.php:9 Funcția are tip de retur, dar pe una dintre ramuri se termină fără return. Adaugă un return cu valoarea potrivită pe toate ramurile (de obicei la final) sau schimbă tipul în ?float dacă poate întoarce null. 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. Fatal error: Cannot use string as default value for parameter $pagina of type int in index.php on line 2 Valoarea implicită a parametrului are alt tip decât cel declarat, de exemplu int $pagina = '1' sau array $filtre = ''. Scrie valoarea implicită în tipul corect: int $pagina = 1, array $filtre = []. Î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.
