‏laravel-query-builder v7.3.0: گروه‌بندی فیلترها با یک پارامتر

پکیج laravel-query-builder از اسپاتی یه ابزار محبوب لاراول برای فیلتر کردن کوئری‌ها از طریق query string URLه. مثلاً با تعریف AllowedFilter::partial('name')، درخواست به آدرس /users?filter[name]=john به‌صورت خودکار یه کوئری LIKE '%john%' اجرا می‌کنه. یه نکته مهم هم اینه که اگه کاربر سعی کنه روی فیلدی که مجاز نیست فیلتر بزنه، پکیج یه خطای InvalidFilterQuery با کد ۴۰۰ برمی‌گردونه.

مشکل قدیمی اینجا بود که وقتی می‌خواستی یه باکس جستجو داشته باشی که همزمان چند ستون رو بگرده، باید از AllowedFilter::callback استفاده می‌کردی. این روش یه تله پنهان داشت: اگه فراموش می‌کردی شرط‌های OR رو داخل یه closure مجزا بپیچی، عملگر OR اولویت پایین‌تری از AND داشت و کوئری نتایج اشتباه برمی‌گردوند — مثلاً کاربران غیرفعال هم توی نتایج می‌اومدن.