Deprecated: htmlspecialchars(): Passing null to parameter #1 ($string) of type string is deprecated in index.php on line 4
Dai null unei funcții PHP care așteaptă text (htmlspecialchars, trim, strlen, str_replace...). De obicei valoarea vine dintr-o cheie lipsă sau dintr-o coloană goală din baza de date. Dă o valoare implicită: htmlspecialchars($x ?? '').
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Din PHP 8.1, funcțiile interne nu mai acceptă în tăcere null pentru parametrii de tip string, int sau bool. Deocamdată primești doar un mesaj Deprecated, iar funcția se comportă ca înainte (tratează null ca ''), dar într-o versiune viitoare va fi TypeError.
Mesajul spune funcția, poziția parametrului și numele lui (#1 ($string)) și tipul așteptat. Cel mai des îl vezi la htmlspecialchars(), trim(), strlen(), str_replace(), strtolower(), explode(), json_decode(), când valoarea vine din $_GET / $_POST (o cheie lipsă citită cu ?? null), dintr-un câmp NULL al bazei de date sau dintr-o funcție care întoarce null când nu găsește nimic.
Apare des la actualizarea unui proiect vechi (de exemplu WordPress sau Laravel) la PHP 8.1+.
De ce apare: cauzele frecvente
1Câmp opțional din URL
<?php
$get = [];
$cautare = $get['q'] ?? null;
echo htmlspecialchars($cautare);<?php
$get = [];
$cautare = $get['q'] ?? '';
echo htmlspecialchars($cautare);Valoarea implicită text gol ('') e de tipul corect, deci funcția nu mai primește null.
2Coloană NULL din baza de date
<?php
$rand = ['nume' => 'Ana', 'telefon' => null];
echo trim($rand['telefon']);<?php
$rand = ['nume' => 'Ana', 'telefon' => null];
echo trim($rand['telefon'] ?? '');?? înlocuiește null cu text gol chiar la apel.
3Rezultatul unei căutări
<?php
function gaseste(array $u, int $id): ?string { return $u[$id] ?? null; }
echo strtoupper(gaseste([], 3));<?php
function gaseste(array $u, int $id): ?string { return $u[$id] ?? null; }
echo strtoupper(gaseste([], 3) ?? 'necunoscut');Funcția poate întoarce null, deci tratezi cazul înainte să trimiți rezultatul mai departe.
Repară eroarea, direct în pagină
Pagina de căutare afișează în siguranță termenul căutat din $get (simularea lui $_GET). Când parametrul q lipsește, apare Deprecated: htmlspecialchars(): Passing null to parameter #1 ($string). Repară citirea parametrului, ca programul să afișeze Rezultate pentru: <b>php</b> și apoi Rezultate pentru: , fără mesaje.
<?php
function afiseazaCautarea(array $get): void
{
$q = $get['q'] ?? null;
echo "Rezultate pentru: " . htmlspecialchars($q) . "\n";
}
afiseazaCautarea(['q' => '<b>php</b>']);
afiseazaCautarea([]);Rezultate pentru: <b>php</b> Rezultate pentru:
Indiciu
Valoarea implicită pentru un parametru text care lipsește ar trebui să fie tot un text, nu null.
Reparația
<?php
function afiseazaCautarea(array $get): void
{
$q = $get['q'] ?? '';
echo "Rezultate pentru: " . htmlspecialchars($q) . "\n";
}
afiseazaCautarea(['q' => '<b>php</b>']);
afiseazaCautarea([]);De ce merge
Pentru al doilea apel cheia q lipsește, iar ?? null pune null în $q. htmlspecialchars cere un string, iar din PHP 8.1 primirea lui null este semnalată ca depreciată.
Cu ?? '', valoarea implicită are tipul corect, deci funcția primește un text gol și nu mai e nimic de semnalat. Primul apel arată de ce folosim htmlspecialchars: <b> devine <b>, deci browserul îl afișează ca text, nu îl interpretează ca HTML.
Alte forme ale mesajului
Deprecated: trim(): Passing null to parameter #1 ($string) of type string is deprecated in index.php on line 4Deprecated: strlen(): Passing null to parameter #1 ($string) of type string is deprecated in index.php on line 4Deprecated: str_replace(): Passing null to parameter #3 ($subject) of type array|string is deprecated in index.php on line 4PHP Deprecated: htmlspecialchars(): Passing null to parameter #1 ($string) of type string is deprecated in /var/www/html/wp-includes/formatting.php on line 4730
Cum o eviți pe viitor
- Când citești date opționale, dă-le o valoare implicită de tipul potrivit:
$x = $get['q'] ?? '';. - Tratează
nullaproape de locul unde apare (citirea din formular sau din baza de date), nu în fiecare funcție. - Folosește
declare(strict_types=1)și tipuri în funcțiile tale, ca să știi unde poate apăreanull. - Dacă mesajul vine dintr-un plugin sau o bibliotecă, actualizează-le la o versiune compatibilă cu PHP 8.1+.
Întrebări frecvente
Pot ignora mesajul, dacă pagina merge?
Deocamdată funcția se comportă ca înainte, dar mesajul anunță că într-o versiune viitoare de PHP se va transforma în TypeError. Pe producție e bine să ascunzi afișarea erorilor (display_errors=Off) și să le repari din loguri.
De ce nu primesc mesajul pentru funcțiile mele?
Pentru că funcțiile tale cu parametru string aruncă direct TypeError la null (sau acceptă null dacă tipul e ?string). Mesajul Deprecated e o perioadă de tranziție doar pentru funcțiile interne ale PHP.
Erori înrudite
Fatal error: Uncaught TypeError: strlen(): Argument #1 ($string) must be of type string, array given in index.php:4 Dai unei funcții de text (strlen, trim, strtolower, str_contains...) un tablou în loc de un text. De obicei valoarea vine dintr-un câmp cu mai multe opțiuni sau dintr-un explode. Aplică funcția pe fiecare element sau alege elementul de care ai nevoie. Warning: Undefined array key "email" in index.php on line 3 Tabloul asociativ nu are cheia "email". Verifică numele cheii sau dă o valoare implicită cu $date['email'] ?? '' ori verifică întâi cu isset() sau array_key_exists(). Warning: Trying to access array offset on null in index.php on line 4 Folosești $x['cheie'] pe o variabilă care este null, nu un tablou. De obicei o funcție de căutare n-a găsit nimic sau o cheie de pe nivelul de mai sus lipsește. Verifică întâi rezultatul (cu ?? sau if) înainte să-l indexezi. Î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.
