نیما در شرکت کدنویس‌گستران شرق به‌جز حسن مشغول به کار است. او فردی مینیمالیست است و از کتاب‌خانه‌های بزرگ و پیچیده‌ی PHP متنفر است. در حال حاضر، تیم کدنویس‌گستران شرق به‌جز حسن از موتور قالب Smarty استفاده می‌کند. این موتور قالب از نظر نیما بسیار بزرگ و پیچیده است. او تصمیم گرفته تا موتور قالب ساده‌ای با نام Smarties بسازد تا در پروژه‌های بعدی‌شان از آن استفاده کنند.

از شما می‌خواهیم Smarties را برای نیما پیاده‌سازی کنید.

جزئیات پروژه

پروژه‌ی اولیه را از این لینک دانلود کنید.

اینترفیس `SmartiesFilter`

اسمارتیز همانند سایر template engine ها امکان اعمال فیلتر روی مقادیر را داراست. البته، این فیلترها هیچ آرگومانی به‌جز مقدار فعلی ندارد. همه‌ی فیلترهای اسمارتیز اینترفیس SmartiesFilter را پیاده‌سازی می‌کنند. این اینترفیس تنها شامل متدی با نام apply است که متن ورودی را دریافت کرده و پس از اعمال تغییرات، متن نهایی را برمی‌گرداند.

interface SmartiesFilter
{
    public function apply($text);
}

کلاس `SmartiesFilterFactory`

وظیفه‌ی این کلاس، تبدیل یک تابع به آبجکتی از SmartiesFilter است. این کلاس شامل متدی static به نام create است که یک تابع را به شکل نام تابع یا anonymous function دریافت کرده و یک آبجکت از نوع SmartiesFilter برمی‌گرداند که عملکرد متد apply آن دقیقاً مطابق با تابع ورودی است.

اگر آرگومان ورودی نامعتبر بود (قابل فراخوانی نبود)، یک InvalidArgumentException با متن پیغام filter must be callable throw کنید.

class SmartiesFilterFactory
{
    public static function create($filter)
    {
        // TODO: Implement
    }
}

توجه: برای پیاده‌سازی متد create، مجاز به ایجاد کلاس جدید (کلاسی که anonymous نباشد) در برنامه نیستید.

کلاس `Smarties`

این کلاس، کلاس اصلی اسمارتیز است. این کلاس شامل متدهای زیر است:

متد addFilter($name, $filter): این متد، یک فیلتر با نام $name را به فیلترها اضافه می‌کند. موارد زیر را برای پیاده‌سازی این متد در نظر داشته باشید:

اگر فیلتری با این نام از قبل موجود باشد، فیلتر جدید باید جایگزین فیلتر قبلی شود. اگر فیلتر ورودی از نوع SmartiesFilter نباشد، باید یک InvalidArgumentException با متن پیغام filter must implement SmartiesFilter throw کنید.
اسمارتیز نباید به کوچکی و بزرگی حروف در نام فیلترها حساس باشد.

متد render($filepath, $parameters): این متد، نام فایل قالب ورودی و آرایه‌ای انجمنی از پارامترها دریافت می‌کند و رشته‌ی خروجی را برمی‌گرداند. موارد زیر را برای پیاده‌سازی این متد در نظر داشته باشید:

اگر فایل $filepath موجود نباشد، باید یک Exception با متن پیغام input file not exist throw کنید.
اگر پارامتری موجود نباشد، باید یک Exception با متن پیغام parameter "$parameterName" not provided throw کنید ($parameterName نام پارامتر است).
اگر فیلتری موجود نباشد، باید یک Exception با متن پیغام filter "$filter" does not exist throw کنید ($filter نام فیلتر است).
اسمارتیز نباید به کوچکی و بزرگی حروف در نام پارامترها حساس باشد. تضمین می‌شود که دو پارامتر نظیر a و A به‌صورت هم‌زمان به این متد داده نمی‌شود.

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

{{ parameter_name }}

برای اعمال فیلتر نیز از کاراکتر | استفاده می‌شود. می‌توان یک یا چند فیلتر را بر روی یک پارامتر اعمال کرد:

{{ parameter1|uppercase }}
{{ parameter2|reverse|uppercase }}

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

class Smarties
{
    public function addFilter($name, $filter)
    {
        // TODO: Implement
    }

    public function render($filepath, $parameters)
    {
        // TODO: Implement
    }
}

مثال

با اجرای اسکریپت index.php موجود در پروژه‌ی اولیه، خروجی باید به‌صورت زیر باشد:

<!DOCTYPE html>
<html>
<head>
  <title>sample</title>
</head>
<body>
  <p>WELCOME TO CODECUP!</p>
</body>
</html>

آن‌چه باید آپلود کنید

فایل‌های Smarties.php و SmartiesFilterFactory را Zip کرده و آپلود کنید.

ارسال پاسخ برای این سؤال