فصل پنج - Migrations and Database

بخش چهارم - اتصالات دیتابیس

در لاراول، مدیریت چندین اتصال به دیتابیس و استفاده از دیتابیس‌های مختلف به صورت ساده‌ای امکان‌پذیر است.

- چندین اتصال به دیتابیس

برای مدیریت چندین اتصال به دیتابیس فایل تنظیمات config/database.php را باز کنید. در آرایه‌ی connections، می‌توانید چندین کانکشن مختلف تعریف کنید.
مثال:

'connections' => [
  'mysql' => [
    // ...
  ],
  'mysql_second' => [
    // ...
  ],
]

در اینجا دو کانکشن مختلف با نام های mysql و mysql_second را پیکربندی می کنیم.

——————

- استفاده از چندین کانکشن در کد

پس از تعریف کانکشن‌ها در فایل تنظیمات، می‌توانید به صورت زیر از آن‌ها استفاده کنید:

// connect to 'mysql'
$data = DB::connection('mysql')->select('SELECT * FROM users');

// connect to 'mysql_second'
$data = DB::connection('mysql_second')->select('SELECT * FROM products');

// In migrations
public function up()
{
  Schema::connection('mysql_second')->create('products', function (Blueprint $table) {
     // ...
  });
}

همچنین در یک مدل خاص می‌توانید کانکشن را مشخص کنید:

class Product extends Model
{
  protected $connection = 'mysql_second';
}

——————

- استفاده از MongoDB

برای استفاده از MongoDB در لاراول، می‌توانید از پکیج رسمی mongodb/laravel-mongodb استفاده کنید. این پکیج توسط MongoDB نگهداری می‌شود و ادغام کاملی با Eloquent و سایر ویژگی‌های لاراول فراهم می‌کند. در ادامه، مراحل نصب و پیکربندی این پکیج را توضیح می‌دهم:

با استفاده از Composer، پکیج را به پروژه خود اضافه کنید:

composer require mongodb/laravel-mongodb

پس از نصب پکیج، باید تنظیمات مربوط به اتصال به دیتابیس MongoDB را در فایل config/database.php اضافه کنید. در بخش connections، کانکشن mongodb را به صورت زیر تعریف کنید:

'connections' => [
    // others...

    'mongodb' => [
        'driver' => 'mongodb',
        'dsn' => env('MONGODB_URI', 'mongodb://localhost:27017'),
        'database' => env('MONGODB_DATABASE', 'laravel_app'),
    ],
],

پس از آن با کانکشن mongodb به دیتابیس mongodb خود متصل شوید.

——————

- استفاده از Redis در لاراول

لاراول به صورت داخلی از Redis پشتیبانی می‌کند.
تنظیمات Redis را می توانید در فایل config/database.php بررسی کنید.
در این دوره استفاده از ردیس به طور کامل بررسی نمی شود، اما تمامی متد های ردیس از فساد Redis در دسترس هستند:

use Illuminate\Support\Facades\Redis;

Redis::set('key', 'value');

$value = Redis::get('key');

#laravel #لاراول #فصل_۵
@AmirhDeveloper
.

ایشالا تا سال دیگه ریلیز میشه (سال میلادی منظورمه🥰)

⭐️ LaraGram
.

کامندهای Symfony که، توی Laravel هم استفاده شده و جدیدا توی LaraGram هم باز نویسی کردم، به قدری باهوش هستن که کافیه یک حرف از کامند رو بنویسی تا متوجه بشه.

اگر کامند هایی مثل m:c, ma:c, make:c, m:class یا هرچیز شبیه ش رو بزنید باز هم make:class رو متوجه میشه.

@Amirhdeveloper

❓ خروجی حلقه کدام است؟

1️⃣ Error
2️⃣ 10 9 8 7 6 5 4 3 2 1
3️⃣ Warning
4️⃣ 9 8 7 6 5 4 3 2 1 0

✅ پاسخ خود را همراه با توضیح ارائه دهید.

❗ بدون اجرای کد یا استفاده از هوش مصنوعی، کمی فکر کنید.

🔖 #PHP, #پی_اچ_پی, #چالش

👤 AmirHossein

💎 Channel: @DevelopixPHP

