Understanding and Using PHP's array_unique() Function

1. Function Definition and Parameters

The array_unique() function removes duplicate values from an array and returns a new array. Its syntax is:

array_unique(array $array [, int $sort_flags = SORT_STRING]): array

The $array parameter is required and represents the array to be deduplicated. The optional $sort_flags parameter determines the sorting method, defaulting to SORT_STRING, which casts elements to strings before sorting.

2. Implementation Method

The implementation creates an empty result array, iterates over the input array, and adds each element to the result only if it is not already present. After processing, it optionally sorts the result based on $sort_flags and returns the result.

function array_unique(array $array, int $sort_flags = SORT_STRING): array {
    $result = array();
    foreach ($array as $value) {
        if (!in_array($value, $result)) {
            $result[] = $value;
        }
    }
    if ($sort_flags !== null) {
        sort($result, $sort_flags);
    }
    return $result;
}

3. Usage Example

The following code demonstrates how to use array_unique() to remove duplicates:

$array = array("red", "green", "blue", "green");
$new_array = array_unique($array);
print_r($new_array);

The output will be:

Array
(
    [0] => red
    [1] => green
    [2] => blue
)

4. Performance Optimization

For better performance, you can combine array_flip() with array_keys() to achieve deduplication more efficiently. The optimized implementation swaps keys and values, sorts if needed, and then extracts the keys as the unique array.

function array_unique(array $array, int $sort_flags = SORT_STRING): array {
    $tmp_array = array_flip($array);
    if ($sort_flags !== null) {
        ksort($tmp_array, $sort_flags);
    }
    return array_keys($tmp_array);
}

Conclusion

The array_unique() function is a practical tool for removing duplicate entries in PHP arrays. Understanding its parameters, internal logic, and possible optimizations allows developers to use it effectively and improve application performance.