ما هي المتحكمات (Controllers) في Laravel؟

Question

Accepted Answer

**المتحكمات** تجميع منطق معالجة الطلبات ذات الصلة في فئات. بدلاً من وضع كل المنطق في إغلاق المسارات، تنظم المتحكمات إجراءات التطبيق (على سبيل المثال، جميع العمليات المتعلقة بالمستخدمين) في طرق — مما يحافظ على نظافة المسارات وتنظيم الكود.

## متحكم أساسي

```php
<?php
class UserController extends Controller {
    public function index() {
        return User::all();              // list users
    }
    public function show(User $user) {   // route model binding — auto-fetch by id
        return $user;
    }
    public function store(Request $request) {
        $validated = $request->validate(['name' => 'required', 'email' => 'required|email']);
        return User::create($validated);  // create
    }
}
```

أنشئ واحدة باستخدام Artisan: `php artisan make:controller UserController`. كل طريقة تتعامل مع إجراء واحد، والمسارات تشير إليها.

## متحكمات الموارد (CRUD الموجهة نحو REST)

```php
// generate a controller with all 7 RESTful methods stubbed
// php artisan make:controller PostController --resource

Route::resource('posts', PostController::class);   // maps routes to the methods:
// index() create() store() show() edit() update() destroy()
```

متحكم **الموارد** يحتوي على طرق CRUD القياسية، مقترنة مع `Route::resource` للمسارات الموجهة نحو REST التقليدية — حد أدنى من الكود النموذجي للموارد CRUD النموذجية.

## حقن التبعيات في المتحكمات

```php
class OrderController extends Controller {
    // type-hinted dependencies are AUTO-INJECTED by Laravel's service container
    public function __construct(private OrderService $orders) {}

public function store(Request $request, Mailer $mailer) {   // method injection too
        // $request and $mailer are resolved & injected automatically
    }
}
```

حاوية خدمات Laravel **تحقن تلقائياً** التبعيات المشار إليها بنوع في مُنشئات ودوال المتحكمات (بما في ذلك `Request`) — كود نظيف وقابل للاختبار.

## اجعل المتحكمات رقيقة

```text
✓ Controllers should handle HTTP concerns (validate input, call services, return responses)
✗ Business logic belongs in SERVICES/models, not bloated controllers ("thin controllers")
```

## لماذا هذا مهم

المتحكمات هي حجر الأساس الأساسي في Laravel — فهي تنظم منطق معالجة الطلبات في فئات متماسكة، وهو أمر ضروري لأي تطبيق يتجاوز المسارات البسيطة.

فهم كيفية إنشاء المتحكمات وربط المسارات بطرقها، والأهم من ذلك استخدام **متحكمات الموارد** مع `Route::resource` (للـ CRUD الموجهة نحو REST التقليدية مع الحد الأدنى من الكود النموذجي) هو معرفة يومية لبناء تطبيقات Laravel.

ميزة Laravel الأساسية هي **حقن التبعيات التلقائي** في المتحكمات عبر حاوية الخدمة — التبعيات المشار إليها بنوع (الخدمات والطلب والمرسلون) يتم حلها وحقنها تلقائياً، مما يتيح كوداً نظيفاً وقابلاً للاختبار وفضفاض الاقتران.

من المهم بنفس القدر ممارسة أفضل الممارسات المتمثلة في الحفاظ على المتحكمات **رقيقة** — التعامل فقط مع مخاوف HTTP (التحقق والاستدعاء للخدمات وإرجاع الاستجابات) والتفويض بمنطق الأعمال للخدمات/النماذج، مما يحافظ على الكود قابلاً للصيانة والاختبار.

تشكل المتحكمات، جنباً إلى جنب مع التوجيه والنماذج، العمود الفقري لمعالجة الطلبات في Laravel، مما يجعلها أساسية لبناء تطبيقات Laravel منظمة واحترافية.