...
Eroare PHP · Variabile, constante și tablouri

Warning: Only the first byte will be assigned to the string offset in index.php on line 3

Pe scurt

Ai pus mai multe caractere într-o singură poziție a unui text: $cod[3] = '123'. O poziție dintr-un string ține un singur byte, așa că PHP păstrează doar '1' și te avertizează. Pentru a înlocui o bucată de text folosește substr_replace() sau str_replace().

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

Ce înseamnă

În PHP poți modifica un caracter dintr-un string prin index: $s[0] = 'X';. Fiecare poziție ține însă exact un byte. Când pui acolo un text mai lung ($cod[3] = '123'), PHP scrie doar primul byte ('1'), aruncă restul și afișează Only the first byte will be assigned to the string offset.

E doar un Warning, deci scriptul merge mai departe, dar rezultatul e greșit: 'AB-000' devine 'AB-100', nu 'AB-123'.

Atenție și la diacritice: ă, ș, ț au câte 2 bytes în UTF-8, deci $s[0] = 'ș' dă același avertisment și strică textul. Linia din mesaj e atribuirea cu [...]; acolo înlocuiești indexul cu o funcție de text.

De ce apare: cauzele frecvente

1Vrei să înlocuiești o bucată de text

Greșit
PHP
<?php
$cod = 'AB-000';
$cod[3] = '123';
Corect
PHP
<?php
$cod = 'AB-000';
$cod = substr_replace($cod, '123', 3, 3);

substr_replace înlocuiește 3 caractere începând cu poziția 3, oricât de lung e textul nou.

2Diacritice puse pe o poziție

Greșit
PHP
<?php
$nume = 'sanatate';
$nume[0] = 'ș';
Corect
PHP
<?php
$nume = 'sanatate';
$nume = 'ș' . mb_substr($nume, 1);

ș are 2 bytes; construiești textul nou prin concatenare, cu funcțiile mb_ care lucrează pe caractere, nu pe bytes.

3Adaugi un sufix printr-un index

Greșit
PHP
<?php
$fisier = 'raport';
$fisier[6] = '.pdf';
Corect
PHP
<?php
$fisier = 'raport';
$fisier .= '.pdf';

Pentru a lipi text la final folosești .=, nu un index.

Repară tu

Repară eroarea, direct în pagină

Codul de mai jos trebuie să completeze un cod de produs cu numărul 123, dar afișează Warning: Only the first byte will be assigned to the string offset și rezultatul AB-100. Repară-l ca să afișeze AB-123.

Codul care dă eroarea
PHP
<?php
$cod = 'AB-000';
$cod[3] = '123';
echo $cod . "\n";
După reparație, programul afișează
AB-123
Indiciu

Înlocuiește cele trei cifre cu substr_replace, nu printr-un singur index.

Alte forme ale mesajului

  • PHP Warning: Only the first byte will be assigned to the string offset in /var/www/html/index.php on line 3
  • Fatal error: Uncaught Error: Cannot assign an empty string to a string offset in index.php:3

Cum o eviți pe viitor

  • Folosește indexul $s[$i] = ... doar pentru un singur caracter ASCII.
  • Pentru înlocuiri folosește substr_replace, str_replace sau preg_replace.
  • Pentru texte în română (cu diacritice) folosește funcțiile mb_substr, mb_strlen, mb_str_split.
  • Pentru a lipi text la final folosește .=.

Întrebări frecvente

De ce nu primesc eroare, ci doar Warning?

Pentru că PHP poate totuși face ceva: scrie primul byte. Scriptul continuă cu un rezultat greșit, deci tratează avertismentul ca pe o eroare.

Și dacă pun un string gol: $s[0] = ''?

Atunci e eroare fatală: Cannot assign an empty string to a string offset. Pentru a șterge un caracter folosește substr_replace($s, '', 0, 1).

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.