...
Eroare PHP · Headere, sesiuni și fișiere incluse

Fatal error: Uncaught ValueError: setcookie(): Argument #1 ($name) cannot contain "=", ",", ";", " ", "\t", "\r", "\n", "\013", or "\014" in index.php:2

Pe scurt

Numele cookie-ului are un caracter interzis: spațiu, =, virgulă, punct și virgulă sau un caracter de control. Aceste caractere au rol special în antetul Set-Cookie. Folosește doar litere, cifre, _ și - în nume (cos_produse), iar valorile pune-le liber, PHP le codează.

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

Ce înseamnă

setcookie($nume, $valoare) trimite browserului antetul Set-Cookie: nume=valoare; .... În acest antet, = separă numele de valoare, ; separă opțiunile, iar spațiile și virgulele pot strica interpretarea. De aceea, din PHP 8, un nume care conține =, ,, ;, spațiu, tab, \r, \n sau caracterele de control \013, \014 aruncă ValueError și scriptul se oprește.

Cel mai des numele vine dintr-o variabilă: numele unui produs ('cos ' . $produs), un email, un text cu spații. Valoarea, în schimb, poate conține orice: setcookie o codează automat cu urlencode.

Mesajele înrudite: Argument #3 ($expires_or_options)... pentru opțiuni greșite și "path" option cannot contain... pentru căi cu caractere interzise.

De ce apare: cauzele frecvente

1Spațiu în numele cookie-ului

Greșit
PHP
<?php
setcookie('cos produse', '3');
Corect
PHP
<?php
setcookie('cos_produse', '3');

Numele are doar litere și _, deci antetul Set-Cookie rămâne valid.

2Nume construit din date

Greșit
PHP
<?php
$produs = 'Cort 2 persoane';
setcookie('vazut ' . $produs, '1');
Corect
PHP
<?php
$produs = 'Cort 2 persoane';
setcookie('vazut_' . md5($produs), '1');

Datele variabile ajung în nume doar transformate într-un text sigur (aici un hash).

3Mai multe valori într-un singur nume

Greșit
PHP
<?php
setcookie('tema=dark', '1');
Corect
PHP
<?php
setcookie('tema', 'dark');

Partea după = e valoarea; o pui în al doilea argument.

Repară tu

Repară eroarea, direct în pagină

Scriptul salvează numărul de produse din coș într-un cookie, dar se oprește cu ValueError: setcookie(): Argument #1 ($name) cannot contain .... Repară numele cookie-ului (folosește cos_produse), ca programul să afișeze Cookie setat: da.

Codul care dă eroarea
PHP
<?php
$ok = setcookie('cos produse', '3', ['expires' => time() + 3600, 'httponly' => true]);
echo 'Cookie setat: ' . ($ok ? 'da' : 'nu') . "\n";
După reparație, programul afișează
Cookie setat: da
Indiciu

Înlocuiește spațiul din nume cu _.

Alte forme ale mesajului

  • PHP Fatal error: Uncaught ValueError: setcookie(): Argument #1 ($name) cannot contain "=", ",", ";", " ", "\t", "\r", "\n", "\013", or "\014" in /var/www/html/cos.php:14
  • Warning: Cookie names cannot contain any of the following '=,; \t\r\n\013\014' in index.php on line 2
  • Fatal error: Uncaught ValueError: setcookie(): Argument #1 ($name) cannot be empty in index.php:2

Cum o eviți pe viitor

  • Folosește nume de cookie fixe, scurte, din litere, cifre, _ și -.
  • Pentru mai multe valori, folosește un singur cookie cu valoare JSON (json_encode) sau mai multe nume fixe.
  • Pune datele utilizatorului în valoare, nu în nume.
  • Pentru opțiuni (expirare, httponly, samesite), folosește forma cu tablou: setcookie('tema', 'dark', ['expires' => time() + 86400, 'httponly' => true]);.

Întrebări frecvente

Valoarea poate avea spații?

Da. setcookie o codează automat (spațiul devine %20 sau +), iar în $_COOKIE o primești decodată.

Ce înseamnă varianta cu „Cookie names cannot contain”?

E forma din PHP 7: acolo era doar Warning și cookie-ul nu se trimitea. Din PHP 8 e ValueError și scriptul se oprește.

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.