فصل شش - 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 [
    'title' => '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, #PHP, #فصل_۶, #لاراول

👤 AmirHossein

💎 Channel: @DevelopixLaravel

فصل شش - Requests and Response

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

اعتبارسنجی ها عمدتا به 3 روش انجام می شوند. در این پست به 2 روش آن اشاره می شود و روش سوم در پست های بعدی کامل بررسی خواهد شد.

یکی از روش های مرسوم اعتبارسنجی بر روی درخواست ها (ورودی ها POST، GET و...) فراخوانی متد validate از متغیر $request می باشد.

public function store(Request $request)
{
  $validated = $request->validate([
    'title' => 'required|unique:posts|max:255',
    'body' => 'required',
  ]);
}

کد بالا درخواست ما را اعتبارسنجی می کند، به عنوان مثال، مقدار input با نام title باید required، unique و طول حداکثر 255 کاراکتر داشته باشد.
اگر همه این ویژگی ها را داشته باشد اعتبارسنجی درخواست موفقیت آمیز بوده، در غیر اینصورت یک آرایه از error ها ایجاد می شود.

روش دیگر اعتبارسنجی استفاده از فساد Validator است:

$validator = Validator::make($request->all(), [
  'title' => 'required|unique:posts|max:255',
  'body' => 'required',
]);

کد بالا همانند روش اول است، با این تفاوت که می توان اعتبارسنجی را روی داده های دلخواه (پارامتر اول متد make که برابر تمامی ورودی های درخواست قرار کرفته) انجام داد.

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

پس از انجام اعتبار سنجی یک شئ از Validator باز می گردد که متدهایی در اختیار ما می گذارد، در ادامه به بررسی آنها خواهیم پرداخت.

1- متد fails
این متد بررسی می‌کند که آیا عملیات اعتبارسنجی شکست خورده یا نه.

if ($validator->fails()) {
  return response('fails');
}

2- متد validated
اگر اعتبارسنجی موفقیت‌آمیز باشد، این متد فقط داده‌های معتبر (validated) را بازمی‌گرداند. این روش، داده‌های تاییدشده را فیلتر می‌کند.

$validated = $validator->validated();

3- متد stopOnFirstFailure
اگر بخواهید عملیات اعتبارسنجی به‌محض اولین خطا متوقف شود، از این متد استفاده می‌کنید.

$validator = Validator::make($request->all(), [
  'name' => 'required',
])->stopOnFirstFailure();

4- متد validate
مقدار اعتبارسنجی‌شده را باز می‌گرداند یا اگر خطایی وجود داشته باشد، به‌صورت خودکار ValidationException پرتاب می‌کند. معمولاً در کنترلر استفاده می‌شود.

$validated = $request->validate([
  'name' => 'required',
]);

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

5- متد validateWithBag
مشابه validate() است ولی خطاها را داخل یک Error Bag خاص ذخیره می‌کند. برای مثال وقتی چند فرم در یک صفحه داریم و هرکدام باید خطاهای جداگانه داشته باشند.

$request->validateWithBag('updateProfile', [
  'name' => 'required',
]);

درصورت بروز خطا، ارورها در یک Bag با نام updateProfile ذخیره می شوند.

6- متد after
پس از اجرای تمام قوانین اعتبارسنجی، می‌توانید با این متد، اعتبارسنجی‌های سفارشی اضافه کنید.

$validator->after(function ($validator) use ($request) {
  if ($request->password !== $request->confirm_password) {
    $validator->errors()->add('confirm_password', 'Password is incorrect.');
  }
});

7- متد errors
لیست خطاهای اعتبارسنجی را باز می‌گرداند، معمولاً در ترکیب با fails() استفاده می‌شود.

$errors = $validator->errors();

8- متد sometimes
اجرا شدن قوانین اعتبارسنجی را وابسته به شرط خاصی می‌کند.

$validator->sometimes('email', 'required', function ($input) {
  return $input->subscribe == true;
});

در این مثال، اگر مقدار subscribe برابر با true باشد، فیلد email اجباری خواهد شد.

متد های دیگری نیز وجود دارد که شامل آموزش نخواهد شد.

درصوتی که یک اعتبارسنجی ناموفق باشد، خطا ها در متغیر $errors در سمت Blade در دسترس خواهد گرفت.
به عنوان مثال:

@if ($errors->any())
  @foreach ($errors->all() as $error)
    {{ $error }}
  @endforeach
@endif

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

همچنین می توان از دایرکتیو @error استفاده کنید:

@error('title')
  <div class="alert alert-danger">{{ $message }}</div>
@enderror

این کد در صورتی که اینپوت title با خطا مواجه شود، متن خطای آن را به کاربر نمایش می دهد.

اگر نیاز به خطا ها از یک Bag خاص داشتید می توانید پارامتر دوم را نیز کامل کنید:

@error('title', 'myBag')

تا این بخش با روش اعتبارسنجی درخواست ها و نمایش خطاهای آن آشنا شدید، در قسمت های بعدی با Ruleهای اعتبارسنجی (required|unique|...) آشنا خواهیم شد.

🔖 #Laravel, #PHP, #فصل_۶, #لاراول

👤 AmirHossein

💎 Channel: @DevelopixLaravel

❓ خروجی کد بالا کدام است؟

➖ A
Outer 1
Inner 1
Outer 2
Inner 1

➖ B
Outer 1
Inner 1
Inner 2
Outer 2
Inner 1

➖ C
Outer 1
Inner 1

➖ D
Outer 1
Inner 1
Inner 2

💢 نکته : لطفا اندکی تامل کنید، از اجرای کد و استفاده از هوش مصنوعی خودداری کنید.

⚜️ پاسخ خود را همراه با توضیح ارسال کنید.

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

👤 AmirHossein

💎 Channel: @DevelopixPHP

🔰 این سوال بسیار راحت است، درصورتی که با break و continue که با یک عدد همراه است آشنا باشید.

🔸 کد ما به این صورت است:

for ($i = 1; $i < 3; $i++) {
  echo "Outer $i\n";
  for ($j = 1; $j < 3; $j++) {
    echo "\tInner $j\n";
    if ($j == 1) break 2;
    if ($j == 2) continue 2;
  }
}

🔹 و خروجی آن گزینه C، یعنی:
Outer 1
Inner 1

⁉️ اما چرا؟
⚜️ بیایید ابتدا با دستورات break، و continue به صورت دقیق تر آشنا شویم.

🔻 ‏break N چیست؟
‏break به صورت معمول از یک حلقه خارج می‌شود. اما اگر بنویسیم break 2، به معنی خروج از دو سطح حلقه است.
یعنی در این کد:

if ($j == 1) break 2;

اگر شرط ‎$j == 1 برقرار شود، هم از حلقه داخلی و هم خارجی خارج می‌شود. یعنی اجرای کل حلقه‌ها متوقف می‌شود.

🔻 ‏continue N چیست؟
‏continue معمولاً ادامه حلقه جاری را رها می‌کند و می‌رود سراغ تکرار بعدی همان حلقه. اما continue 2 می‌گوید برو سراغ تکرار بعدی حلقه سطح دوم.
در این کد:

if ($j == 2) continue 2;

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

🔸 در هر دو حالت، عدد بعد از break یا continue مشخص می‌کند که چند سطح از حلقه را تحت تأثیر قرار می‌دهد.
⭕️ نکته: عدد بعد از break یا continue باید به تعداد سطوح حلقه باشد.

⚜️ حالا بیایید ببینیم این کد دقیقاً چطور اجرا می‌شود:

اولین دور حلقه بیرونی: ‎$i = 1
Outer 1
اولین دور حلقه داخلی: ‎$j = 1
Inner 1
سپس:

if ($j == 1) break 2;

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

⭕️ نکته: دستور continue هرگز اجرا نخواهد شد.

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

👤 AmirHossein

💎 Channel: @DevelopixPHP

فصل هفت - Services و Dependency Injection

بخش اول - سرویس کانتینر

‏Service Container (IoC Container) یکی از قدرتمندترین ابزارها در لاراول هست، وظیفه این سرویس قدرتمند Dependency Injection و Inversion of Control می‌باشد.

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

همونطور که گفته شد لاراول به صورت خودکار کلاس‌هایی که وابستگی ندارن، یا فقط به کلاس‌های کامل (concrete) وابسته‌ان رو بدون نیاز به تنظیم دستی و به صورت خودکار resolve بکنه. مثلا:

Route::get('/', function (Service $service) {
  dd($service::class);
});

وقتی یک کلاس ساده مثل Service به صورت type-hint تعریف شده باشه، کانتینر خودش اون رو instantiate و inject می‌کنه بدون این که ما جای دیگه‌ای مشخص کنیم.

اما همه این دپندنسی ها به صورت خودکار فراهم نمی‌شوند، به همین دلیل Service Providerها به کمک ما می‌آیند.
لاراول به صورت پیشفرض یک پروایدر در مسیر App\Providers\AppServiceProvider.php دارد، شما نیز می‌توانید پروایدرهای خود را با دستور زیر در همین مسیر ایجاد کنید:

php artisan make:provider MyServiceProvider

گفته شد که لاراول همیشه نمی‌تواند یک سرویس را بدون تنظیم قبلی inject کند. اما در چه زمان هایی؟

1- وقتی برای یک interface چند پیاده سازی داریم و می‌خواهیم مشخص کنیم که لاراول از کدام پیاده‌سازی استفاده کند.
2- وقتی که یک پکیج برای لاراول توسعه داده‌ایم و می‌خواهیم سرویس‌هایی تعریف کنیم.

در این موارد کافی است در یکی از متدهای boot یا register (بسته به نیاز که بعدا توضیح داده می‌شود) در سرویس پروایدر خود آن پیاده‌سازی را به کانتینر bind کنیم:

$this->app->bind(Transistor::class, function (Application $app) {
 return new Transistor($app->make(PodcastParser::class));
});

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

انواع binding

1- ‏bind
این نوع از binding در مثال قبل گفته شد. و در هر بار درخواست یک سرویس، یک نمونه جدید از آن را ایجاد می‌کند.

2- ‏singleton
همانطور که از نامش پیداست، تنها یک نمونه از کلاس را می‌سازد و در هر درخواست سرویس، از نمونه ایجاد شده قبلی استفاده می‌کند:

$this->app->singleton('RedisClient', function () {
 return new RedisClient(config('redis'));
});

3- ‏instance
زمانی استفاده می‌شود که خودمان یک instance آماده از یک آبجکت داشته باشیم و بخواهیم آن را به کانتینر bind کنیم:

$logger = new \App\Services\CustomLogger();
$this->app->‏instance('logger', $logger);

4- ‏scoped
در اپ‌هایی که هر request (یا queue job) باید نسخه جداگانه‌ای از کلاس داشته باشند ولی در همون request بین کلاس‌ها مشترک باشند.
این نوع برای stateful کردن کلاس‌هایی مثل کانکشن دیتابیس بسیار مهم است.

$this->app->scoped(MyService::class, function ($app) {
    return new MyService(now());
});

در پروژه‌های Laravel Octane یا اپ‌های multi-tenant یا زمانی که Queue Jobها به ایزولاسیون نیاز دارن کاربرد دارد.

5- ‏bindIf
فقط زمانی bind رو انجام میده که کلاس یا کلیدی با اون نام bind نشده باشه:

$this->app->bindIf(SomeInterface::class, DefaultImplementation::class);

6- ‏singletonIf
مشابه bindIf عمل خواهد کرد با این تفاوت که نمونه‌ای که ایجاد می‌کند از نوع singleton خواهد بود.

7- ‏scopedIf
مشابه bindIf و ‏singletonIf برای scoped bindigها.

‏Interface Binding
ما می‌توانیم مشخص کنیم که وقتی یک کلاس خاص (یا Interface) خواسته شد، چه پیاده‌سازی (concrete class) برایش استفاده شود.
فرض کنید:

interface PaymentGateway {
 public function charge($amount);
}

class StripeGateway implements PaymentGateway {
 public function charge($amount) {
  //
 }
}

در این صورت کافی است در سراسر برنامه از PaymentGateway استفاده کنیم و لاراول خودش تصمیم می‌گیرد چه چیز را inject کند.
برای این کار کافی است در سرویس پروایدر خود به صورت زیر عمل کنیم:

$this->app->bind(PaymentGateway::class, StripeGateway::class);

در این صورت اگر PaymentGateway نیاز شود، یک نمونه از StripeGateway ساخته و inject می‌شود.

در قسمت‌های بعدی با سایر Injectionها آشنا خواهیم شد.

🔖 #Laravel, #PHP, #لاراول, #فصل_۷

👤 AmirHossein

💎 Channel: @DevelopixLaravel

‏LaraGram یک فریم‌ورک توسعه‌پذیر، منعطف و مدرن به زبان PHP برای ساخت ربات‌های تلگرامه که با الهام از ساختار لاراول طراحی شده.

اگر با لاراول آشنایی دارید، کار با LaraGram براتون راحت، لذت‌بخش و قابل پیش‌بینی خواهد بود — و حتی اگه آشنایی ندارید، ساختار منظمش خیلی زود براتون جا می‌افته.

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

به عنوان مثال، LaraGram مجهز به یک سیستم Update Listener پیشرفته هست که به شما امکاناتی مانند گروه‌بندی لیسنرها، نام‌دهی به هر لیسنر، اعمال محدودیت و Middleware بر روی لیسنر، پردازش متن و ورودی‌ها، و... رو میده.

همچنین نسخه بازنویسی شده Eloquent ORM رو در خودش جا داده با پشتیبانی از ۵ دیتابیس مختلف، همراه با تعریف روابط، Migrations، Seeders و Factory‌ها.

سایر قابلیت های کلیدی اون:

🔐‌ سیستم کنترل مجوز با قابلیت تعریف Gate و Policy برای مدیریت دقیق سطح دسترسی کاربران به منابع مختلف.

‏💻‌ Commander System برای ساخت و اجرای راحت command‌ها، مدیریت ساده‌تر پروژه، و زمان‌بندی اجرای وظایف (Scheduled Tasks).

📨‌ ‏Queue و Job System برای ساخت صف و اجرای کارها در پس‌زمینه با زمان‌بندی دلخواه.

🧰‌ رابط Redis با امکانات لازم برای توسعه‌های وابسته به کش، صف و پیام‌رسانی آنی.

🧠‌ سیستم کشینگ با پشتیبانی از ۷ درایور مختلف برای ذخیره‌سازی داده‌های موقتی، به‌همراه پیاده‌سازی Step Manager بر همین بستر.

🔁‌ کالکشن‌ها برای کار ساده‌تر و منعطف‌تر با داده‌های Iterable، مشابه کالکشن‌های Laravel.

⚙️‏‌ Concurrency‏ داخلی با امکان پردازش هم‌زمان چند درخواست در پس‌زمینه بدون پیچیدگی اضافه.

🔒‌ ابزارهای امنیتی با پشتیبانی از سیستم‌های رمزنگاری (Crypt) و هشینگ (Hash).

‏📢‌ Event Dispatcher برای تعریف و مدیریت رویدادها و واکنش به آن‌ها.

🎛‌ کیبورد بیلدر توسعه‌یافته با استفاده ساده و انعطاف پذیری بالا.

🧩‌ موتور قالب‌سازی پیشرفته الهام‌گرفته از Blade برای ساخت پیام‌ها به‌صورت پویا و قابل نگهداری.

🌍‌ سیستم چندزبانه (Translation) برای ساخت ربات‌هایی با پشتیبانی از زبان‌های مختلف.

✅‌ سیستم اعتبارسنجی با قوانین متنوع و امکان تعریف Rule‌های سفارشی.

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

یک مثال ساده برای ایجاد یک کامند بن با user_id به مدت 7 روز، با کنترل دسترسی و شرط ریپلای نشدن کامند:

Bot::onCommand("ban {id}", function (Request $request, $id) {
  $request->banChatMember(
    chat_id: chat()->id,
    user_id: $id,
    until_date: now()->addDays(7)->timestamp
  );
})->can('administrator')->hasNotReply();

برخی از ویژگی‌ها با افزونه‌ها و پکیج‌های جانبی به LaraGram اضافه می‌شوند، به عنوان مثال:

‏⚡️‌ LaraGram Surge
پکیجی برای اجرای سریع‌تر ربات‌ها با پشتیبانی از Swoole و OpenSwoole

‏🔧‌ LaraGram Installer
برای نصب و راه‌اندازی سریع و ساده پروژه‌های LaraGram

‏🛢‌ LaraGram MongoDB‌‏
درایور پایگاه‌داده MongoDB برای Eloquent ORM


📚 مستندات رسمی LaraGram نیز از طریق لینک زیر در دسترس است:
🔗 laraxgram.github.io

💬 گروه پرسش و پاسخ:
🔹 @LaraGramChat

📌 پروژه در گیت‌هاب:
♦️ LaraGram

🔖 #TelegramBot, #ربات, #تلگرام

👤 AmirHossein

💎 Channel: @DevelopixRobot

فصل هفت - Services و Dependency Injection

بخش اول - سرویس کانتینر (قسمت دوم)

‏Contextual Binding (وابسته به موقعیت)

وقتی یک کلاس یا اینترفیس در یک زمینه (context) خاص نیاز به یک وابستگی (dependency) داره، از کدوم پیاده‌سازی (implementation) استفاده بشه. این ویژگی به‌ویژه زمانی مفیده که چند کلاس به یک اینترفیس نیاز دارن، اما هرکدوم باید پیاده‌سازی متفاوتی از اون اینترفیس رو دریافت کنن.

فرض کن دو کلاس داریم که هرکدوم به LoggerInterface نیاز دارن:

interface LoggerInterface {
 public function log(string $message);
}

class FileLogger implements LoggerInterface {
 public function log(string $message) {

 }
}

class DatabaseLogger implements LoggerInterface {
 public function log(string $message) {

 }
}

حالا می‌خواهیم برای هر کلاس پیاده‌سازی متفاوتی از LoggerInterface تزریق کنیم:

$this->app->when(OrderService::class)
 ->needs(LoggerInterface::class)
 ->give(FileLogger::class);

$this->app->when(UserService::class)
 ->needs(LoggerInterface::class)
 ->give(DatabaseLogger::class);

با این تنظیمات:
در ‏OrderService‏، کلاس FileLogger تزریق میشه.
در UserService‏، کلاس DatabaseLogger تزریق میشه.

‏Binding Primitives
گاهی اوقات ممکنه کلاسی نیاز به تزریق مقادیر ساده‌ای مثل اعداد، رشته‌ها یا آرایه‌ها داشته باشه. در این مواقع، می‌تونیم با استفاده از Contextual Binding، این مقادیر رو به‌صورت دقیق برای هر کلاس یا متد مشخص کنیم.

فرض کن یک کلاس OrderProcessor داریم که به یک مقدار حداکثر تعداد سفارش نیاز داره:

class OrderProcessor {
 public function __construct(
  protected int $maxOrders
 ) {}

 public function process() {

 }
}

برای تزریق مقدار maxOrders، می‌تونیم از needs() و give() استفاده کنیم:

$this->app->when(OrderProcessor::class)
 ->needs('$maxOrders')
 ->give(100);

با این کار، هنگام ساخت نمونه‌ای از OrderProcessor، مقدار 100 به‌عنوان maxOrders به سازنده تزریق میشه.

‏Binding Typed Variadics
می‌تونیم متدهایی با پارامترهای متغیر (variadic) و تایپ‌شده داشته باشیم. این ویژگی به ما این امکان رو می‌ده که وابستگی‌هایی با تعداد و نوع مشخص رو به‌صورت دقیق تزریق کنیم.

فرض کن یک کلاس ReportGenerator داریم که به تعدادی فیلتر نیاز داره:

class ReportGenerator {
 public function __construct(
  protected FilterInterface ...$filters
 ) {}

 public function generate() {

 }
}

برای تزریق فیلترها، می‌تونیم از needs() و give() استفاده کنیم:

$this->app->when(ReportGenerator::class)
 ->needs(FilterInterface::class)
 ->give(function ($app) {
  return [
   new DateFilter(),
   new StatusFilter(),
  ];
});

با این کار، هنگام ساخت نمونه‌ای از ReportGenerator، آرایه‌ای از فیلترها به‌عنوان وابستگی‌ها تزریق میشه.


متدهای مرتبط با Contextual Binding
1- متد when
این متد مشخص می‌کنه که binding در چه کلاسی اعمال بشه.

2- متد needs
با این متد مشخص می‌کنیم که کدوم وابستگی نیاز به تزریق داره.

3- متد give
با این متد پیاده‌سازی مورد نظر رو برای وابستگی مشخص می‌کنیم.

4- متد giveConfig
یک متد راحت برای تزریق مقادیر تنظیماتی به کلاس‌هاست، به‌ویژه زمانی که کلاس نیاز به مقادیر ساده (primitive) داره. درواقع نسخه‌ی مخصوص برای give() هست که با config() همخوانی داره.

$this->app->when(PaymentGateway::class)
 ->needs('$apiKey')
 ->giveConfig('services.stripe.key');

5- متد giveTagged
برای تزریق تمام instanceهای مرتبط با یک tag به کلاس‌ها یا متدها استفاده میشه. این زمانی مفیده که یک کلاس نیاز به مجموعه‌ای از وابستگی‌ها (مثلاً چندین سرویس، middleware، فیلتر و…) داره.

$this->app->tag([DateFilter::class, StatusFilter::class], 'filters');

$this->app->when(ReportGenerator::class)
 ->needs('$filters')
 ->giveTagged('filters');

تمام instanceهای تگ شده با 'filters' رو به $filters تزریق می‌کنه.

نکته: درمورد تگ‌ها در قسمت بعدی توضیح کامل داده می‌شود.

در قسمت‌های بعدی با سایر Injectionها آشنا خواهیم شد.

🔖 #Laravel, #PHP, #لاراول, #فصل_۷

👤 AmirHossein

💎 Channel: @DevelopixLaravel

فصل هفت - Services و Dependency Injection

بخش اول - سرویس کانتینر (قسمت سوم)

‏Contextual Attributes

این قابلیت امکان استفاده از PHP Attributes را در سازنده‌ها و متدها فراهم می‌کند تا تزریق وابستگی‌ها در Service Container به شکل ساده‌تر، شفاف‌تر و قابل خواندن‌تری انجام شود.

این ویژگی در عمل جایگزین بسیاری از مواردی است که پیش‌تر تنها از طریق Contextual Binding (مانند when()->needs()->give()) امکان‌پذیر بود.

فرض کنید در یک کنترلر نیاز دارید از یک دیسک خاص برای ذخیره‌سازی استفاده کنید. پیش‌تر لازم بود این موضوع را در Service Provider تعریف کنید، اما اکنون کافی است از Attribute استفاده نمایید:

use Illuminate\Container\Attributes\Storage;
use Illuminate\Contracts\Filesystem\Filesystem;

class PhotoController extends Controller
{
 public function __construct(
  #[Storage('local')] protected Filesystem $filesystem
 ) {}
}

در این مثال، لاراول به‌طور خودکار دیسک با نام local را پیدا کرده و به متغیر $filesystem تزریق می‌کند.

لاراول چندین Attribute داخلی پرکاربرد ارائه کرده است، از جمله:

‏1- ‎#[Storage('disk-name')]
برای تزریق یک دیسک ذخیره‌سازی مشخص.

‏2- ‎#[Config('config.key')]
برای تزریق مستقیم مقادیر پیکربندی.

‏3- ‎#[DB('connection-name')]
برای تزریق یک اتصال پایگاه‌داده خاص.

‏4- ‎#[Auth('guard-name')]
برای تزریق گارد احراز هویت مشخص.

‏5- ‎#[Cache('store-name')]
برای تزریق یک cache store.

‏6- ‎#[Log('channel')]
برای تزریق یک کانال لاگ.

‏7- ‎#[RouteParameter('param')]
برای تزریق پارامترهای مسیر.

‏8- ‎#[Tag('tag-name')]
برای تزریق مجموعه‌ای از سرویس‌های تَگ‌شده.

‏9- ‎#[CurrentUser]
برای تزریق مستقیم کاربر احراز هویت‌شدهٔ فعلی.

مثال:

Route::get('/user', function (#[CurrentUser] User $user) {
 return $user;
})->middleware('auth');

در این مثال، Attribute CurrentUser باعث می‌شود که نمونه‌ای از مدل User که معادل کاربر احراز هویت‌شدهٔ جاری است، بدون هیچ کد اضافه‌ای تزریق گردد.

تعریف Attributes سفارشی
در برخی پروژه‌ها ممکن است نیاز به منطق خاصی داشته باشید. در این حالت می‌توانید Attribute سفارشی خود را تعریف کنید.

برای ساخت یک Attribute سفارشی یک کلاس با annotation #[Attribute] تعریف کنید و رابط ContextualAttribute را پیاده‌سازی کنید.

namespace App\Attributes;

use Attribute;
use Illuminate\Contracts\Container\Container;
use Illuminate\Contracts\Container\ContextualAttribute;

#[Attribute(Attribute::TARGET_PARAMETER)]
class AppConfig implements ContextualAttribute
{
 public function __construct(
  public string $key,
  public mixed $default = null
 ) {}

 public static function resolve(self $attribute, Container $container)
 {
  return $container->make('config')->get($attribute->key, $attribute->default);
 }
}

نمونه استفاده:

public function __construct(
 #[AppConfig('app.name')] protected string $appName
) {}

‏Tagging
در سرویس کانتینر، Tagging این امکان را فراهم می‌کند که چندین کلاس یا binding را تحت یک نام مشترک گروه‌بندی کنید و بعداً همه آن‌ها را با یک فراخوانی ساده دریافت نمایید. این ویژگی به‌ویژه زمانی مفید است که چند پیاده‌سازی از یک interface یا کلاس وجود داشته باشد و بخواهید همه یا تعدادی از آن‌ها را در یک زمان استفاده کنید.

$this->app->bind(SlackMessenger::class, function ($app) {
 return new SlackMessenger(/* ... */);
});

$this->app->bind(TwilioMessenger::class, function ($app) {
 return new TwilioMessenger(/* ... */);
});

$this->app->tag([SlackMessenger::class, TwilioMessenger::class], 'messengers');

در این مثال، دو کلاس مربوط به پیام‌رسانی با تگ 'messengers' علامت‌گذاری می‌شوند.

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

$messengers = $this->app->tagged('messengers');

تمام instanceهای مربوط به تگ 'messengers' را برمی‌گرداند.

در قسمت‌های بعدی با سایر Injectionها آشنا خواهیم شد.

🔖 #Laravel, #PHP, #لاراول, #فصل_۷

👤 AmirHossein

💎 Channel: @DevelopixLaravel

فصل هفت - Services و Dependency Injection

بخش اول - سرویس کانتینر (قسمت چهارم)
‏
‏Extending Bindings‏
گاهی اوقات شما می‌خواهید یک سرویس را که قبلاً در Service Container ثبت (bind) شده است، تغییر دهید یا چیزی به آن اضافه کنید. به جای اینکه کل آن را از نو بنویسید، می‌توانید از متد extend استفاده کنید. این متد به شما اجازه می‌دهد تا سرویس اصلی را دریافت کرده، آن را تغییر دهید و سپس نسخه تغییریافته را برگردانید.

$this->app->singleton(ApiClient::class, function () {
 return new ApiClient();
});

$this->app->extend(ApiClient::class, function ($client, $app) {
 $client->config['timeout'] = 10;
 return $client;
});

‏Resolving
متد make برای دریافت (resolve) یک نمونه از یک کلاس یا اینترفیس از Service Container استفاده می‌شود. هر زمان که شما به یک نمونه از کلاسی که در کانتینر ثبت شده نیاز دارید، می‌توانید از این متد استفاده کنید.
فرض کنید یک کلاس برای مدیریت کاربران دارید.

$this->app->bind('UserManager', function ($app) {
 return new UserManager();
});

// Resolving
$userManager = app()->make('UserManager');

تزریق خودکار (Automatic Injection)
لاراول به قدری هوشمند است که می‌تواند وابستگی‌های (dependencies) یک کلاس را به صورت خودکار از روی Type-Hint در سازنده (constructor) یا متدهای آن تشخیص داده و آن‌ها را تزریق کند. این یعنی در اکثر موارد شما نیازی به استفاده از متد make ندارید.

به جای اینکه در مثال قبل به صورت دستی UserManager را make کنیم، می‌توانیم آن را به سازنده کنترلر تزریق کنیم.

public function __construct(UserManager $userManager)
{
 $this->userManager = $userManager;
}

در این حالت، لاراول به صورت خودکار UserManager را برای شما make کرده و به عنوان آرگومان به سازنده پاس می‌دهد.

فراخوانی متد و تزریق وابستگی (Method Invocation & Injection)
علاوه بر تزریق وابستگی در سازنده، لاراول می‌تواند وابستگی‌ها را مستقیماً به متدهای کلاس نیز تزریق کند. این قابلیت به خصوص در کنترلرها بسیار مفید است، زمانی که یک وابستگی فقط در یک متد خاص مورد نیاز است.

فرض کنید یک سرویس برای اعتبارسنجی ورودی‌ها دارید که فقط در متد store از آن استفاده می‌کنید.

public function store(Request $request, UserValidator $validator)
{
 // Request and UserValidator injected.
}

رویدادهای کانتینر (Container Events)
‌‎Service Container هنگام دریافت (resolve) هر آبجکت، یک رویداد (event) را فراخوانی می‌کند. شما می‌توانید به این رویداد گوش دهید تا هر زمان که یک آبجکت خاص از کانتینر گرفته شد، یک عملیات دلخواه را انجام دهید. این قابلیت برای دیباگ کردن یا اضافه کردن منطق‌های خاص بسیار کاربردی است.

فرض کنید می‌خواهیم هر زمان که یک آبجکت از کلاس MyService ساخته شد، یک پیام در لاگ ثبت کنیم.

$this->app->resolving(MyService::class, function ($service, $app) {
 Log::info('MyService resolved!');
});

همچنین می‌توانید به تمام resolving ها گوش دهید

$this->app->resolving(function ($object, $app) {
 Log::info('Resolved: ' . get_class($object));
});

‏Rebinding
گاهی اوقات شما نیاز دارید تا بعد از اینکه یک سرویس ساخته و استفاده شد، اگر دوباره bind شد، یک عملیات خاص را انجام دهید. برای مثال، فرض کنید یک سرویس دارید که به اطلاعات کاربر لاگین شده وابسته است. وقتی کاربر لاگ اوت کرده و یک کاربر دیگر لاگین می‌کند، شما نیاز دارید که این سرویس با اطلاعات کاربر جدید به‌روزرسانی شود.

$this->app->rebinding('UserData', function ($app, $instance) {
 // logic
});

🔖 #Laravel, #PHP, #لاراول, #فصل_۷

👤 AmirHossein

💎 Channel: @DevelopixLaravel

🚀 جلوگیری از مشکل N+1 در Eloquent با eager loading و withCount

خیلی از باگ‌ها و افت کارایی در اپ‌های لاراول از درخواست‌های اضافی دیتابیس (مشکل N+1) ناشی می‌شه. با استفاده از eager loading و withCount می‌تونید هم تعداد کوئری‌ها رو کم کنید و هم اطلاعاتی مثل تعداد ارتباط‌ها رو بدون کوئری‌های اضافی بگیرید. 💡

مثال عملی: فرض کنید مدل Post و رابطه comments دارید. اگر بدون eager loading لیست پست‌ها رو رندر کنید، هر بار که به comments دسترسی پیدا می‌کنید یک کوئری جدید اجرا می‌شه — N+1.

راه ساده و بهینه:

$posts = Post::with('comments')->get();
foreach ($posts as $post) {
    // دسترسی به رابطه بدون کوئری اضافی
    echo $post->comments->count();
}

// اگر فقط تعداد نیاز دارید، از withCount استفاده کنید:
$posts = Post::withCount('comments')->get();
foreach ($posts as $post) {
    echo $post->comments_count; // مقدار از همان کوئری اصلی
}

نکات عملی و بهترین روش‌ها:
- وقتی فقط تعداد رابطه لازم دارید از withCount استفاده کنید تا داده‌های اضافی لود نشه. 🔍
- برای بارگذاری شرطی (مثلاً فقط کامنت‌های تاییدشده) از closure در with استفاده کنید: with(['comments' => fn($q) => $q->where('approved', 1)]).
- برای دیتاست‌های بزرگ از chunk یا cursor استفاده کنید تا حافظه پر نشه. ⚠️

اشتباه رایج: افزودن eager loading برای روابطی که هرگز استفاده نمی‌شن — فقط روابط لازم را بارگذاری کنید تا از overhead جلوگیری کنید.

با این روش ساده، کوئری‌ها به‌مراتب کم‌تر و صفحه‌ها سریع‌تر بارگذاری می‌شن. امتحان کنید و بازخورد یا تجربه‌تون رو به اشتراک بذارید. 🙌

Laravel Docs — Eloquent Relationships

🔖 #Laravel #PHP #لاراول #Laravel #Eloquent #Performance #EagerLoading

👤 Developix

💎 Channel: @DevelopixLaravel

عملگر پایپ (Pipe Operator) در PHP

عملگر پایپ ( |> ) از PHP 8.5 با هدف ساده‌سازی جریان داده و افزایش خوانایی کد اضافه شده است. این عملگر امکان می‌دهد خروجی یک عبارت به‌عنوان ورودی تابع بعدی استفاده شود؛ بدون آنکه نیاز به تو در تو کردن فراخوانی‌ها یا استفاده از متغیرهای موقتی باشد.

ساختار کلی عملگر پایپ:

$value |> callable;

در این ساختار:
- مقدار سمت چپ (value) محاسبه شده و سپس به تابع سمت راست (callable) ارسال می‌شود، و نتیجهٔ آن تابع، خروجی نهایی عبارت خواهد بود.

- تابع سمت راست باید فقط یک پارامتر لازم داشته باشد؛ زیرا همان یک پارامتر از پایپ دریافت می‌شود.

- نماد ( ... ) پس از نام تابع، بیانگر این است که پارامتر آن تابع از طریق عملگر پایپ وارد می‌شود.

چند مثال:
پیش از اضافه شدن پایپ تواع پشت سر هم نوشته می‌شد:

$result = strtolower(trim($title));

یا از متغیرهای موقتی استفاده می‌شد:

$trim = trim($title);
$result = strtolower($trim);

اما با استفاده از پایپ می توان ساختار تمیزتر و قابل فهم‌تری را داشته باشیم:

$result = $title
  |> trim(...)
  |> strtolower(...);

ترتیب اجرای عملیات کاملا روشن و خوانا است:
ابتدا trim، سپس strtolower.

ترکیب توابع استاندارد با Closure

$slug = $title
  |> trim(...)
  |> (fn($s) => str_replace(' ', '-', $s))
  |> strtolower(...);

از آنجایی که گفته شد توابع تنها یک متد داشته باشند، برای توابع با چند متد می‌توان از کلوژرها استفاده کرد.
در این مثال str_replace نیاز به پارامترهای بیشتری است به همین دلیل از arrow-function استفاده شده.

عملیات روی آرایه

$clean = $items
  |> array_map(fn($x) => trim($x), ...)
  |> array_filter(fn($x) => $x !== '', ...)
  |> array_values(...);

چنین زنجیره‌ای بدون استفاده از پایپ، به‌طور معمول شامل متغیرهای واسطه یا تو در تویی توابع خواهد بود؛ اما با استفاده از پایپ، تمامی مراحل به صورت خوانا پشت سر هم نوشته شده‌اند.

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

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

- نیازی به ایجاد متغیر برای ذخیرهٔ نتیجهٔ هر مرحله نیست.

محدودیت‌ها و نکات مهم:
- توابعی که بیش از یک پارامتر ضروری دارند، مستقیماً با پایپ قابل استفاده نیستند.

"hello world" |> explode(' ', ...); // ERROR

"hello world" |> (fn($v) => explode(' ', $v)); // correct

- توابعی که پارامترشان با ارجاع (By Reference) دریافت می‌شود قابل استفاده نیستند (مانند array_pop یا sort)

- اگر تابعی مقدار بازگشتی نداشته باشد (void)، نتیجهٔ عملیات null خواهد بود و استفادهٔ آن در میانهٔ زنجیره صحیح نیست.


به طور کلی عملگر پایپ در PHP 8.5 امکان نگارش کدی خواناتر، مرحله‌ای و ساخت‌یافته را فراهم می‌کند.
این عملگر با ارسال خروجی هر مرحله به مرحلهٔ بعد، جریان داده را ساده‌سازی می‌کند و برای پردازش رشته‌ها، آرایه‌ها و داده‌های میان‌مرحله‌ای بسیار مناسب است.
در مقابل، محدودیت‌هایی نظیر نیاز به تک‌پارامتری بودن تابع یا عدم پشتیبانی از توابع دارای ارجاع وجود دارد که باید در استفادهٔ روزمره مورد توجه قرار گیرد.

🔖 #PHP #پی_اچ_پی

👤 AmirHossein

💎 Channel: @DevelopixPHP

🔎 سوال برای توسعه‌دهندگان Laravel / PHP

خروجی اجرای این کد PHP چیست؟

به تفاوت بین type casting و type juggling در PHP و تاثیر آن روی کلیدهای آرایه دقت کنید.

$data = [
    "01" => "first",
    1    => "second",
    true => "third",
    "1"  => "fourth",
];

var_dump($data);

خروجی کامل تابع var_dump را بنویسید (ساختار آرایه و مقادیر آن).

🔖 #Laravel #PHP #لاراول

👤 Developix

💎 Channel: @DevelopixLaravel

پکیج امروز: Spatie Laravel Ray 🔍
یک دیباگر زنده که لاگ‌ها و query و jobها را به اپ دسکتاپ Ray می‌فرستد؛ مخصوص وقتی که var_dump و dd کل صفحه را منفجر می‌کنند 🙂

به چه درد می‌خورد؟
• دیدن لاگ‌ها، queryها، exceptionها به‌صورت لحظه‌ای
• گروهبندی، فیلتر و استایل‌دهی به لاگ‌ها
• دیباگ queue job، event، mail و حتی cache

نصب

composer require spatie/laravel-ray --dev
php artisan vendor:publish \
  --provider\="Spatie\LaravelRay\RayServiceProvider"

نمونه استفاده در کنترلر

use Spatie\LaravelRay\Ray;

public function index()
{
    ray('Load products');

    $products = Product::with('category')
        ->where('active', true)
        ->get();

    ray($products)->blue();

    return view('products.index', compact('products'));
}

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

لینک‌ها:
GitHub
Docs

🔖 #Laravel #PHP #لاراول #Laravel #PHP #Spatie #Debugging #Laravel_Ray

👤 Developix

💎 Channel: @DevelopixLaravel