PHP Laravel: понимание этого замыкания

Question

У меня есть этот фрагмент из документации Laravel:

DB::table('users')
            ->whereExists(function ($query) {
                $query->select(DB::raw(1))
                      ->from('orders')
                      ->whereRaw('orders.user_id = users.id');
            })
            ->get();

Мне нужно понять две вещи.

1. Откуда берется параметр $query для замыкания? Я подозреваю, что под капотом происходит что-то, чего я не понимаю. Функция принимает 1 параметр, $query, но откуда она берется, как эта функция узнает, что находится в этом параметре, что передается в функцию?
2. Похоже, что это замыкание не возвращает значение, оператора return нет. Так как же метод whereExists узнает возвращаемое значение замыкания?

Answer 1

Ссылка на источник: https://github.com/laravel/framework/blob/987a21f39f203c76665f6014cbef10451689fbdd/src/Illuminate/Database/Query/Builder.php#L1333

Как видите, замыкание рассматривается как обратный вызов.

То есть whereExists передает $query ему. $query является экземпляром класса self (Builder), поэтому код в замыкании просто обновляет объект.

/**
 * Add an exists clause to the query.
 *
 * @param  \Closure $callback
 * @param  string   $boolean
 * @param  bool     $not
 * @return $this
 */
public function whereExists(Closure $callback, $boolean = 'and', $not = false)
{
    $query = $this->forSubQuery();
    // Similar to the sub-select clause, we will create a new query instance so
    // the developer may cleanly specify the entire exists query and we will
    // compile the whole thing in the grammar and insert it into the SQL.
    call_user_func($callback, $query);
    return $this->addWhereExistsQuery($query, $boolean, $not);
}