كيف تتعامل مع الطلبات والاستجابات؟

Question

Accepted Answer

يقوم Laravel بتغليف HTTP في كائنات **Request** و**Response** مريحة. يوفر كائن `Request` وصولاً آمناً وسلساً إلى البيانات الواردة (المدخلات، الملفات، الرؤوس)؛ وتجعل مساعدات استجابة Laravel من إرجاع المشاهد، JSON، إعادات التوجيه، وغير ذلك أمراً مباشراً.

## الوصول إلى بيانات الطلب

```php
public function store(Request $request) {
    $request->input('name');             // a specific input field
    $request->name;                       // shorthand access
    $request->only(['name', 'email']);    // a subset
    $request->all();                      // all input
    $request->query('sort');              // a query string param (?sort=)
    $request->has('email');               // check presence
    $request->input('page', 1);           // with a default

$request->file('avatar');             // an uploaded file
    $request->header('Authorization');
    $request->user();                     // the authenticated user
    $request->ip(); $request->method();   // request metadata
}
```

كائن `Request` (المحقون تلقائياً في طرق المتحكم) يوفر وصولاً نظيفاً وآمناً إلى جميع البيانات الواردة — أفضل بكثير من المتغيرات العامة الخام `$_GET`/`$_POST`، مع طرق مساعدة للاحتياجات الشائعة.

## إرجاع الاستجابات

```php
return view('users.index', ['users' => $users]);   // render a Blade view
return response()->json($data, 200);                // JSON (auto for arrays/models too)
return $user;                                       // a model → auto-serialized to JSON
return redirect('/home');                            // redirect
return redirect()->route('profile')->with('msg', 'Saved!');   // redirect + flash message
return back();                                       // redirect to the previous page
return response()->download($path);                  // file download
```

تتعامل مساعدات الاستجابة في Laravel مع الحالات الشائعة بأناقة: عرض المشاهد، إرجاع JSON (المصفوفات ونماذج Eloquent تتسلسل تلقائياً إلى JSON)، إعادات التوجيه (مع الرسائل المؤقتة)، والتنزيلات. إرجاع نموذج أو مصفوفة من متحكم ينتج تلقائياً استجابة JSON.

## تخصيص الاستجابات

```php
return response()->json(['error' => 'Not found'], 404)
    ->header('X-Custom', 'value');                   // custom status + headers
return response('Hello', 200)->header('Content-Type', 'text/plain');
```

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

التعامل مع الطلبات والاستجابات أمر أساسي في كل تطبيق Laravel — التعامل مع البيانات الواردة وإرجاع الإخراج هو جوهر معالجة الطلب، لذا فإن فهم هذه الكائنات أمر ضروري يومي.

كائن **Request** يوفر وصولاً نظيفاً وآمناً ومريحاً إلى جميع البيانات الواردة (المدخلات، معاملات الاستعلام، الملفات، الرؤوس، المستخدم المصرح له) من خلال طرق مفيدة — تحسن كبير على المتغيرات العامة الخام في PHP (`$_GET`/`$_POST`)، سواء من حيث سهولة الاستخدام أو تشجيع المعالجة الآمنة.

مساعدات **الاستجابة** في Laravel تجعل إرجاع جميع أنواع الاستجابات الشائعة أنيقاً: عرض مشاهد Blade، إرجاع JSON (مع تسلسل المصفوفات ونماذج Eloquent تلقائياً — مريح للواجهات البرمجية)، إعادات التوجيه (مع الرسائل المؤقتة للتعليقات)، تنزيلات الملفات، والاستجابات المخصصة مع رموز الحالة والرؤوس المحددة.

فهم كيفية الوصول إلى بيانات الطلب من خلال طرق كائن Request وكيفية إرجاع نوع الاستجابة المناسب (المشاهد للصفحات، JSON للواجهات البرمجية، إعادات التوجيه بعد الإجراءات) هو معرفة أساسية يجب معرفتها لبناء أي نقطة نهاية في Laravel، لأن كل طريقة متحكم تتلقى طلباً وترجع استجابة.

الراحة والأمان لتجريدات الطلب/الاستجابة في Laravel هي جزء مما يجعل الإطار منتجاً، والبراعة بها أساسية للتطوير الفعال في Laravel.