🔰 در این سوال نکات زیادی حائز اهمیت است که معمولا در نظر گرفته نمی‌شود.

🔍 در ادامه، ساختار حلقه را به‌طور مفصل بررسی می‌کنیم:

for ($i = 10; $i--; $i > 0) {
    echo "$i ";
}

خروجی این حلقه به‌صورت زیر خواهد بود:
9 8 7 6 5 4 3 2 1 0

⁉️ اما چرا؟
بیایید ساختار حلقه را از ابتدا بررسی کنیم.

🔰 ساختار کلی حلقه for
حلقه for از سه بخش تشکیل شده است:

1- شروع: مقداردهی اولیه متغیر حلقه.
این بخش تنها یک بار در ابتدای حلقه اجرا می‌شود.

2- شرط ادامه: تعیین می‌کند که آیا حلقه ادامه یابد یا متوقف شود.
این بخش در هر تکرار، قبل از اجرای بدنه اجرا شده و شرط اجرای بدنه را بررسی می‌کند.

3- تغییر مقدار: مقدار متغیر حلقه را تغییر می‌دهد.
این بخش پس از اجرای بدنه حلقه اجرا می‌شود.

🔰 بررسی اجرای حلقه ذکر شده

1- مقداردهی اولیه:
- ابتدا متغیر $i مقدار 10 می‌گیرد و اجرای این بخش پایان می‌یابد.

2- بررسی شرط ($i--)
در این قسمت نکات مهمی وجود دارد:

- هر عدد به جز 0 مقدار true دارد، بنابراین تا زمانی که $i به 0 نرسد، حلقه ادامه خواهد داشت.

- در عبارت $i-- از عملیات post-decrement استفاده شده است، یعنی ابتدا مقدار فعلی $i برای بررسی شرط استفاده می‌شود، سپس مقدار $i کاهش می‌یابد.
- - به همین دلیل عدد 0 نیز چاپ خواهد شد.
- - مقدار $i بعد از کاهش وارد بدنه حلقه می‌شود، بنابراین چاپ اعداد از 9 شروع می‌شود.

اگر حلقه به این صورت نوشته می‌شد:

for ($i = 10; --$i; $i > 0) {
    echo "$i ";
}

در این حالت، ابتدا مقدار $i کاهش می‌یابد و سپس شرط بررسی می‌شود زیرا از عملیات pre-decrement، بنابراین 0 چاپ نمی‌شود و خروجی به این شکل خواهد بود:
9 8 7 6 5 4 3 2 1

3- بررسی قسمت سوم (تغییر مقدار update)
- بخش سوم این حلقه روی مقدار $i تغییری ایجاد نمی‌کند، بنابراین عملاً بی‌اثر است و می‌توان حلقه را ساده‌تر نوشت:

for ($i = 10; $i--;) {
    echo "$i ";
}

🔰 مرور روند اجرای حلقه ذکر شده

- مقدار دهی اولیه i با 10
- بررسی 10 == true، کاهش 10 به 9، چاپ 9
- بررسی 9 == true، کاهش 9 به 8، چاپ 8
‏.
‏.
‏.
- بررسی 2 == true، کاهش 2 به 1، چاپ 1
- بررسی 1 == true، کاهش 1 به 0، چاپ 0
- بررسی 0 == true، پایان حلقه

❗️ درک درست post-decrement ($i--) و pre-decrement (--$i) در حلقه‌ها اهمیت زیادی دارد و تفاوت‌های ظریفی در خروجی ایجاد می‌کند.

🔖 #PHP, #پی_اچ_پی, #چالش

👤 AmirHossein

💎 Channel: @DevelopixPHP

7 ماهی از انتشار ورژن 2 گذشته و ورژن 3 درحال توسعه هست.

توی ورژن 3 تغییرات زیادی مخصوصا در پرفورمنس اعمال شده؛
سیستم های کش اکثر بخش های فریم‌ورک رو در بر گرفتن.

همچنین Eloquent ORM به صورت کاملا اختصاصی بازنویسی شده.
دلیل این بازنویسی این هست که، این ORM برای اجرا نیاز به کانتینر، ایونت‌ها، کیوها، و کلی چیز دیگه از لاراول داره.
ما همه این سیستم هارو توی LaraGram داریم، ولی الوکوئنت دقیقا برای لاراول رو نیاز داره، به همین دلیل در کنار کانتینر LaraGram باید کانتینر Laravel هم لود بشه که منطقی نیست.
اما‌ این بازنویسی تمامی وابستگی های خارجی رو حذف کرده و سرعت دوبرابر بهتر شده.

