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

Fatal error: Uncaught ArgumentCountError: str_contains() expects exactly 2 arguments, 1 given in index.php:4

Pe scurt

Ai apelat o funcție din PHP cu prea puține (sau prea multe) argumente. Mesajul spune câte cere: str_contains() vrea exact 2 (textul și ce cauți). Completează apelul după semnătura din documentație, de ex. str_contains($email, '@').

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

Ce înseamnă

Funcțiile incluse în PHP (strlen, str_contains, array_map, number_format...) au un număr fix de argumente obligatorii și unul maxim. Dacă le apelezi cu mai puține sau cu mai multe, PHP 8 aruncă ArgumentCountError și îți spune exact regula:

  • expects exactly 2 arguments, 1 given: cere exact 2;
  • expects at least 2 arguments, 1 given: cere minimum 2 (de ex. array_map);
  • expects at most 4 arguments, 5 given: ai trimis prea multe.

La funcțiile tale (scrise de tine), mesajul e altul: Too few arguments to function f(), 1 passed ... and exactly 2 expected. Argumentele în plus la funcțiile tale sunt ignorate, dar la cele incluse sunt eroare.

Cele mai dese cauze: ai uitat un argument, ai confundat funcția cu una asemănătoare din alt limbaj (de ex. ai crezut că există $text.contains('@')) sau ai pus o paranteză greșit, iar un argument a ajuns la altă funcție.

De ce apare: cauzele frecvente

1Argument uitat

Greșit
PHP
<?php
$email = 'ana@exemplu.ro';
if (str_contains($email)) {
    echo 'valid';
}
Corect
PHP
<?php
$email = 'ana@exemplu.ro';
if (str_contains($email, '@')) {
    echo 'valid';
}

str_contains are nevoie de text și de ce cauți.

2Paranteză închisă prea devreme

Greșit
PHP
<?php
echo number_format(round($pret), 2, ',', '.');
echo number_format(round($pret, 2, ',', '.'));
Corect
PHP
<?php
echo number_format(round($pret, 2), 2, ',', '.');

În a doua linie greșită, toate argumentele au ajuns la round, care acceptă cel mult 3: round() expects at most 3 arguments, 4 given.

3Callback fără tablou

Greșit
PHP
<?php
$curate = array_map('trim');
Corect
PHP
<?php
$curate = array_map('trim', $valori);

array_map cere cel puțin funcția și un tablou: expects at least 2 arguments, 1 given.

Repară tu

Repară eroarea, direct în pagină

Funcția esteEmail trebuie să verifice dacă un text conține @ și un punct, dar programul se oprește cu ArgumentCountError: str_contains() expects exactly 2 arguments, 1 given. Completează apelurile, ca programul să afișeze ana@exemplu.ro: da și ana.exemplu.ro: nu.

Codul care dă eroarea
PHP
<?php
function esteEmail(string $text): bool
{
    return str_contains($text) && str_contains($text, '.');
}

foreach (['ana@exemplu.ro', 'ana.exemplu.ro'] as $t) {
    echo $t . ': ' . (esteEmail($t) ? 'da' : 'nu') . "\n";
}
După reparație, programul afișează
ana@exemplu.ro: da
ana.exemplu.ro: nu
Indiciu

str_contains primește textul și caracterul căutat.

Alte forme ale mesajului

  • Fatal error: Uncaught ArgumentCountError: strlen() expects exactly 1 argument, 0 given in index.php:3
  • Fatal error: Uncaught ArgumentCountError: array_map() expects at least 2 arguments, 1 given in index.php:3
  • Fatal error: Uncaught ArgumentCountError: number_format() expects at most 4 arguments, 5 given in index.php:2
  • Fatal error: Uncaught ArgumentCountError: round() expects at most 3 arguments, 4 given in index.php:3
  • Warning: str_replace() expects at least 3 parameters, 2 given in index.php on line 4

Cum o eviți pe viitor

  • Când folosești o funcție nouă, citește semnătura (pe php.net sau în tooltip-ul editorului): ce argumente cere și în ce ordine.
  • Un editor cu analiză PHP (Intelephense, PhpStorm) îți arată numărul greșit de argumente înainte să rulezi.
  • La apeluri imbricate, scrie rezultatul intermediar într-o variabilă ($rotunjit = round($pret, 2);), ca parantezele să fie clare.

Întrebări frecvente

De ce la funcțiile mele argumentele în plus nu dau eroare?

Funcțiile definite în PHP (userland) acceptă argumente în plus și le poți citi cu func_get_args(). Funcțiile interne au semnături stricte și refuză argumentele în plus din PHP 8.

Diferă de „Too few arguments to function”?

E aceeași clasă de eroare (ArgumentCountError), dar acel mesaj apare la funcțiile scrise de tine și arată și unde e definită funcția. Acesta apare la funcțiile incluse în 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.