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
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 >
<?php
usort($produse, fn($a, $b) => $a['pret'] > $b['pret']);<?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
<?php
usort($elevi, function ($a, $b) {
return $a['medie'] < $b['medie'] || $a['nume'] > $b['nume'];
});<?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 >
<?php
usort($nume, fn($a, $b) => $a > $b);<?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ă 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.
<?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";
}Pix: 4.5 Cană: 29.9 Rucsac: 149
Indiciu
Folosește operatorul <=>: fn($a, $b) => $a['pret'] <=> $b['pret'].
Reparația
<?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";
}De ce merge
$a['pret'] > $b['pret'] întoarce true sau false, deci nu poate spune niciodată „primul vine înainte”. PHP 8 a detectat valoarea bool, a afișat Deprecated și a compensat cu comparații în plus.
<=> întoarce -1, 0 sau 1, adică exact informația de care are nevoie usort. Pentru ordine descrescătoare ar fi fost suficient să scrii $b['pret'] <=> $a['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 4Deprecated: 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
intla funcția de comparare:function (array $a, array $b): int. Unboolî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
Fatal error: Uncaught TypeError: array_map(): Argument #1 ($callback) must be a valid callback or null, function "cuTva" not found or invalid function name in index.php:10 Ai dat lui array_map (sau usort, array_filter...) numele unei funcții care nu există ca funcție globală: o greșeală de scriere sau o metodă dintr-o clasă dată doar ca text. Pentru metode folosește [Clasa::class, 'metoda'], [$obiect, 'metoda'] sau Clasa::metoda(...). Deprecated: pret(): Optional parameter $moneda declared before required parameter $suma is implicitly treated as a required parameter in index.php on line 2 Ai un parametru cu valoare implicită pus înaintea unui parametru obligatoriu, deci valoarea implicită nu poate fi folosită niciodată. Mută parametrii opționali la finalul listei sau dă și celor de după valori implicite. Deprecated: Return type of Colectie::getIterator() should either be compatible with IteratorAggregate::getIterator(): Traversable, or the #[\ReturnTypeWillChange] attribute should be used to temporarily suppress the notice in index.php on line 9 Clasa ta implementează o interfață din PHP (IteratorAggregate, Countable, ArrayAccess, JsonSerializable, Iterator), dar metoda nu are tipul de retur cerut din PHP 8.1. Adaugă tipul din mesaj: public function getIterator(): Traversable, count(): int, jsonSerialize(): mixed. Atributul #[\ReturnTypeWillChange] doar ascunde mesajul. Î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.