از طرفی دو کرنل HTTP و Console اضافه شدن؛
کامند ها و درخواست ها به طور دقیق بررسی میشن، Gateها و Middlewareها روی اون ها اعمال میشن و خطاها به طور دقیق مدیریت میشن.

سیستم چندزبانی اصافه شده.
قابلیت مدیریت اتصال و توسعه چند ربات همزمان اضافه میشه.

سیستمی تحت عنوان کامپوننت قراره اضافه بشه، که راستش خودم نمیدونم چی هست فقط میدونم قراره قابلیت باز استفاده از ماژول ها یا هرچیزی رو با فراخوانی یک تابع بده.
مثلا شما نیاز نیست سیستم عضویت اجباری توسعه بدید، کافیه کامپوننت اون رو لود کنید.

سیستم کیو و جاب اضافه میشه که می‌تونید به سادگی عملیات های زمان بندی شده رو توسعه بدید.

قابلیت های جزئی هم طی توسعه اضافه میشن.

و در نهایت احتمال اضافه شدن پروتکل MTProto در ورژن 3 هست؛
توسعه ش یکم سخت و زمانبر هست، برای همین قول نمیدم توی ورژن 3 بیاد، شاید توی ورژن 4 اضافه بشه، ولی میشه یک روز.

و احتمالا چیزای دیگه که در آینده به ذهنم برسه.

اگر ایده یا پیشنهادی دارید خوشحال میشم درمیون بذارید، یا توی توسعه کمک کنید.

و اگر هم به پروژه استار بدید که خیلی بیشتر خوشحال میشم❤️

- LaraGram
- Laraquest
- Core

@AmirhDeveloper
.

از فردا فصل 6 رو شروع می‌کنیم.

یادم رفت

فصل شش - Requests and Response

بخش اول - پردازش درخواست و پاسخ

در فریمورک لاراول، مفاهیم Request (درخواست) و Response (پاسخ) جزو مهم‌ترین اجزای پردازش درخواست‌های وب محسوب می‌شوند. این دو مفهوم در الگوی MVC بخش ارتباط بین کاربر (Client) و سرور (Backend) را مدیریت می‌کنند.

1- درخواست (Request)
‏Request در لاراول به تمام داده‌هایی گفته می‌شود که از طرف کاربر (مثلاً مرورگر، Postman یا یک کلاینت دیگر) به سرور ارسال می‌شود. این داده‌ها می‌توانند شامل موارد زیر باشند:

- داده‌های فرم (POST)
- پارامترهای URL (GET)
- هدرهای HTTP
- کوکی‌ها
- فایل‌های آپلود شده
- اطلاعات احراز هویت

لاراول برای مدیریت درخواست‌ها از کلاس Illuminate\Http\Request استفاده می‌کند که قابلیت‌های زیادی برای دسترسی و فیلتر کردن داده‌های ورودی دارد.

در کنترلرها، برای دریافت اطلاعات ورودی، می‌توان از کلاس Request استفاده کرد:

class UserController extends Controller
{
 public function store(Request $request)
 {
  $name = $request->input('name');

  $email = $request->input('email', 'default@example.com');

  $data = $request->all();

  $token = $request->header('Authorization');
 }
}

2- پاسخ (Response)
‏Response یا پاسخ، همان داده‌ای است که لاراول پس از پردازش درخواست به کلاینت ارسال می‌کند. این پاسخ می‌تواند شامل:

‏- HTML‏ یا View
‏- JSON‏ یا API Response
- ریدارکت (Redirect)
- دانلود فایل
- ارسال پیام‌های خطا یا موفقیت باشد.

در کنترلرها، برای ارسال پاسخ، می‌توان از فساد یا هلپر Response استفاده کرد:

class UserController extends Controller
{
 public function store(Request $request)
 {
  return response('Hello, Laravel!');

  return response()->json([
    'message' => 'Success',
    'status' => 200
  ]);

  return response()->view('welcome', ['name' => 'John']);
 }
}

