Fatal error: Uncaught ValueError: str_pad(): Argument #3 ($pad_string) must be a non-empty string in index.php:4
Ai dat lui str_pad() un text de umplere gol (''), deci nu are cu ce completa până la lungimea cerută. Pune caracterul dorit (' ', '0', '.') sau lasă argumentul deoparte: implicit e spațiu.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
str_pad($text, $lungime, $umplutura, $parte) completează textul până la $lungime caractere, repetând $umplutura la dreapta (implicit), la stânga (STR_PAD_LEFT) sau pe ambele părți (STR_PAD_BOTH). Dacă $umplutura e textul gol, PHP nu poate repeta nimic, iar din PHP 8 aruncă ValueError (PHP 7 afișa un Warning și întorcea null).
Umplutura goală vine de obicei dintr-o variabilă sau o setare ($config['umplere'] ?? '') sau din confuzia cu alte funcții, unde '' înseamnă „nimic”. Dacă vrei să nu completezi, nu apela deloc str_pad.
PHP 8.5 a schimbat formularea în must not be empty; cauza și reparația sunt aceleași. Funcția înrudită mb_str_pad (PHP 8.3+) are aceeași regulă.
De ce apare: cauzele frecvente
1Umplutură goală dintr-o setare
<?php
$umplere = $config['umplere'] ?? '';
echo str_pad('42', 6, $umplere, STR_PAD_LEFT);<?php
$umplere = $config['umplere'] ?? '0';
echo str_pad('42', 6, $umplere, STR_PAD_LEFT);Valoarea implicită trebuie să fie un caracter real.
2Ai vrut spații
<?php
echo str_pad('Pix', 10, '') . '4.50';<?php
echo str_pad('Pix', 10) . '4.50';Fără al treilea argument, str_pad completează cu spații.
3Zerouri în față la numere
<?php
$nr = 7;
echo str_pad($nr, 4, '');<?php
$nr = 7;
echo sprintf('%04d', $nr);Pentru numere, sprintf('%04d', 7) dă 0007 și e mai clar.
Repară eroarea, direct în pagină
Funcția numarFactura completează numărul facturii cu zerouri până la 6 cifre, dar caracterul de umplere vine dintr-o setare lipsă, iar programul se oprește cu ValueError: str_pad(): Argument #3 ($pad_string) must be a non-empty string. Pune 0 ca valoare implicită, ca programul să afișeze F-000042 și F-001337.
<?php
function numarFactura(int $nr, array $setari): string
{
$umplere = $setari['umplere'] ?? '';
return 'F-' . str_pad((string) $nr, 6, $umplere, STR_PAD_LEFT);
}
echo numarFactura(42, []) . "\n";
echo numarFactura(1337, []) . "\n";F-000042 F-001337
Indiciu
Valoarea de după ?? se folosește când setarea lipsește; trebuie să fie un caracter real.
Reparația
<?php
function numarFactura(int $nr, array $setari): string
{
$umplere = $setari['umplere'] ?? '0';
return 'F-' . str_pad((string) $nr, 6, $umplere, STR_PAD_LEFT);
}
echo numarFactura(42, []) . "\n";
echo numarFactura(1337, []) . "\n";De ce merge
Setarea umplere lipsea, deci $umplere era textul gol. str_pad n-avea ce repeta ca să ajungă la 6 caractere, iar PHP 8 aruncă ValueError în loc să întoarcă null.
Cu '0' ca valoare implicită, str_pad('42', 6, '0', STR_PAD_LEFT) adaugă patru zerouri la stânga: 000042.
Alte forme ale mesajului
Fatal error: Uncaught ValueError: str_pad(): Argument #3 ($pad_string) must not be empty in index.php:4Fatal error: Uncaught ValueError: mb_str_pad(): Argument #3 ($pad_string) must be a non-empty string in index.php:4Warning: str_pad(): Padding string cannot be empty in index.php on line 4
Cum o eviți pe viitor
- Lasă argumentul de umplere deoparte când vrei spații.
- Pentru valori implicite din configurare, alege mereu un caracter (
' ','0'), nu textul gol. - Pentru numere cu zerouri în față, folosește
sprintf('%05d', $n); pentru bonuri și tabele,printf('%-10s%8.2f', ...)aliniază mai ușor. - Pentru texte cu diacritice, folosește
mb_str_pad(PHP 8.3+), care numără caractere, nu octeți.
Întrebări frecvente
De ce coloanele nu se aliniază când am diacritice?
str_pad numără octeți, iar ă, ș, ț au 2 octeți în UTF-8, deci textul pare mai scurt cu un caracter. Folosește mb_str_pad (PHP 8.3+) sau calculează diferența cu strlen($t) - mb_strlen($t).
Pot folosi o umplutură de mai multe caractere?
Da: str_pad('A', 7, '-=') dă A-=-=-=. Textul se repetă și se taie la lungimea cerută.
Erori înrudite
Fatal error: Uncaught ValueError: str_repeat(): Argument #2 ($times) must be greater than or equal to 0 in index.php:4 Numărul de repetări dat lui str_repeat() a ieșit negativ, de obicei la alinierea unui text: str_repeat(' ', 20 - strlen($nume)) cu un nume mai lung de 20 de caractere. Limitează-l cu max(0, ...) sau folosește str_pad(), care nu dă eroare. Fatal error: Uncaught ValueError: explode(): Argument #1 ($separator) cannot be empty in index.php:3 Ai apelat explode() cu separatorul '' (text gol), de obicei ca să împarți un cuvânt în litere. explode nu poate tăia „între” caractere. Folosește str_split($text) sau, pentru diacritice, mb_str_split($text). Fatal error: Uncaught ValueError: Unknown format specifier "p" in index.php:3 În textul dat lui printf / sprintf ai un semn % urmat de o literă care nu e specificator valid, de obicei un procent scris normal („20% pentru”). În printf, % începe mereu un specificator; un procent literal se scrie %%: printf("Reducere 20%% pentru %s", $p). Î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.
