Laravel ਵਿੱਚ controllers ਕੀ ਹਨ?

Question

Accepted Answer

**Controllers** ਸੰਬੰਧਿਤ request-ਹੈਂਡਲਿੰਗ ਲਾਜ਼ਿਕ ਨੂੰ ਕਲਾਸਾਂ ਵਿੱਚ ਸਮੂਹਿਤ ਕਰਦੇ ਹਨ। ਸਾਰੇ ਲਾਜ਼ਿਕ ਨੂੰ route closures ਵਿੱਚ ਪਾਉਣ ਦੀ ਥਾਂ, controllers ਇੱਕ ਐਪਲੀਕੇਸ਼ਨ ਦੀਆਂ ਕਿਰਿਆਵਾਂ (ਜਿਵੇਂ ਸਾਰੇ user-ਸੰਬੰਧਿਤ ਓਪਰੇਸ਼ਨ) ਨੂੰ methods ਵਿੱਚ ਸਮੂਹਿਤ ਕਰਦੇ ਹਨ — routes ਨੂੰ ਸਾਫ ਅਤੇ ਕੋਡ ਨੂੰ ਸਮੂਹਿਤ ਰੱਖ ਕੇ।

## ਇੱਕ ਬੁਨਿਆਦੀ 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 ਇੱਕ ਕਿਰਿਆ ਨੂੰ ਹੈਂਡਲ ਕਰਦਾ ਹੈ, ਅਤੇ 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` ਦੇ ਨਾਲ paired conventional RESTful routing ਲਈ — ਆਮ 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 **ਆਪਣੇ ਆਪ type-hinted dependencies ਨੂੰ inject ਕਰਦਾ ਹੈ** controller constructors ਅਤੇ methods ਵਿੱਚ (Request ਸਮੇਤ) — ਸਾਫ, testable ਕੋਡ।

## 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 ਦਾ ਇੱਕ ਮੂਲ ਬਿਲਡਿੰਗ ਬਲਾਕ ਹਨ — ਉਹ request-ਹੈਂਡਲਿੰਗ ਲਾਜ਼ਿਕ ਨੂੰ cohesive ਕਲਾਸਾਂ ਵਿੱਚ ਸਮੂਹਿਤ ਕਰਦੇ ਹਨ, ਜੋ trivial routes ਤੋਂ ਪਰੇ ਕਿਸੇ ਵੀ ਐਪਲੀਕੇਸ਼ਨ ਲਈ ਜ਼ਰੂਰੀ ਹੈ।

Yes controllers ਕੋ ਕਿਵੇਂ ਬਣਾਉਣਾ ਹੈ, routes ਨੂੰ ਉਹਨਾਂ ਦੇ methods ਨਾਲ ਕਿਵੇਂ ਮੈਪ ਕਰਨਾ ਹੈ, ਅਤੇ ਖਾਸ ਤੌਰ 'ਤੇ **resource controllers** ਨੂੰ `Route::resource` ਦੇ ਨਾਲ ਕਿਵੇਂ ਵਰਤਣਾ ਹੈ (conventional RESTful CRUD ਲਈ ਘੱਟ boilerplate ਦੇ ਨਾਲ) ਬਾਰੇ ਸਮਝਣਾ Laravel apps ਬਣਾਉਣ ਲਈ ਰੋਜ਼ਾਨਾ ਦਾ ਗਿਆਨ ਹੈ।

Laravel ਦੀ ਇੱਕ ਮੁੱਖ ਵਿਸ਼ੇਸ਼ਤਾ controllers ਵਿੱਚ **ਆਪਣੇ ਆਪ dependency injection** ਹੈ service container ਦੁਆਰਾ — type-hinted dependencies (services, request, mailers) ਆਪਣੇ ਆਪ ਹੱਲ ਕੀਤੀਆਂ ਜਾਂਦੀਆਂ ਹਨ ਅਤੇ inject ਕੀਤੀਆਂ ਜਾਂਦੀਆਂ ਹਨ, ਸਾਫ, testable, loosely-coupled ਕੋਡ ਨੂੰ ਸਮਰਥ ਬਣਾ ਕੇ।

ਬਰਾਬਰ ਮਹੱਤਵਪੂਰਨ controllers ਨੂੰ **ਪਤਲਾ** ਰੱਖਣ ਦੀ ਸਿਖਲਾਈ ਹੈ — ਸਿਰਫ HTTP concerns (validation, services ਨੂੰ ਕਾਲ ਕਰਨਾ, responses ਵਾਪਸ ਕਰਨਾ) ਹੈਂਡਲ ਕਰਨਾ ਅਤੇ business logic ਨੂੰ services/models ਨੂੰ delegate ਕਰਨਾ, ਜੋ ਕੋਡ ਨੂੰ maintainable ਅਤੇ testable ਰੱਖਦਾ ਹੈ।

Controllers, routing ਅਤੇ models ਦੇ ਨਾਲ, Laravel ਦੀ request handling ਦੀ backbone ਬਣਾਉਂਦੇ ਹਨ, ਉਹਨਾਂ ਨੂੰ well-organized, professional Laravel applications ਬਣਾਉਣ ਲਈ fundamental ਬਣਾਉਂਦੇ ਹਨ।