در ادامه این بخش به بررسی Request و Response و تمامی متد های در دسترس از آنها خواهیم پرداخت.

#laravel #لاراول #فصل_۶
@AmirhDeveloper
.

فصل شش - Requests and Response

بخش اول - پردازش درخواست و پاسخ

لاراول برای مدیریت درخواست‌ها از کلاس Illuminate\Http\Request استفاده می‌کند که قابلیت‌های زیادی برای دسترسی و فیلتر کردن داده‌های ورودی دارد.
این کلاس معمولا در Controller ها یا Route-Closure ها استفاده می شود:

class UserController extends Controller
{
 public function store(Request $request)
 {
  $request->...
 }
}

// OR

Route::get('/', function(Request $request) {
 $request->...
});

در ادامه با متد های در دسترس از این کلاس آشنا می شویم.

1- متد path
این متد مسیر درخواست شده را بدون دامنه برمی‌گرداند.

$request->path(); // posts/10

2- متد is
بررسی می‌کند که مسیر درخواست با یک الگو مطابقت دارد یا نه.

if ($request->is('posts/*')) {
}

3- متد routeIs
بررسی می‌کند که مسیر درخواست با نام روت خاصی مطابقت دارد یا نه.

if ($request->routeIs('post.show')) {
}

4- متد url
آدرس کامل بدون query string را برمی‌گرداند.

$request->url(); // http://example.com/posts/10

5- متد fullUrl
آدرس کامل شامل query string را برمی‌گرداند.

$request->fullUrl();
// http://example.com/posts/10?sort=desc

6- متد fullUrlWithQuery
یک پارامتر کوئری را به URL اضافه می‌کند.

$request->fullUrlWithQuery(['page' => 2]); 
// http://example.com/posts?sort=desc&page=2

7- متد fullUrlWithoutQuery
برخی از پارامترهای کوئری را از URL حذف می‌کند.

$request->fullUrlWithoutQuery(['sort']);
// http://example.com/posts?page=2

8- متد host
دامنه درخواست را برمی‌گرداند.

$request->host(); // example.com

9- متد httpHost
دامنه همراه با پورت را برمی‌گرداند.

$request->httpHost(); // example.com:8080

10- متد schemeAndHttpHost
پروتکل (http یا https) و دامنه را برمی‌گرداند.

$request->schemeAndHttpHost();
// https://example.com

11- متد ip
آدرس IP درخواست‌دهنده را برمی‌گرداند.

$request->ip(); // 192.168.1.1

12- متد ips
لیست IPهای درخواست‌دهنده را برمی‌گرداند.

$request->ips();
// [192.168.1.1, 10.0.0.2]

13- متد method
متد HTTP درخواست (GET, POST, PUT, DELETE) را برمی‌گرداند.

$request->method(); // POST

14- متد isMethod
بررسی می‌کند که متد HTTP درخواست مقدار خاصی دارد یا نه.

if ($request->isMethod('post')) {
}

15- متد header
مقدار یک هدر خاص را برمی‌گرداند.

$request->header('User-Agent'); // "Mozilla/5.0"

16- متد hasHeader
بررسی می‌کند که آیا یک هدر مشخص در درخواست وجود دارد یا نه.

if ($request->hasHeader('Authorization')) {
}

17- متد bearerToken
مقدار Bearer Token در هدر Authorization را برمی‌گرداند.

$request->bearerToken();

18- متد getAcceptableContentTypes
لیستی از انواع محتوای مورد قبول در هدر Accept را برمی‌گرداند.

$request->getAcceptableContentTypes();
// ['application/json', 'text/html']

19- متد accepts
بررسی می‌کند که آیا نوع محتوای مشخص‌شده پذیرفته شده است یا نه.

if ($request->accepts('application/json')) {
}

20- متد prefers
نوع محتوای ترجیحی را برمی‌گرداند.

$request->prefers(['text/html', 'application/json']);

21- متد expectsJson
بررسی می‌کند که آیا درخواست انتظار JSON دارد یا نه.

if ($request->expectsJson()) {
}

22- متد flash
داده‌ها را برای درخواست بعدی در سشن ذخیره می‌کند.

$request->flash();

