...
Eroare PHP · Tipuri, operatori și conversii

Deprecated: htmlspecialchars(): Passing null to parameter #1 ($string) of type string is deprecated in index.php on line 4

Pe scurt

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

Greșit
PHP
<?php
$get = [];
$cautare = $get['q'] ?? null;
echo htmlspecialchars($cautare);
Corect
PHP
<?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

Greșit
PHP
<?php
$rand = ['nume' => 'Ana', 'telefon' => null];
echo trim($rand['telefon']);
Corect
PHP
<?php
$rand = ['nume' => 'Ana', 'telefon' => null];
echo trim($rand['telefon'] ?? '');

?? înlocuiește null cu text gol chiar la apel.

3Rezultatul unei căutări

Greșit
PHP
<?php
function gaseste(array $u, int $id): ?string { return $u[$id] ?? null; }
echo strtoupper(gaseste([], 3));
Corect
PHP
<?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ă tu

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.

Codul care dă eroarea
PHP
<?php
function afiseazaCautarea(array $get): void
{
    $q = $get['q'] ?? null;
    echo "Rezultate pentru: " . htmlspecialchars($q) . "\n";
}

afiseazaCautarea(['q' => '<b>php</b>']);
afiseazaCautarea([]);
După reparație, programul afișează
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.

Alte forme ale mesajului

  • Deprecated: trim(): Passing null to parameter #1 ($string) of type string is deprecated in index.php on line 4
  • Deprecated: strlen(): Passing null to parameter #1 ($string) of type string is deprecated in index.php on line 4
  • Deprecated: str_replace(): Passing null to parameter #3 ($subject) of type array|string is deprecated in index.php on line 4
  • PHP 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ă null aproape 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ărea null.
  • 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

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