...
Eroare PHP · Excepții, JSON și expresii regulate

Warning: unserialize(): Error at offset 41 of 71 bytes in index.php on line 6

Pe scurt

Textul dat lui unserialize() nu mai e un serialize() valid: a fost trunchiat (coloană prea scurtă în baza de date) sau modificat cu str_replace, iar lungimile s:NN: nu mai corespund. unserialize întoarce false. Nu edita textul serializat: deserializează, modifică datele, serializează la loc (sau folosește JSON).

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

Ce înseamnă

serialize() transformă date PHP într-un text care include și lungimea fiecărui șir: s:20:"http://site-vechi.ro" înseamnă „șir de 20 de octeți”. unserialize() citește exact atâția octeți. Dacă textul a fost modificat și lungimea nu mai e corectă, citirea se oprește la poziția greșită, iar PHP afișează Error at offset 41 of 71 bytes (poziția unde s-a blocat și lungimea totală) și întoarce false.

Cauze reale, foarte frecvente:

  • un search-replace direct în baza de date (de ex. schimbarea domeniului unui site WordPress) care modifică textul, dar nu și lungimile;
  • coloana din baza de date e prea scurtă (VARCHAR(255)) și textul a fost tăiat;
  • conversii de codare (diacriticele au alt număr de octeți în UTF-8 decât în Latin-2);
  • datele nu erau serializate deloc (JSON, text simplu).

În PHP 8.0–8.2 mesajul era Notice; din 8.3 e Warning.

De ce apare: cauzele frecvente

1str_replace pe textul serializat

Greșit
PHP
<?php
$s = serialize(['url' => 'http://site-vechi.ro']);
$s = str_replace('site-vechi.ro', 'magazin-nou.ro', $s);
$date = unserialize($s);
Corect
PHP
<?php
$date = unserialize(serialize(['url' => 'http://site-vechi.ro']));
$date['url'] = str_replace('site-vechi.ro', 'magazin-nou.ro', $date['url']);
$s = serialize($date);

Modifici datele, nu textul serializat; serialize recalculează lungimile.

2Text trunchiat de coloana din baza de date

Greșit
PHP
<?php
// coloana preferinte VARCHAR(50)
$date = unserialize(substr(serialize($preferinte), 0, 50));
Corect
PHP
<?php
// coloana preferinte TEXT sau JSON
$date = json_decode($rand['preferinte'], true, flags: JSON_THROW_ON_ERROR);

Folosește o coloană TEXT/JSON și, pentru date noi, JSON: e lizibil și nu depinde de lungimi în octeți.

3Datele erau JSON, nu serialize

Greșit
PHP
<?php
$date = unserialize('{"tema":"dark"}');
Corect
PHP
<?php
$date = json_decode('{"tema":"dark"}', true);

Folosește funcția pereche a celei care a scris datele.

Repară tu

Repară eroarea, direct în pagină

Funcția schimbaDomeniu mută setările unui site pe un domeniu nou, dar înlocuiește textul direct în datele serializate. Rezultatul afișează Warning: unserialize(): Error at offset ... și setările se pierd. Repară funcția: deserializează, schimbă domeniul în url, serializează la loc. Programul trebuie să afișeze http://magazin-nou.ro și Magazin.

Codul care dă eroarea
PHP
<?php
function schimbaDomeniu(string $serializat, string $vechi, string $nou): string
{
    return str_replace($vechi, $nou, $serializat);
}

$setari = serialize(['url' => 'http://site-vechi.ro', 'titlu' => 'Magazin']);
$date = unserialize(schimbaDomeniu($setari, 'site-vechi.ro', 'magazin-nou.ro'));
echo $date['url'] . "\n";
echo $date['titlu'] . "\n";
După reparație, programul afișează
http://magazin-nou.ro
Magazin
Indiciu

Lucrează pe tablou: unserialize, str_replace doar pe $date['url'], apoi serialize.

Alte forme ale mesajului

  • Notice: unserialize(): Error at offset 41 of 71 bytes in index.php on line 6
  • Warning: unserialize(): Error at offset 5 of 5 bytes in index.php on line 2
  • Warning: unserialize(): Extra data starting at offset 8 of 12 bytes in index.php on line 3

Cum o eviți pe viitor

  • Pentru date noi, preferă json_encode / json_decode: format standard, lizibil, sigur.
  • Nu face search-replace direct în baza de date pe date serializate; folosește unelte care înțeleg formatul (de ex. wp search-replace la WordPress).
  • Nu da niciodată lui unserialize date venite de la utilizator: poate crea obiecte arbitrare. Dacă trebuie, folosește ['allowed_classes' => false].
  • Verifică rezultatul: $date === false && $s !== serialize(false) înseamnă eroare.

Întrebări frecvente

Cum repar date deja stricate în baza de date?

Pentru texte modificate cu search-replace, lungimile se pot recalcula cu o expresie regulată (preg_replace_callback pe s:(\d+):"(.*?)";), dar e fragil. Mai sigur: restaurezi din backup și refaci înlocuirea cu o unealtă care deserializează.

De ce lungimea e în octeți, nu în caractere?

Așa e formatul serialize. Cu diacritice, s:4:"ță" are 4 octeți pentru 2 caractere. De aceea o conversie de codare a textului strică datele serializate.

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.