23- متد flashOnly
برخی از داده‌ها را در سشن ذخیره می‌کند.

$request->flashOnly(['name', 'email']);

24- متد flashExcept
تمام داده‌ها به‌جز موارد مشخص‌شده را در سشن ذخیره می‌کند.

$request->flashExcept(['password']);

25- متد only
فقط مقادیر مشخص‌شده را از درخواست دریافت می‌کند.

$request->only(['name', 'email']);

26- متد except
تمام مقادیر درخواست به‌جز موارد مشخص‌شده را دریافت می‌کند.

$request->except(['password']);

سایر متد ها در پست بعدی توضیح داده می‌شود.

#laravel #لاراول #فصل_۶
@AmirhDeveloper
.

فصل شش - Requests and Response

بخش اول - پردازش درخواست و پاسخ

در این قسمت به سایر متدهای در دسترس از کلاس Request می پردازیم.

1- متد cookie
مقدار یک کوکی را برمی‌گرداند.

$value = $request->cookie('user_token');

2- متد all
تمام داده‌های ورودی (query parameters، POST data، JSON payloads) را به‌صورت آرایه برمی‌گرداند.

$data = $request->all();

3- متد collect
داده‌های ورودی را به‌عنوان Collection لاراول برمی‌گرداند.
کالکشن‌ها در لاراول مجموعه‌ای از داده‌ها هستند که امکانات پیشرفته‌ای برای کار با آرایه‌ها ارائه می‌دهند.
در فصل های مربوطه به کار با کالکشن ها خواهیم پرداخت.

$collection = $request->collect();

4- متد input
مقدار یک ورودی خاص را دریافت می‌کند.

$name = $request->input('name');

همچنین می توان input مورد نظر را به صورت پراپرتی دریافت کرد:

$name = $request->name;

5- متد query
مقدار یک متغیر در query string را دریافت می‌کند.

$sort = $request->query('sort', 'asc');

پارامتر اول کلید کوئری و پارامتر دوم مقدار پیشفرض می باشد.

6- متد string
مقدار یک ورودی را به‌عنوان Stringable لاراول برمی‌گرداند.
در لاراول Stringable همانند کالکشن که برای کار با آرایه ها است، برای کار با رشته ها می باشد.

$name = $request->string('name');

این متد input با نام name را در قالب شئ از Stringable باز می گرداند و می توان متد های زیادی را بر روی آن فراخوانی کرد:

$name = $request->string('name')->upper();

7- متد integer
مقدار ورودی را به عدد صحیح (integer) تبدیل می‌کند.

$age = $request->integer('age');

8- متد boolean
مقدار ورودی را به مقدار بولی (true یا false) تبدیل می‌کند.

$active = $request->boolean('active');

9- متد date
مقدار ورودی را به شیء Carbon تبدیل می‌کند.
کربن نیز یک کلاس برای کار با زمان ها می باشد.

$birthday = $request->date('birthday');

10- متد enum
مقدار ورودی را با یک enum مقایسه می‌کند.

$status = $request->enum('status', OrderStatus::class);

11- متد enums
چند مقدار ورودی را با یک enum بررسی می‌کند.

$statuses = $request->enums('statuses', OrderStatus::class);

12- متد has
بررسی می‌کند که آیا مقدار مشخصی در درخواست وجود دارد یا نه.

if ($request->has('name')) {
}

13- متد hasAny
بررسی می‌کند که آیا حداقل یکی از مقادیر مشخص‌شده در درخواست وجود دارد یا نه.

if ($request->hasAny(['name', 'email'])) {
}

14- متد whenHas
اگر مقدار مشخص‌شده در درخواست وجود داشته باشد، یک تابع را اجرا می‌کند.

$request->whenHas('name', function ($name) {
});

15- متد isNotFilled
بررسی می‌کند که مقدار ورودی وجود نداشته باشد یا خالی باشد.

if ($request->isNotFilled('email')) {
}

16- متد filled
بررسی می‌کند که مقدار مشخص‌شده در درخواست پر شده باشد.

if ($request->filled('email')) {
}

17- متد anyFilled
بررسی می‌کند که حداقل یکی از مقادیر مشخص‌شده در درخواست پر شده باشد.

if ($request->anyFilled(['email', 'phone'])) {
}

