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

Fatal error: Uncaught TypeError: strlen(): Argument #1 ($string) must be of type string, array given in index.php:4

Pe scurt

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.

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

Ce înseamnă

Funcțiile PHP au tipuri declarate pentru parametri, iar din PHP 8 le verifică strict pentru tablouri și obiecte: strlen() așteaptă un string, iar dacă primește un array, aruncă TypeError. Mesajul îți spune funcția (strlen()), parametrul (Argument #1 ($string)), tipul cerut și tipul primit.

Cazul clasic din aplicațiile web: un câmp de formular cu nume de forma optiuni[] (checkbox-uri, select multiplu) ajunge în $_POST ca tablou, iar codul de validare îl tratează ca pe un text. Alte cauze: rezultatul lui explode(), str_split() sau preg_split() (care întorc tablouri), un tablou întreg dat în loc de un element ($user în loc de $user['nume']).

Același tip de mesaj apare la toate funcțiile de text: trim(), strtolower(), str_replace() (la $subject acceptă și tablou), htmlspecialchars().

De ce apare: cauzele frecvente

1Câmp cu mai multe valori

Greșit
PHP
<?php
$post = ['interese' => ['php', 'sql']];
if (strlen($post['interese']) === 0) {
    echo 'Alege ceva';
}
Corect
PHP
<?php
$post = ['interese' => ['php', 'sql']];
if (count($post['interese']) === 0) {
    echo 'Alege ceva';
}

Pentru un tablou verifici câte elemente are cu count(), nu lungimea cu strlen().

2Tablou în loc de element

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

Funcția de text primește valoarea text din tablou, nu tabloul întreg.

3Funcție aplicată pe toate elementele

Greșit
PHP
<?php
$tags = explode(',', 'PHP, SQL');
echo strtolower($tags);
Corect
PHP
<?php
$tags = explode(',', 'PHP, SQL');
print_r(array_map('strtolower', $tags));

explode întoarce un tablou. Cu array_map aplici funcția pe fiecare element.

Repară tu

Repară eroarea, direct în pagină

Formularul de înscriere are checkbox-uri cu numele cursuri[], așa că $post['cursuri'] este un tablou. Codul dă TypeError: strlen(): Argument #1 ($string) must be of type string, array given. Repară validarea, ca programul să afișeze Ai ales 2 cursuri: PHP, SQL.

Codul care dă eroarea
PHP
<?php
$post = ['nume' => 'Ana', 'cursuri' => ['PHP', 'SQL']];

$cursuri = $post['cursuri'];

if (strlen($cursuri) === 0) {
    echo "Alege cel puțin un curs\n";
} else {
    echo "Ai ales " . count($cursuri) . " cursuri: " . implode(', ', $cursuri) . "\n";
}
După reparație, programul afișează
Ai ales 2 cursuri: PHP, SQL
Indiciu

Pentru un tablou numeri elementele cu count(), iar pentru afișare le lipești cu implode().

Alte forme ale mesajului

  • Fatal error: Uncaught TypeError: trim(): Argument #1 ($string) must be of type string, array given in index.php:4
  • Fatal error: Uncaught TypeError: strtolower(): Argument #1 ($string) must be of type string, array given in index.php:4
  • Fatal error: Uncaught TypeError: implode(): Argument #2 ($array) must be of type ?array, string given in index.php:4
  • Warning: strlen() expects parameter 1 to be string, array given in index.php on line 4

Cum o eviți pe viitor

  • Când un câmp de formular are [] în nume, tratează-l mereu ca tablou: $x = (array) ($_POST['optiuni'] ?? []);.
  • Verifică tipul datelor din afară cu is_string() / is_array() înainte să le folosești.
  • Pentru transformări pe liste, folosește array_map().
  • Dă funcțiilor tale parametri tipați, ca să afli devreme unde intră un tablou în loc de text.

Întrebări frecvente

În PHP 7 primeam doar un Warning și null. De ce acum se oprește scriptul?

PHP 8 a transformat argumentele de tip greșit pentru funcțiile interne în TypeError. E mai bine așa: înainte codul mergea mai departe cu un rezultat null și eroarea apărea mult mai târziu, într-un loc greu de găsit.

Cum aflu ce primesc de fapt?

Pune var_dump($valoare); chiar înainte de linia cu eroarea: vezi tipul (array(2), string(3)) și conținutul.

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.