Laravel میں controllers کیا ہیں؟

Question

Accepted Answer

**Controllers** سے متعلقہ request-handling logic کو classes میں منظم کیا جاتا ہے۔ تمام logic کو route closures میں رکھنے کی بجائے، controllers ایک application کے actions (مثال کے طور پر تمام user سے متعلقہ operations) کو methods میں منظم کرتے ہیں — routes کو صاف رکھتے ہیں اور code کو منظم رکھتے ہیں۔

## ایک بنیادی controller

```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`۔ ہر method ایک action کو handle کرتا ہے، اور routes ان کی طرف اشارہ کرتے ہیں۔

## Resource controllers (RESTful CRUD)

```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()
```

ایک **resource controller** میں معیاری CRUD methods ہوتے ہیں، جو `Route::resource` کے ساتھ جوڑے جاتے ہیں روایتی RESTful routing کے لیے — typical CRUD resources کے لیے کم boilerplate۔

## Controllers میں Dependency injection

```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 کا service container **خودکار طور پر inject** کرتا ہے type-hinted dependencies کو controller constructors اور methods میں (`Request` سمیت) — صاف، قابل test code۔

## Controllers کو پتلا رکھیں

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

## یہ کیوں اہم ہے

Controllers Laravel کے بنیادی building block ہیں — وہ request-handling logic کو cohesive classes میں منظم کرتے ہیں، جو trivial routes سے آگے کسی بھی application کے لیے ضروری ہے۔

سمجھنا ضروری ہے کہ کیسے controllers بنائے جائیں، routes کو ان کے methods سے map کریں، اور خاص طور پر **resource controllers** کو `Route::resource` کے ساتھ استعمال کریں (روایتی RESTful CRUD کے لیے minimal boilerplate کے ساتھ) یہ Laravel apps بنانے کے لیے روزمرہ کا علم ہے۔

Laravel کی ایک اہم خصوصیت **خودکار dependency injection** ہے controllers میں service container کے ذریعے — type-hinted dependencies (services, request, mailers) خودکار طور پر resolve اور inject ہوتے ہیں، جو صاف، قابل test، loosely-coupled code کو ممکن بناتا ہے۔

اتنا ہی اہم بہترین طریقہ ہے controllers کو **پتلا** رکھنا — صرف HTTP concerns (validation، services کو call کرنا، responses واپس کرنا) کو handle کرنا اور business logic کو services/models کو سونپنا، جو code کو maintainable اور testable رکھتا ہے۔

Controllers، routing اور models کے ساتھ مل کر، Laravel کی request handling کی بنیاد بناتے ہیں، جو انہیں well-organized، professional Laravel applications بنانے کے لیے بنیادی بناتا ہے۔