18- متد whenFilled
اگر مقدار مشخص‌شده در درخواست پر شده باشد، یک تابع را اجرا می‌کند.

$request->whenFilled('email', function ($email) {
});

19- متد missing
بررسی می‌کند که مقدار مشخص‌شده در درخواست وجود نداشته باشد.

if ($request->missing('email')) {
}

20- متد whenMissing
اگر مقدار مشخص‌شده در درخواست وجود نداشته باشد، یک تابع را اجرا می‌کند.

$request->whenMissing('email', function () {
});

21- متد merge
مقدار جدیدی به داده‌های درخواست اضافه می‌کند.

$request->merge(['role' => 'admin']);

22- متد mergeIfMissing
مقدار جدیدی را فقط در صورتی که وجود نداشته باشد اضافه می‌کند.

$request->mergeIfMissing(['role' => 'user']);

23- متد file
یک فایل آپلودی را در قالب شئ از فایل دریافت می‌کند و می توان عملیات های مختلف مانند ذخیره سازی بر روی آن اجرا کرد.

$file = $request->file('avatar');

24- متد hasFile
بررسی می‌کند که آیا فایلی آپلود شده است یا نه.

if ($request->hasFile('avatar')) {
}

25- متد old
مقدار یک ورودی را از session دریافت می‌کند. (معمولا درخواست قبلی)

$oldValue = $request->old('name');

تا اینجا با تمامی متد های قابل فراخوانی از کلاس Request آشنا شده ایم، در قسمت بعدی به متد های Response خواهیم پرداخت.

#laravel #لاراول #فصل_۶
@AmirhDeveloper
.

فصل شش - Requests and Response

بخش اول - پردازش درخواست و پاسخ

در این قسمت به متدهای Response خواهیم پرداخت.
ریسپانس‌ها، پاسخی هستند ک از سوی کنترلرها برای کلاینت return می‌شوند.

class UserController extends Controller
{
 public function store(Request $request)
 {
  // ...

  return response("User Stored!");
 }
}

کد بالا یک نمونه از شیوه ارسال ریسپانس را نشان می‌دهد که یک متن پس از ذخیره کاربر، به سمت مرورگر کلاینت ارسال می شود.

معمولا برای ارسال ریسپانس از هلپر فانکشن ها استفاده می شود.
در ادامه با این هلپر ها آشنا می شویم.

1- متد response
ایجاد یک پاسخ ساده.

return response('Hello, World!');

متن "Hello, World!" در مرورگر نمایش داده می‌شود.

2- متد header
افزودن یک هدر (header) به پاسخ.

return response('OK')->header('X-Custom-Header', 'MyValue');

3- متد withHeaders
افزودن چندین header به پاسخ.

return response('Headers Set')->withHeaders([
 'X-Header-One' => 'Value1',
 'X-Header-Two' => 'Value2',
]);

4- متد cookie
اضافه کردن cookie به پاسخ.

return response('Cookie Set')->cookie('user', 'JohnDoe', 60);

5- متد withoutCookie
حذف یک cookie از پاسخ.

return response('Cookie Removed')->withoutCookie('user');

6- متد view
بازگرداندن یک view به عنوان پاسخ. (فایل های Blade)

return response()->view('welcome');

نمای welcome.blade.php نمایش داده می‌شود.

7- متد json
بازگرداندن یک JSON به عنوان پاسخ.

return response()->json(['name' => 'John', 'age' => 30]);

8- متد withCallback
اضافه کردن JSONP callback به پاسخ JSON.

return response()->json(['name' => 'John'])->withCallback('myCallback');

// Output:
// myCallback({"name":"John"});

9- متد download
دانلود یک فایل از سرور.

return response()->download(storage_path('app/file.pdf'));

10- متد file
نمایش یک فایل بدون دانلود.

return response()->file(storage_path('app/image.jpg'));

11- متد stream
استریم داده‌ها (ارسال محتوا به صورت chunk-شده).

return response()->stream(function () {
    echo 'Streaming content...';
});

12- متد streamJson
ارسال JSON به‌صورت استریم.

return response()->streamJson(['status' => 'processing']);

13- متد eventStream
ارسال داده‌ها به‌صورت Server-Sent Events (SSE).

