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

Fatal error: Uncaught ValueError: str_pad(): Argument #3 ($pad_string) must be a non-empty string in index.php:4

Pe scurt

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

Greșit
PHP
<?php
$umplere = $config['umplere'] ?? '';
echo str_pad('42', 6, $umplere, STR_PAD_LEFT);
Corect
PHP
<?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

Greșit
PHP
<?php
echo str_pad('Pix', 10, '') . '4.50';
Corect
PHP
<?php
echo str_pad('Pix', 10) . '4.50';

Fără al treilea argument, str_pad completează cu spații.

3Zerouri în față la numere

Greșit
PHP
<?php
$nr = 7;
echo str_pad($nr, 4, '');
Corect
PHP
<?php
$nr = 7;
echo sprintf('%04d', $nr);

Pentru numere, sprintf('%04d', 7) dă 0007 și e mai clar.

Repară tu

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.

Codul care dă eroarea
PHP
<?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";
După reparație, programul afișează
F-000042
F-001337
Indiciu

Valoarea de după ?? se folosește când setarea lipsește; trebuie să fie un caracter real.

Alte forme ale mesajului

  • Fatal error: Uncaught ValueError: str_pad(): Argument #3 ($pad_string) must not be empty in index.php:4
  • Fatal error: Uncaught ValueError: mb_str_pad(): Argument #3 ($pad_string) must be a non-empty string in index.php:4
  • Warning: 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

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