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

Fatal error: Uncaught ArgumentCountError: 3 arguments are required, 2 given in index.php:4

Pe scurt

printf sau sprintf au mai mulți specificatori (%s, %d) decât valorile date, sau textul conține un % simplu (50%) pe care PHP îl citește ca specificator. Adaugă valoarea lipsă sau scrie procentul ca %%.

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

Ce înseamnă

Mesajul vine de la sprintf(), printf() sau vsprintf(). PHP numără specificatorii din text (%s, %d, %.2f...) și adaugă 1 pentru textul însuși: 3 arguments are required, 2 given înseamnă textul plus 2 valori necesare, dar ai dat textul plus o singură valoare.

Două cauze domină. Prima: ai adăugat un %s în text și ai uitat valoarea. A doua, mai greu de văzut: un semn % obișnuit, ca în Reducere 50%, e citit ca începutul unui specificator și cere și el o valoare. Procentul literal se scrie %%. PHP 7 dădea doar Warning: sprintf(): Too few arguments și întorcea false; PHP 8 aruncă ArgumentCountError.

De ce apare: cauzele frecvente

1Valoare lipsă

Greșit
PHP
<?php
printf("%s a cumpărat %d produse de %s lei\n", 'Ana', 3);
Corect
PHP
<?php
printf("%s a cumpărat %d produse de %s lei\n", 'Ana', 3, '250');

Trei specificatori cer trei valori, în aceeași ordine.

2Procent scris cu un singur %

Greșit
PHP
<?php
echo sprintf('Reducere 20% la %s', 'Rucsac');
Corect
PHP
<?php
echo sprintf('Reducere 20%% la %s', 'Rucsac');

%% afișează un singur % și nu cere nicio valoare.

3Tablou dat ca o singură valoare

Greșit
PHP
<?php
$date = ['Ana', 3];
printf('%s are %d ani', $date);
Corect
PHP
<?php
$date = ['Ana', 3];
vprintf('%s are %d ani', $date);

vprintf / vsprintf primesc valorile ca tablou. Cu printf poți scrie și printf('...', ...$date).

Repară tu

Repară eroarea, direct în pagină

Scriptul afișează reducerile zilei cu printf, dar se oprește cu ArgumentCountError: 4 arguments are required, 3 given. Repară textul de format, ca programul să afișeze Rucsac: reducere 20% azi și Cort: reducere 15% azi.

Codul care dă eroarea
PHP
<?php
$oferte = [['Rucsac', 20], ['Cort', 15]];

foreach ($oferte as [$produs, $procent]) {
    printf("%s: reducere %d% azi\n", $produs, $procent);
}
După reparație, programul afișează
Rucsac: reducere 20% azi
Cort: reducere 15% azi
Indiciu

Semnul procent afișat literal trebuie scris %% în textul pentru printf.

Alte forme ale mesajului

  • Fatal error: Uncaught ArgumentCountError: 2 arguments are required, 1 given in index.php:4
  • Fatal error: Uncaught ValueError: The arguments array must contain 2 items, 1 given in index.php:4
  • Warning: sprintf(): Too few arguments in index.php on line 4
  • Fatal error: Uncaught ValueError: Missing format specifier at end of string in index.php:4

Cum o eviți pe viitor

  • Numără specificatorii când modifici textul unui printf, sau folosește interpolarea ("$nume are $ani ani") pentru texte simple.
  • Scrie mereu procentele ca %% în textele date lui printf / sprintf.
  • Pentru valori multe, folosește specificatori numerotați: %1\$s, %2\$d, mai ușor de urmărit.
  • PHPStan semnalează numărul greșit de argumente la sprintf.

Întrebări frecvente

De ce mesajul spune 3, dacă textul are doar 2 specificatori?

Pentru că numără toate argumentele funcției, inclusiv textul de format. Două valori plus formatul fac trei argumente.

Ce se întâmplă dacă dau mai multe valori decât specificatori?

Nimic grav: valorile în plus sunt ignorate, fără eroare. De aceea e ușor să nu observi o valoare uitată în text.

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.