The strnatcasecmp() function behaves identically in PHP 8.4 and PHP 8.5. There are no version-specific changes to this function in either release. Its most recent behavioral change occurred in PHP 8.2.0.
Function
strnatcasecmp() compares two strings using a "natural order" algorithm, the way a human would sort alphanumeric strings. It is case-insensitive.
Signature:
strnatcasecmp(string $string1, string $string2): int
Return Value:
- Returns < 0 if $string1 is less than $string2.
- Returns > 0 if $string1 is greater than $string2.
- Returns 0 if they are equal.
- You cannot reliably infer the exact value beyond its sign.
Examples
Here is how you can use it in your PHP 8.4 or 8.5 projects:
1. Basic Case-Insensitive Comparison
<?php
var_dump(strnatcasecmp( Apple , Banana )); // int(-1) because A comes before B
var_dump(strnatcasecmp( Banana , Apple )); // int(1)
var_dump(strnatcasecmp( apple , Apple )); // int(0) because it ignores case
?>
This demonstrates the core behavior: comparing strings naturally while ignoring uppercase/lowercase differences.
2. Natural Order vs. Standard Comparison (The Key Difference) This is where the function becomes truly useful. Standard string comparison (strcmp) compares character by character, so "10" comes before "2" because 1 is less than 2 . Natural order understands that 2 is less than 10.
<?php
// Standard comparison thinks "10" is less than "2"
var_dump(strcmp( File10 , File2 )); // int(-1)// Natural comparison understands 10 is greater than 2
var_dump(strnatcasecmp( File10 , File2 )); // int(1)
?>
3. Sorting an Array Naturally A common real-world use is sorting file names or version numbers correctly.
<?php
$files = ["img12.png", "img10.png", "IMG2.png", "img1.png"];// Standard sort (incorrect for humans)
usort($files, istrcasecmp );
print_r($files);
/* Output:
Array ( [0] => img1.png [1] => img10.png [2] => img12.png [3] => IMG2.png )
*/// Natural sort (correct for humans)
usort($files, istrnatcasecmp );
print_r($files);
/* Output:
Array ( [0] => img1.png [1] => IMG2.png [2] => img10.png [3] => img12.png )
*/
?>
This shows how strnatcasecmp places "IMG2.png" before "img10.png", which is the intuitive human ordering.
Notes
- PHP 8.2+ Return Value Change: As of PHP 8.2.0, when strings are of unequal length, the function is no longer guaranteed to return strlen($string1) - strlen($string2). It may now return exactly -1 or 1. You should only rely on the sign (positive/negative/zero), not the absolute number.
- Underscore Handling: Be aware that this function treats the underscore _ character as coming after letters and numbers, which may not be intuitive if you are sorting file names that contain underscores.
- Related Functions: If you need a case-sensitive natural comparison, use strnatcmp(). For standard case-insensitive comparison without natural ordering, use strcasecmp().
- If you need help with a specific sorting scenario or comparing other string functions, feel free to ask.