...
Eroare PHP · Mesaje Deprecated la upgrade de versiune

Deprecated: usort(): Returning bool from comparison function is deprecated, return an integer less than, equal to, or greater than zero in index.php on line 4

Pe scurt

Funcția de comparare dată lui usort() întoarce true/false (de ex. $a > $b), dar trebuie să întoarcă un număr: negativ, 0 sau pozitiv. Cel mai simplu e operatorul <=>: usort($lista, fn($a, $b) => $a['pret'] <=> $b['pret']).

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

Ce înseamnă

usort(), uasort() și uksort() sortează folosind funcția ta de comparare. Funcția primește două elemente și trebuie să spună ordinea lor printr-un număr: negativ dacă $a vine înainte, 0 dacă sunt egale, pozitiv dacă $a vine după.

Mult cod vechi scria return $a > $b;, care întoarce true / false (1 / 0). Așa nu se poate spune niciodată „$a vine înainte” (-1). Până la PHP 7 merge din întâmplare în multe cazuri, datorită algoritmului de sortare de atunci. PHP 8 a schimbat algoritmul (sortare stabilă) și, ca să păstreze cât de cât vechiul comportament, detectează valorile bool, afișează acest Deprecated și repetă comparația invers.

Repararea e aproape mereu operatorul „navă spațială” <=>, care întoarce exact -1, 0 sau 1. Pentru ordine descrescătoare inversezi operanzii: $b <=> $a.

De ce apare: cauzele frecvente

1Comparație cu >

Greșit
PHP
<?php
usort($produse, fn($a, $b) => $a['pret'] > $b['pret']);
Corect
PHP
<?php
usort($produse, fn($a, $b) => $a['pret'] <=> $b['pret']);

<=> întoarce -1, 0 sau 1, exact ce cere usort.

2Sortare descrescătoare după mai multe criterii

Greșit
PHP
<?php
usort($elevi, function ($a, $b) {
    return $a['medie'] < $b['medie'] || $a['nume'] > $b['nume'];
});
Corect
PHP
<?php
usort($elevi, fn($a, $b) => [$b['medie'], $a['nume']] <=> [$a['medie'], $b['nume']]);

Compararea a două tablouri cu <=> merge element cu element: întâi media (descrescător), apoi numele (crescător).

3Texte comparate cu >

Greșit
PHP
<?php
usort($nume, fn($a, $b) => $a > $b);
Corect
PHP
<?php
usort($nume, fn($a, $b) => strcmp($a, $b));

strcmp întoarce deja un număr negativ, 0 sau pozitiv. Pentru texte cu diacritice, Collator din extensia intl dă ordinea corectă în română.

Repară tu

Repară eroarea, direct în pagină

Funcția sorteaza ordonează produsele după preț, crescător, dar afișează Deprecated: usort(): Returning bool from comparison function is deprecated. Repară funcția de comparare, ca programul să afișeze Pix: 4.5, Cană: 29.9 și Rucsac: 149, fără mesaje Deprecated.

Codul care dă eroarea
PHP
<?php
function sorteaza(array $produse): array
{
    usort($produse, fn($a, $b) => $a['pret'] > $b['pret']);
    return $produse;
}

$produse = [
    ['nume' => 'Cană', 'pret' => 29.9],
    ['nume' => 'Rucsac', 'pret' => 149],
    ['nume' => 'Pix', 'pret' => 4.5],
];
foreach (sorteaza($produse) as $p) {
    echo "{$p['nume']}: {$p['pret']}\n";
}
După reparație, programul afișează
Pix: 4.5
Cană: 29.9
Rucsac: 149
Indiciu

Folosește operatorul <=>: fn($a, $b) => $a['pret'] <=> $b['pret'].

Alte forme ale mesajului

  • Deprecated: uasort(): Returning bool from comparison function is deprecated, return an integer less than, equal to, or greater than zero in index.php on line 4
  • Deprecated: uksort(): Returning bool from comparison function is deprecated, return an integer less than, equal to, or greater than zero in index.php on line 4

Cum o eviți pe viitor

  • Scrie comparațiile mereu cu <=> sau cu funcții care întorc numere (strcmp, strnatcmp).
  • Pune tip de retur int la funcția de comparare: function (array $a, array $b): int. Un bool întors devine 0/1 și ascunde greșeala, dar e mai ușor de observat la citire.
  • La upgrade de la PHP 7, caută în proiect usort( și verifică fiecare comparator.

Întrebări frecvente

Sortarea pare corectă. Trebuie totuși să repar?

Da. PHP repară temporar rezultatul făcând comparații în plus, dar comportamentul e marcat Deprecated și va dispărea. În plus, cu bool elementele egale nu pot fi recunoscute ca egale.

Ce întoarce exact <=>?

-1 dacă stânga e mai mică, 0 dacă sunt egale, 1 dacă stânga e mai mare. Funcționează pe numere, texte, tablouri și obiecte DateTime.

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.