تولید Policy (مجوزدهی)

php artisan make:module Product --policy

# تولید کامل با Policy
php artisan make:module Product --all

# یا به صورت دستی
php artisan make:module Product --api --requests --tests --policy

<?php

namespace App\Policies;

use App\Models\Product;
use App\Models\User;
use Illuminate\Auth\Access\HandlesAuthorization;

class ProductPolicy
{
    use HandlesAuthorization;

    /**
     * تعیین اینکه آیا کاربر می‌تواند لیست را مشاهده کند.
     */
    public function viewAny(User $user): bool
    {
        return true;
    }

    /**
     * تعیین اینکه آیا کاربر می‌تواند مدل را مشاهده کند.
     */
    public function view(User $user, Product $product): bool
    {
        return true;
    }

    /**
     * تعیین اینکه آیا کاربر می‌تواند مدل جدید ایجاد کند.
     */
    public function create(User $user): bool
    {
        return true;
    }

    /**
     * تعیین اینکه آیا کاربر می‌تواند مدل را بروزرسانی کند.
     */
    public function update(User $user, Product $product): bool
    {
        return true;
    }

    /**
     * تعیین اینکه آیا کاربر می‌تواند مدل را حذف کند.
     */
    public function delete(User $user, Product $product): bool
    {
        return true;
    }

    /**
     * تعیین اینکه آیا کاربر می‌تواند مدل را بازیابی کند.
     */
    public function restore(User $user, Product $product): bool
    {
        return true;
    }

    /**
     * تعیین اینکه آیا کاربر می‌تواند مدل را به صورت دائم حذف کند.
     */
    public function forceDelete(User $user, Product $product): bool
    {
        return true;
    }
}

public function create(User $user): bool
{
    return $user->role === 'admin' || $user->role === 'editor';
}

public function update(User $user, Product $product): bool
{
    return $user->id === $product->user_id;
}

public function delete(User $user, Product $product): bool
{
    // فقط ادمین‌ها یا صاحب محصول می‌توانند حذف کنند
    // و محصول نباید فروخته شده باشد
    return ($user->isAdmin() || $user->id === $product->user_id) 
        && !$product->is_sold;
}

class ProductController extends Controller
{
    public function update(UpdateProductRequest $request, Product $product)
    {
        // لاراول خودکار متد update از ProductPolicy را چک می‌کند
        $this->authorize('update', $product);
        
        // منطق بروزرسانی...
    }
    
    public function destroy(Product $product)
    {
        $this->authorize('delete', $product);
        
        // منطق حذف...
    }
}

@can('create', App\Models\Product::class)
    <a href="{{ route('products.create') }}" class="btn btn-primary">
        ایجاد محصول جدید
    </a>
@endcan

@can('update', $product)
    <a href="{{ route('products.edit', $product) }}" class="btn">ویرایش</a>
@endcan

@can('delete', $product)
    <form action="{{ route('products.destroy', $product) }}" method="POST">
        @csrf
        @method('DELETE')
        <button type="submit" class="btn btn-danger">حذف</button>
    </form>
@endcan

// در FormRequest
public function authorize(): bool
{
    return $this->user()->can('create', Product::class);
}

// در Resource
class ProductResource extends JsonResource
{
    public function toArray($request)
    {
        return [
            'id' => $this->id,
            'name' => $this->name,
            'can_update' => $request->user()?->can('update', $this->resource),
            'can_delete' => $request->user()?->can('delete', $this->resource),
        ];
    }
}

'paths' => [
    'policy' => 'Policies',
    // یا
    'policy' => 'Domain/Authorization/Policies',
],

// Policy به صورت خودکار با namespace صحیح تولید می‌شود
use App\Models\User;
// یا
use App\Domain\Users\User;

public function viewAny(?User $user): bool
{
    // مهمان‌ها هم می‌توانند لیست را ببینند
    return true;
}

public function create(?User $user): bool
{
    // فقط کاربران لاگین‌شده
    return $user !== null;
}

class PostPolicy
{
    public function update(User $user, Post $post): bool
    {
        // نویسنده یا ادمین می‌تواند ویرایش کند
        return $user->id === $post->author_id || $user->isAdmin();
    }
    
    public function publish(User $user, Post $post): bool
    {
        // فقط ادمین می‌تواند منتشر کند
        return $user->isAdmin();
    }
}

class OrderPolicy
{
    public function view(User $user, Order $order): bool
    {
        // مشتری خودش یا ادمین
        return $user->id === $order->customer_id || $user->isAdmin();
    }
    
    public function cancel(User $user, Order $order): bool
    {
        // فقط اگر هنوز ارسال نشده باشد
        return $user->id === $order->customer_id 
            && $order->status === 'pending';
    }
}

class DocumentPolicy
{
    public function viewAny(User $user): bool
    {
        return $user->hasAnyRole(['viewer', 'editor', 'admin']);
    }
    
    public function create(User $user): bool
    {
        return $user->hasAnyRole(['editor', 'admin']);
    }
    
    public function delete(User $user, Document $document): bool
    {
        return $user->hasRole('admin');
    }
}

// در AuthServiceProvider.php (در صورت نیاز)
protected $policies = [
    Product::class => ProductPolicy::class,
];