Document associative array where clauses

[MarkHolmesRex]

In January 2016 a feature was added to allow where clauses with associative arrays, where the column name is the array key and the where value is the array value. It seems like this was never documented, however I imagine since it's such an intuitive way to use the where clause a number of projects are likely using it without realising it's an undocumented feature. It's also a good feature that should stay as it's a common use case to already have such an array and want to be able to use it in a query.

• Original commit: laravel/framework@491feeb
• Framework code: /Illuminate/Database/Query/Builder.php::addArrayOfWheres()

Code block (the else statement is the feature implementation):

    protected function addArrayOfWheres($column, $boolean, $method = 'where')
    {
        return $this->whereNested(function ($query) use ($column, $method, $boolean) {
            foreach ($column as $key => $value) {
                if (is_numeric($key) && is_array($value)) {
                    $query->{$method}(...array_values($value), boolean: $boolean);
                } else {
                    $query->{$method}($key, '=', $value, $boolean);
                }
            }
        }, $boolean);
    }

This code is still there in the latest version.