ساخت دستورات artisan در لاراول ۷

در ادامه سری آموزش های جامع لاراول، به آموزش ساخت دستورات artisan در لاراول می رسیم. قبل از هرچیزی به معرفی artisan می پردازیم.

artisan چیست؟

آرتیسان یا artisan، خط فرمان یا CLI اختصاصی فریم ورک لاراول است.

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

هر کدام از موارد ذکر شده، دستور مخصوص خود را دارند. مثلا برای ساخت مدل ها از دستور زیر استفاده می کنیم:

php artisan make:model Name

مشاهده لیست دستورات artisan در لاراول ۷

با استفاده از دستور زیر می توانیم همه دستورات آرتیسان موجود در پروژه را مشاهده کنیم:

php artisan

آیا می توان دستور جدیدی در artisan ساخت؟

جواب مثبت است. یکی از قابلیت های artisan و در کل لاراول، این است که ما میتوانیم دستورات اختصاصی خود را نوشته و ثبت کنیم.

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

ساخت دستورات artisan در فیلم آموزشی لاراول

ساختن دستورات برای آرتیسان به هیچ وجه مشکل نیست. اگر به مستندات لاراول نگاه کنید، خواهید دید که ساخت دستورات نه تنها کار مشکلی نیست بلکه می توان گفت شیرین ترین و لذت بخش ترین بخش آموزش لاراول است.

در این آموزش، دستورات شخصی آرتیسان را در سه مرحله آموزش خواهیم داد:

مرحله اول: ساخت فایل دستور

قبل از هر کاری ابتدا باید فایل مربوط به command  به وسیله دستور زیر بسازیم:

php artisan make:command Name

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

پس از اجرای این دستور، فایلی به همین نام در دایرکتوری Console/Commands ایجاد خواهد شد.

مرحله دوم: ثبت نام فایل

بعد از ایجاد فایل دستور، بایستی فایل را در فایل kernel.php ثبت نام کرده و به فریم ورک یا پروژه خود معرفی کنیم.

مرحله سوم: تعریف دستور و انتخاب نام آن و تعریف عملکرد

در این مرحله می توانیم با خیال راحت، فایل دستور را باز کرده و نام و توضیحات و نیز وروردی ها و option های آن را تعیین کنیم.

اینکه دستور ما باید دقیقا چه عملی انجام دهد یا چه کاربردی داشته باشد در متد handle این فایل تعریف خواهد شد.

argument ها در artisan commands

argument در لغت به معنی بحث و استدلال است اما در این آموزش و در دستورات artisan بیشتر نقش ورودی را خواهند داشت.

ممکن است در طراحی دستورات، بخواهید از کاربر ورودی دریافت کنید.

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

در این مواقع بایستی تمام ورودی ها را در protected $signature ثبت و مدیریت کنیم.

options در دستورات ساخت دستورات artisan در لاراول

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

مثلا در دستور ایجاد جداول، create– را دیده اید:

php artisan make:migration create_users_table --create=users

به این عبارت ها option می گوییم که نوع دیگری از ورودی ها هستند.

متد ()handle

در این متد، بدنه دستورات، منطق و هدف آنها را خواهیم نوشت.

در واقع این متد تعیین میکند که هر دستوری دقبقا چه کاری انجام دهد.

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

()info

هنگامی که خروجی دستور با این متد به کاربر نمایش داده شود، متن به صورت رنگی و زیبا دیده خواهد شد.

()line

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

()error

این متد خروجی را به صورت یک خطا نمایش خواهد داد. پشت زمینه قرمز

و چندین متد دیگر که در فایل ویدیویی بیشتر و دقیق تر با آنها آشنا خواهید شد.

فایل ویدیویی آموزش ساخت دستورات artisan در لاراول

در قسمت ویدیویی به مباحث زیر خواهیم پرداخت:

1. ابتدا دستوری ساده خواهیم ساخت که نام کاربر را گرفته و به او سلام بدهد. حتی متن سلام و احوالپرسی را هم به صورت ورودی از کاربر خواهیم گرفت. هدف از این بخش درک مفاهیم آپشن و ورودی اجباری و اختیاری است.
2. در وهله دوم به ساخت دستوری می پردازیم که تمام اطلاعات کاربران را در یک جدول منظم و تیتر دار نمایش بدهد.
3. در گام سوم نحوه استفاده از دستورات artisan را در سراسر پروژه خواهیم گفت. شما می توانید تمامی دستورات آرتیسان را در route ها، کنترلر ها و … استفاده نمایید.