🔰 این سوال بسیار راحت است، درصورتی که با 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
@AmirhDeveloper
.

فکر کنید دما ۴۳ درجه‌س، گرم‌ترین ساعت روزه و وسط کارتون هستید که دارید به نتیجه‌ای که کلی براش زمان گذاشتید می‌رسید و زارت برق قطع میشه

درود دلاوران 🌟
یکی از دوستان برام یه کد تخفیف ۱۰۰٪ فرستاد برای سایت فرادرس
فرادرس الان تخفیف ۱۰۰ درصد گذاشته، فقط برای یه دوره!

من خودم یه دوره فن بیان گرفتم، گفتم قبل اینکه تموم شه،
براتون بذارم شاید به دردتون بخوره ❤️

🔹 کد تخفیف: IRAN (با حروف بزرگ)

یادتون نره فقط می‌تونید یه دوره رو با این کد بگیرید
پس اون دوره‌ای که واقعاً لازم دارید رو انتخاب کنید 😉
موفق باشید رفقا 🌱

قرار بود تا 25 خرداد ورژن 3 LaraGram منتشر بشه، ولی خب اتفاقات زیادی افتاد که باعث شد پروژه خیلی عقب بیوفته.

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

اما سرویس هایی مثل
Validation, Auth, Divider, Broadcast
و احتمالا یک سری چیز دیگه هنوز باقی موندن.

در بهترین حالت امیدوارم تا دو هفته دیگه منتشر بشه.

از الان بهتون اطمینان میدم که مثل LaraGram رو ندیدید و یک فریم‌ورک تمام‌اعیار برای توسعه ربات تلگرامی هست(فخر فروشی)😁

وقتی ورژن 3 منتشر بشه بیکار نمی‌مونیم و توسعه ورژن 4 رو شروع می‌کنیم تا برای سال آینده آماده باشه.

خیلی سعی کردم جلوی خودم رو بگیرم و نگم توی ورژن 4 چه‌خبره، ولی خب نمیشه😂

ورژن 4 روی دو چیز متمرکز میشه:
1- MTProto
2- TMAs

به عنوان اولین قابلیت به شما امکان توسعه ربات‌های کلاینتی و کار با متدهای MTProto رو میده، که قبلا هم زیاد ازش نام برده بودم

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

اما همه چیز توی بک‌اند تموم نمیشه، لاراگرام برای فرانت‌هم قابلیت‌هایی در اختیارتون میذاره، اگر لاراول کار باشید با پکیج هایی مثل inertia.js و livewire آشنا هستید، که قرار مشابه‌ش رو توی لاراگرام داشته باشیم.
شما می‌تونید ری‌اکت یا ویو بنویسید و با یک متد ساده اون رو رندر کنید.
بدون هیچ دردسر اضافی یا نیاز به پکیج‌ها و فریم‌ورک‌های جاوااسکریپتی

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

انقدر از پست قبلی لاراول می‌گذره که یادم نبود کجای بحث بودیم.
بعد یک دوساعتی دیدم که از ولیدیشن‌ها همه چیز رو گفتم و صرفا Ruleها باقی مونده که به خودتون و داکیومنت می‌سپارم، چون واقعا تعدادشون زیاد هست و مناسب پست نوشتن نیست.

درنتیجه وارد فصل 7 می‌شیم، مبحث Dependency Injection و Services که بحث مورد علاقه‌م هم هست.

از این فصل به بعد دیگه مباحث حرفه‌ای لاراول به حساب میاد.

پستش رو می‌نویسم و تا یک ساعت دیگه ارسال می‌کنم🤝

فصل هفت - 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 #لاراول #فصل_۷
@AmirhDeveloper
.

بعد از ۱۳ ماه تلاش، 🎉 LaraGram 3 منتشر شد!

در این نسخه به یک ورژن پایدار رسیدیم که دیگه قرار نیست تغییرات ساختاری یا سینتکسی داشته باشیم.

فیچرهای زیادی اضافه شده که توسعه ربات رو به ساده‌ترین شکل ممکن می‌رسونه 🚀
در ادامه، یه توضیح کوتاه از قابلیت‌های مهم نسخه جدید می‌بینید:

🔐 سیستم کنترل مجوز با قابلیت تعریف Gate و Policy (برای کنترل دسترسی به عملیات‌های پایگاه‌داده)

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

🔁 کالکشن‌ها برای کار حرفه‌ای و راحت با Iterable‌ها

⚙️ سیستم Concurrency برای پردازش همزمان چند درخواست در پس‌زمینه

⚙️ بهبود سیستم کانفیگ و اضافه شدن فایل .env برای مدیریت بهتر تنظیمات

💻 کرنل کنسول برای ایجاد و اجرای راحت کامندها، به‌علاوه زمان‌بندی اجرای تسک‌ها

📦 بازنویسی کامل Eloquent ORM به صورت اختصاصی با پشتیبانی از ۵ دیتابیس مختلف و انواع روابط
📐 همراه با قابلیت‌های Migrations، Seeders و Factory

🔒 سیستم‌های Crypt و Hash برای رمزنگاری

‏📢 Event Dispatcher برای تعریف و مدیریت رویدادها

📁 سیستم File برای کار با فایل‌ها و پوشه‌ها

🎛 بهبود چشم‌گیر در کیبورد بیلدر و سهولت استفاده

🧭 سیستم Listening الهام‌گرفته از Routing لاراول با امکاناتی مثل:
▪️ پردازش ورودی‌ها
▫️ ایجاد گروه و کنترلر
▪️ اعمال محدودیت و Middleware
▫️ ریدایرکت بین بخش‌ها
▪️ نام‌گذاری مسیرها
▫️ و...

