. */ declare(strict_types=1); namespace Fisharebest\Webtrees\Services; use Closure; use Illuminate\Database\Capsule\Manager as DB; use Illuminate\Database\Query\Builder; use Symfony\Component\HttpFoundation\JsonResponse; use Symfony\Component\HttpFoundation\Request; use function strtr; /** * Paginate and search queries for datatables. */ class DatatablesService { /** * Apply filtering and pagination to a query, and generate a response suitable for datatables. * * @link http://www.datatables.net/usage/server-side * * @param Request $request Includes the datatables request parameters. * @param Builder $query A query to fetch the unfiltered rows and columns. * @param string[] $search_columns The names of searchable columns. * @param Closure $callback Converts a row-object to an array-of-columns. * * @return JsonResponse */ public function handle(Request $request, Builder $query, array $search_columns, Closure $callback): JsonResponse { $search = $request->get('search', [])['value'] ?? ''; $start = (int) $request->get('start'); $length = (int) $request->get('length'); $order = $request->get('order', []); $draw = (int) $request->get('draw'); // Count unfiltered records $recordsTotal = (clone $query)->count(); // Filtering if ($search !== '') { $query->where(function (Builder $query) use ($search, $search_columns): void { foreach ($search_columns as $search_column) { $query->whereContains($search_column, $search, 'or'); } }); } // Sorting if (!empty($order)) { foreach ($order as $value) { // Columns in datatables are numbered from zero. // Columns in MySQL are numbered starting with one. $query->orderBy(DB::raw(1 + $value['column']), $value['dir']); } } else { $query->orderBy(DB::raw(1)); } // Paginating if ($length > 0) { $recordsFiltered = (clone $query)->count(); $query->skip($start)->limit($length); $data = $query->get(); } else { $data = $query->get(); $recordsFiltered = $data->count(); } $data = $data->map($callback)->all(); return new JsonResponse([ 'draw' => $draw, 'recordsTotal' => $recordsTotal, 'recordsFiltered' => $recordsFiltered, 'data' => $data, ]); } }