الگوی Criteria (فیلترسازی پیشرفته)

<?php

namespace App\Repositories\Criteria;

use Illuminate\Database\Eloquent\Builder;

interface CriteriaInterface
{
    /**
     * اعمال Criteria به کوئری
     */
    public function apply(Builder $model): Builder;
}

<?php

namespace App\Repositories\Criteria;

use Illuminate\Database\Eloquent\Builder;

class ActiveProductsCriteria implements CriteriaInterface
{
    public function apply(Builder $model): Builder
    {
        return $model->where('is_active', true);
    }
}

use App\Repositories\Criteria\ActiveProductsCriteria;

class ProductController extends Controller
{
    public function __construct(
        private ProductRepositoryInterface $repository
    ) {}
    
    public function index()
    {
        $products = $this->repository
            ->pushCriteria(new ActiveProductsCriteria())
            ->getAll();
            
        return ProductResource::collection($products);
    }
}

use App\Repositories\Criteria\ActiveProductsCriteria;
use App\Repositories\Criteria\FeaturedCriteria;
use App\Repositories\Criteria\InStockCriteria;

$products = $this->repository
    ->pushCriteria(new ActiveProductsCriteria())
    ->pushCriteria(new FeaturedCriteria())
    ->pushCriteria(new InStockCriteria())
    ->getAll();

class CreatedAfterCriteria implements CriteriaInterface
{
    public function __construct(
        private string $date
    ) {}
    
    public function apply(Builder $model): Builder
    {
        return $model->where('created_at', '>=', $this->date);
    }
}

// استفاده
$products = $this->repository
    ->pushCriteria(new CreatedAfterCriteria('2024-01-01'))
    ->getAll();

class ByCategoryCriteria implements CriteriaInterface
{
    public function __construct(
        private int $categoryId
    ) {}
    
    public function apply(Builder $model): Builder
    {
        return $model->where('category_id', $this->categoryId);
    }
}

class PriceRangeCriteria implements CriteriaInterface
{
    public function __construct(
        private ?float $minPrice = null,
        private ?float $maxPrice = null
    ) {}
    
    public function apply(Builder $model): Builder
    {
        if ($this->minPrice !== null) {
            $model->where('price', '>=', $this->minPrice);
        }
        
        if ($this->maxPrice !== null) {
            $model->where('price', '<=', $this->maxPrice);
        }
        
        return $model;
    }
}

// استفاده
$products = $this->repository
    ->pushCriteria(new PriceRangeCriteria(100, 500))
    ->getAll();

class SearchCriteria implements CriteriaInterface
{
    public function __construct(
        private string $query,
        private array $fields = ['name', 'description']
    ) {}
    
    public function apply(Builder $model): Builder
    {
        return $model->where(function ($query) {
            foreach ($this->fields as $field) {
                $query->orWhere($field, 'LIKE', "%{$this->query}%");
            }
        });
    }
}

// استفاده
$products = $this->repository
    ->pushCriteria(new SearchCriteria('laptop', ['name', 'description', 'tags']))
    ->getAll();

class OrderByCriteria implements CriteriaInterface
{
    public function __construct(
        private string $column = 'created_at',
        private string $direction = 'desc'
    ) {}
    
    public function apply(Builder $model): Builder
    {
        return $model->orderBy($this->column, $this->direction);
    }
}

class WithRelationsCriteria implements CriteriaInterface
{
    public function __construct(
        private array $relations
    ) {}
    
    public function apply(Builder $model): Builder
    {
        return $model->with($this->relations);
    }
}

// استفاده
$products = $this->repository
    ->pushCriteria(new WithRelationsCriteria(['category', 'tags', 'images']))
    ->getAll();

$product = $this->repository
    ->pushCriteria(new ActiveProductsCriteria())
    ->findDynamic(
        where: ['slug' => 'iphone-15'],
        with: ['reviews']
    );

// حذف یک Criteria خاص
$this->repository->popCriteria(ActiveProductsCriteria::class);

// یا با instance
$criteria = new ActiveProductsCriteria();
$this->repository
    ->pushCriteria($criteria)
    ->popCriteria($criteria);

// نادیده گرفتن تمام Criteria‌ها برای این کوئری
$allProducts = $this->repository
    ->pushCriteria(new ActiveProductsCriteria())
    ->skipCriteria()
    ->getAll();

// برگرداندن حالت عادی
$activeProducts = $this->repository
    ->skipCriteria(false)
    ->getAll();

$activeCriteria = $this->repository->getCriteria();

class ProductFilterCriteria implements CriteriaInterface
{
    public function __construct(
        private array $filters
    ) {}
    
    public function apply(Builder $model): Builder
    {
        if (!empty($this->filters['category'])) {
            $model->where('category_id', $this->filters['category']);
        }
        
        if (!empty($this->filters['min_price'])) {
            $model->where('price', '>=', $this->filters['min_price']);
        }
        
        if (!empty($this->filters['max_price'])) {
            $model->where('price', '<=', $this->filters['max_price']);
        }
        
        if (!empty($this->filters['search'])) {
            $model->where(function ($query) {
                $query->where('name', 'LIKE', "%{$this->filters['search']}%")
                      ->orWhere('description', 'LIKE', "%{$this->filters['search']}%");
            });
        }
        
        if (!empty($this->filters['sort'])) {
            $direction = $this->filters['sort_direction'] ?? 'asc';
            $model->orderBy($this->filters['sort'], $direction);
        }
        
        return $model;
    }
}

// استفاده در Controller
public function index(Request $request)
{
    $products = $this->repository
        ->pushCriteria(new ProductFilterCriteria($request->all()))
        ->getAll();
        
    return ProductResource::collection($products);
}

class PublishedCriteria implements CriteriaInterface
{
    public function apply(Builder $model): Builder
    {
        // استفاده از scope مدل
        return $model->published();
    }
}

// ✅ درست
class StatusCriteria implements CriteriaInterface
{
    public function __construct(private string $status) {}
    
    public function apply(Builder $model): Builder
    {
        return $model->where('status', $this->status);
    }
}

// ❌ غلط
class StatusCriteria implements CriteriaInterface
{
    private string $status;
    
    public function setStatus(string $status)
    {
        $this->status = $status;
    }
}

// ✅ درست
ActiveProductsCriteria
PublishedPostsCriteria
OrderByPriceCriteria

// ❌ غلط  
ProductCriteria
FilterCriteria
Criteria1

// ✅ درست - دو Criteria جدا
$products = $this->repository
    ->pushCriteria(new ActiveCriteria())
    ->pushCriteria(new InStockCriteria())
    ->getAll();

// ❌ غلط - همه چیز در یک Criteria
$products = $this->repository
    ->pushCriteria(new ActiveAndInStockAndFeaturedCriteria())
    ->getAll();

use Tests\TestCase;
use App\Repositories\Criteria\ActiveProductsCriteria;
use App\Models\Product;

class ActiveProductsCriteriaTest extends TestCase
{
    public function test_filters_active_products()
    {
        // Arrange
        Product::factory()->create(['is_active' => true]);
        Product::factory()->create(['is_active' => false]);
        
        // Act
        $criteria = new ActiveProductsCriteria();
        $query = Product::query();
        $result = $criteria->apply($query)->get();
        
        // Assert
        $this->assertCount(1, $result);
        $this->assertTrue($result->first()->is_active);
    }
}