return response()->eventStream(function ($stream) {
    $stream->push(['message' => 'Hello, World!']);
});

14- متد streamDownload
دانلود یک فایل به‌صورت stream.

return response()->streamDownload(function () {
    echo 'File content...';
}, 'myfile.txt');

15- متد redirect
تغییر مسیر (redirect) به یک URL.

return redirect('/home');

16- متد route
تغییر مسیر (redirect) به یک route.

return redirect()->route('dashboard');

17- متد action
تغییر مسیر (redirect) به یک controller action.

return redirect()->action([HomeController::class, 'index']);

18- متد away
تغییر مسیر (redirect) به یک URL خارجی.

return redirect()->away('https://google.com');

19- متد with
ارسال داده‌های session همراه با redirect.

return redirect()->route('home')->with('message', 'Welcome back!');

یک message در session ذخیره می‌شود و پس از redirect قابل دسترسی است.

20- متد back
بازگشت به صفحه‌ی قبلی.

return redirect()->back();

21- متد withInput
ارسال داده‌های form input در session هنگام redirect.

return redirect()->back()->withInput();

#laravel #لاراول #فصل_۶
@AmirhDeveloper
.

فصل شش - Requests and Response

بخش دوم - اعتبارسنجی درخواست ها

لاراول یک سیستم اعتبارسنجی قدرتمند و انعطاف‌پذیر ارائه می‌دهد که به شما امکان می‌دهد داده‌ها را به راحتی بررسی کرده و از ورود اطلاعات نامعتبر جلوگیری کنید.

اعتبارسنجی می‌تواند به روش‌های مختلفی انجام شود:

1- استفاده از متد validate در کنترلر

$request->validate([
  'name' => 'required|string|max:255',
  'email' => 'required|email|unique:users',
  'password' => 'required|min:8'
]);

این روش برای اعتبارسنجی ساده استفاده می‌شود. اگر داده‌ها نامعتبر باشند، لاراول به‌صورت خودکار یک پاسخ خطا ارسال می‌کند.

2- استفاده از کلاس‌های درخواست سفارشی (Form Request Validation)
برای پروژه‌های بزرگ، بهتر است قوانین اعتبارسنجی را در یک کلاس مجزا تعریف کنید:

php artisan make:request RegisterRequest

سپس در کلاس ایجاد شده، قوانین را در متد rules مشخص کنید.

public function rules(): array
{
  return [
    'noscript' => 'required|unique:posts|max:255',
    'body' => 'required',
  ];
}

ایجاد قوانین سفارشی (Custom Rules)

علاوه بر قوانین پیش‌فرض لاراول، می‌توان قوانین سفارشی نیز ایجاد کرد. این ویژگی زمانی مفید است که نیاز به اعتبارسنجی خاصی داشته باشید که در قوانین پیش‌فرض موجود نیست.

php artisan make:rule ValidUsername

در کلاس ValidUsername می‌توان منطق اعتبارسنجی را تعریف و در پروژه استفاده کرد.

public function validate(string $attribute, mixed $value, Closure $fail): void
{
  if (strtoupper($value) !== $value) {
    $fail('The :attribute must be uppercase.');
  }
}

سفارشی‌سازی پیام‌های خطا

لاراول به شما اجازه می‌دهد تا پیام‌های خطای اعتبارسنجی را شخصی‌سازی کنید:

$messages = [
  'email.required' => 'Entering an email is required.',
  'password.min' => 'The password must be at least 8 characters.',
];
$request->validate($rules, $messages);

این ویژگی برای چندزبانه کردن پیام‌های خطا نیز بسیار مفید است.

سیستم اعتبارسنجی در لاراول بسیار قدرتمند، انعطاف‌پذیر و ساده است. با استفاده از روش‌های مختلف مانند Form Request Validation، Custom Rules و شخصی‌سازی پیام‌های خطا، می‌توان داده‌های ورودی را به شکلی بهینه مدیریت کرد و از بروز خطاهای امنیتی و عملکردی جلوگیری کرد.

در پست‌های بعدی، به بررسی دقیق‌تر ساختار ولیدیشن‌ها و نحوه‌ی پیاده‌سازی قوانین سفارشی می‌پردازیم.

#laravel #لاراول #فصل_۶
@AmirhDeveloper
.