When writing PHP applications, you may need to find unmatched entries using custom comparisons for both keys and values. This is useful in everyday tasks such as working with imported data, application settings, user-facing lists, and reports.
The array_udiff_uassoc() operation provides this behavior directly. The examples below show what happens to the inputs and what to check before using the result in your application.
What Is array_udiff_uassoc() in PHP?
Find unmatched entries using custom comparisons for both keys and values.
Its syntax is:
array_udiff_uassoc(array $array, array ...$arrays, callable $value_compare_func, callable $key_compare_func): array
Parameters used by this operation:
$array— The collection being examined or updated.$arrays— The collection being examined or updated.$value_compare_func— A callable that controls the comparison or transformation; callbacks should follow the expected return contract.$key_compare_func— A callable that controls the comparison or transformation; callbacks should follow the expected return contract.
Value comparator comes before key comparator. Both must return negative/zero/positive comparison results.
Example 1: Basic Usage
Start with a small, self-contained input so you can inspect exactly how the operation behaves.
<?php
$first = ["Color" => "Blue", "Size" => "Large"];
$second = ["color" => "blue"];
print_r(array_udiff_uassoc($first, $second, 'strcasecmp', 'strcasecmp'));
Output:
Array
(
[Size] => Large
)
The output shows the result of the first call. Check the printed keys and values as well as their order.
Example 2: Another Important Case
This variation highlights another input shape, a comparison option, or a change in the collection.
<?php
$first = ["A" => 5, "B" => 8];
$second = ["a" => 5];
print_r(array_udiff_uassoc($first, $second, fn($left,$right) => $left <=> $right, 'strcasecmp'));
Output:
Array
(
[B] => 8
)
Compare this result with Example 1: the difference comes from the input or option selected, not from additional processing.
Practical Example: Compare imported associative records when column names differ only in letter case
Compare imported associative records when column names differ only in letter case. Save the code in a PHP file and adapt the sample data to your project.
<?php
$existingHeaders = ["Content-Type" => "JSON", "X-Region" => "EU"];
$newHeaders = ["content-type" => "json", "x-region" => "US"];
$changes = array_udiff_uassoc($newHeaders, $existingHeaders, "strcasecmp", "strcasecmp");
print_r($changes);
Output:
Array
(
[x-region] => US
)
The output comes from the completed workflow shown above. When adapting it, change the source records and keep the same checks for missing, unexpected, or invalid values.
Important Behavior and Edge Cases
Value comparator comes before key comparator. Both must return negative/zero/positive comparison results.
- Test the operation with empty or missing input and decide how your application should respond.
- Read the return value independently from any changes to variables passed by reference.
- Validate untrusted input before using the result for permissions, database changes, or user-visible output.
Comparison With Related Functions
| Function or Approach | When to Use It |
|---|---|
array_udiff_uassoc() | Find unmatched entries using custom comparisons for both keys and values |
| Related functions | array_udiff_assoc() compares keys normally; array_uintersect_uassoc() keeps matches instead of differences. |
Common Beginner Mistakes
| Mistake | Correct Approach |
|---|---|
| Returning true or false from a comparator | Return a negative integer, zero, or a positive integer to express ordering. |
| Mixing up key and value callbacks | Pay attention to the comparator order and which part of each entry it compares. |
| Assuming input values are rewritten | Value comparator comes before key comparator. Both must return negative/zero/positive comparison results. |
Key Takeaways
array_udiff_uassoc()helps you find unmatched entries using custom comparisons for both keys and values.- Value comparator comes before key comparator. Both must return negative/zero/positive comparison results.
- array_udiff_assoc() compares keys normally; array_uintersect_uassoc() keeps matches instead of differences.
- Use the practical example as a starting point, but validate real application inputs.
array_udiff_uassoc() is useful when you need to find unmatched entries using custom comparisons for both keys and values. Use its documented rules and the examples above to choose the right behavior for your data.