📝 سیستم Log برای ثبت لاگ‌ها با درایورهای متنوع

📨 سیستم Queue و Job برای ایجاد صف و زمان‌بندی اجرای کارها

🧰 اینترفیس جامع Redis با پشتیبانی کامل

🧬 پردازش هر درخواست در یک Pipeline مستقل برای کنترل بهتر

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

🌍 سیستم Translation برای ساخت ربات‌های چندزبانه

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

🤖 امکان تعریف چندین کانکشن و مدیریت هم‌زمان چند ربات

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

و اما معرفی دو پکیج قدرتمند و جذاب:


‌‏🗓 Tempora: مشابه Carbon برای کار با تاریخ و زمان، به صورت چندزبانه و بازنویسی‌شده اختصاصی برای LaraGram

‏⚡️ LaraGram Surge: مشابه Octane برای اجرای ربات بر پایه Swoole و OpenSwoole
(و به‌زودی با پشتیبانی از RoadRunner و FrankenPHP!)

در آینده‌ای نزدیک LaraGram Installer برای ایجاد حرفه‌ای تر پروژه و همچنین پشتیبانی از MongoDB را نیز خواهیم داشت.

اگر خوشتون اومد، لطفاً به پروژه ⭐️ بدید، به دوستاتون معرفی کنید و حمایتتون رو نشون بدید
خودتون استفاده کنید، ایرادی دیدید بگید تا برطرف کنیم
یا حتی بیاید در توسعه کمک کنید ❤️

📌 پروژه در گیت‌هاب:
♦️ LaraGram
🔹 Laraquest
♦️ LaraGram Surge
🔹 Tempora
♦️ Core

@AmirhDeveloper🔰
.

⚜️ پکیج LaraGram Installer به‌طور کامل آماده شده و با استفاده از آن می‌توانید تنها با چند دستور ساده، یک پروژه لاراگرامی کاملاً کانفیگ‌شده ایجاد کنید.

تنها یک‌بار پکیج را به صورت گلوبال نصب کنید:

composer global require laraxgram/installer

پس از نصب، در هر مسیری که باشید، تنها با اجرای دستور زیر:

laragram new

می‌توانید یک پروژه جدید لاراگرامی ایجاد کنید.

این ابزار به‌صورت پیش‌فرض قابلیت‌های زیر را دارد و به‌صورت خودکار برای شما انجام می‌دهد:

🔹 کانفیگ Git
♦️ ساخت ریپازیتوری و Push در GitHub
🔹 تنظیم دیتابیس
♦️ ست‌کردن Webhook
🔹 نصب پکیج LaraGram Surge

در نهایت یک پروژه کاملاً آماده و کانفیگ‌شده در اختیار شما خواهد بود.

——————

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

📌 پروژه در گیت‌هاب:
♦️ LaraGram
🔹 Laraquest
♦️ LaraGram Surge
🔹 Tempora
♦️ Core

@AmirhDeveloper
.

شرمنده یه چند وقتیه سرم خیلی شلوغ شده و خیلی سخت می‌تونم پست بنویسیم
هر وقت هم می‌خوام بنویسم برق می‌ره

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

و خب سوالم اینه که برای ادامه فعالیت کانال کمیت محتوا رو ترجیح می‌دید یا کیفیت؟

💌 پیام وارده


جادی عزیزم سلام

ما کمپین رایگان شدن دوره های مکتب‌خونه رو با پیام همدلی در مسیر یادگیری شروع کردیم
۱۰۰ تا دوره تو حوزه های مختلف رو رایگان کردیم
از برنامه نویسی گرفته تا شبکه و هوش مصنوعی و کلی مهارت های نرم و حتی مثلا گیتار و فرانسوی و تعمیر خودرو و غیره
خلاصه بهترین دوره های مکتب‌خونه رو گلچین کردیم و رایگان کردیم تا آدما یادگیریشون رو متوقف نکنند
چون یادگیری باعث رشد همه و حال خوب و حس پیش رفتن و زنده بودن میده

این لینک دوره CEH شماس
https://mktb.me/3w7y/

اگه از کل کمپین هم حمایت کنی ممنونت میشم. هرچقدر آدمای بیشتری ببینن و بیام ازشون استفاده کنند ما حالمون بهتر میشه

این لندینگ همه دوره های رایگان شده س
https://mktb.me/txvk/

کد HAMDELI

پکیج جدیدی برای LaraGram منتشر شد به نام LaraGram MongoDB.

این پکیج به شما این امکان رو میده که از دیتابیس MongoDB با استفاده از Eloquent ORM استفاده کنید. یعنی می‌تونید از مدل‌ها، مایگریشن‌ها، سیدرها و فکتوری‌های Eloquent استفاده کنید.

همچنین تمامی روابط مثل یک به یک و چند به چند برای دیتابیس MongoDB رو شبیه‌سازی می‌کنه و می‌تونید در یک دیتابیس غیررابطه‌ای از روابط استفاده کنید.

از طرفی، درایورهای MongoDB برای سیستم کش و صف‌ها هم در اختیارتون میذاره.

برای نصب و اضافه کردن به پروژه‌تون کافیه این دستور رو اجرا کنید:

composer require laraxgram/mongodb

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

گیت‌هاب پروژه هم اینجاست اگر مایل بودید حمایت کنید:
LaraGram MongoDB

@AmirhDeveloper
.

فصل هفت - 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 #لاراول #فصل_۷
@AmirhDeveloper
.

انقد پست نذاشتم دنبال کننده‌های دوره لاراول ناامید شدن رفتن

دنبال کننده های واقعیش موندن😉🤓

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

فصل هفت - 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 #لاراول #فصل_۷
@AmirhDeveloper
.

عجایب LaraGram: