> هنگام انجام کارها یا آن ها را با عشق انجام دهید یا هرگز انجام ندهید. این جمله از **گاندی** رضا را به این فکر فرو برده است که فکری برای انجام بسیاری از کار‌های تکراری که باید به‌طور متناوب انجام دهد بکند. به‌عنوان مثال او از خط فرمان (*command-line*) خیلی استفاده می‌کند و همیشه آرزو داشت تا دستوراتی را خودش ایجاد و از آن‌ها استفاده کند. در این سؤال باید به‌همراه او این آرزو را برآورده کنید. ## جزئیات پروژه پروژه‌ی اولیه را از [این لینک](/contest/assignments/35047/download_problem_initial_project/121220/) دانلود کنید. <details class="grey"> <summary>ساختار فایل‌ها</summary> ``` qcli ├── core │ ├── Commands │ └── Command.php ├── stubs │ └── command.stub ├── test │ └── QCliSampleTest.php ├── composer.json ├── composer.lock └── qcli ``` </details> <details class="brown"> <summary>راه‌اندازی پروژه</summary> **برای اجرای پروژه، باید `php` و `composer` را از قبل نصب کرده باشید.** + پروژه‌ی اولیه را دانلود و از حالت فشرده خارج کنید. + دستور `composer install` را در پوشه‌ی اصلی پروژه برای نصب نیازمندی‌ها اجرا کنید. </details> در دایرکتوری اصلی پروژه، فایلی به نام `qcli` وجود دارد که یک اسکریپت *PHP* است. از این فایل برای هندل کردن دستورات استفاده می‌شود. این فایل پس از دریافت دستور، پارامتر‌های ورودی را برای اجرا به متد `run` کلاس `QCli\Command` ارسال می‌کند. در ابتدا باید برنامه را طوری پیاده‌سازی کنید که دستور `make:command <mark title="نام کلاس">name</mark> <mark title="امضای دستور">sign</mark>` به‌صورت پیش‌فرض در برنامه موجود باشد. `name` نام کلاس دستور و `sign` امضای دستور است. وظیفه‌ی این دستور این است که دستورات دلخواه را در دایرکتوری `core/Commands` ایجاد کند. قالب دستوراتی که ایجاد می‌شوند باید مطابق محتویات فایل `stubs/command.stub` باشد: ```php stubs/command.stub php <?php namespace QCli\Commands; class <mark title="نام کلاس">{{ name }}</mark> { protected string $signature = '<mark title="امضای دستور">{{ sign }}</mark>'; protected string $description = '<mark title="نام کلاس">{{ name }}</mark> description'; public function handle() { echo 'Command ' . $this->signature . ' is ready to implement'; } } ``` فرض کنید دستور زیر در خط فرمان وارد می‌شود: ```shell php qcli make:command <mark title="نام کلاس">CustomCommand</mark> <mark title="امضای دستور">custom:command</mark> ``` با اجرای دستور فوق، باید فایل `CustomCommand.php` در مسیر `core/Commands` ساخته شود: ```php core/Commands/CustomCommand.php php <?php namespace QCli\Commands; class CustomCommand { protected string $signature = 'custom:command'; protected string $description = 'CustomCommand description'; public function handle() { echo 'Command ' . $this->signature . ' is ready to implement'; } } ``` هم‌چنین ممکن است کلاس‌هایی به‌صورت دستی (بدون استفاده از دستور پیش‌فرض `make:command`) در مسیر `core/Commands` ایجاد شوند. برنامه باید بتواند این دستورات را نیز شناسایی کند. **تضمین می‌شود** که این کلاس‌ها نیز مطابق محتویات فایل `stubs/command.stub` هستند. اگر دستور ایجادشده در خط فرمان وارد شود، باید متد `handle` از کلاس دستور اجرا شود، یعنی در مثال قبل اگر دستور زیر وارد شود: ```shell php qcli <mark title="امضای دستور">custom:command</mark> ``` باید عبارت `Command custom:command is ready to implement` چاپ شود. ## نکات + **تضمین می‌شود** که دو دستور با نام کلاس یا امضای یکسان ایجاد نخواهد شد. + این پروژه از استاندارد [*PSR-4*](https://www.php-fig.org/psr/psr-4/) برای *autoloading* کلاس‌ها استفاده می‌کند. + شما تنها مجاز به اعمال تغییرات در دایرکتوری `core` هستید. می‌توانید فایل‌ها و دایرکتوری‌های جدیدی نیز در این دایرکتوری ایجاد کنید. + در صورت نیاز، می‌توانید متدهای دیگری نیز در کلاس `QCli\Command` پیاده‌سازی کنید. ## آن‌چه باید آپلود کنید پس از اعمال تغییرات، پوشه‌ی `core` را زیپ کرده و آپلود کنید.

حل سؤال در بانک سؤالات