fir

التنوب

التنوب. إطار خفيفة الوزن PHP MVC.

بدأ إطار FIR كأصوات صغيرة مع الغرض من استخدامها في المشاريع الخاصة ، حيث كانت أقوى النقاط سريعة وسهلة الاستخدام. FIR ليس بديلاً عن الأطر المهنية ، ولكن إذا كنت ترغب في إنشاء تطبيق prototipe بسرعة ، وصنع صفحتين من Ajaxed والقيام ببعض مكالمات قاعدة البيانات ، فيجب أن يكون FIR خيارًا جيدًا.

سمات

خلفية

• سريع للغاية (3ms exec. time)
• خفيفة الوزن للغاية (30 كيلو بايت)
• نمط MVC
• التوجيه الديناميكي (مع عناوين URL النظيفة)
• دعم المساعدين (التحميل كسول)
• دعم المكتبات (التحميل كسول)
• دعم Middleares (تحميل كسول)
• دعم الملحن (التحميل كسول)
• نظام اللغة (التحميل كسول)
• أسماء بالكامل
• نمط الترميز PSR-2
• حماية CSRF للنماذج

الواجهة الأمامية

• تحميل الصفحة الديناميكية (AJAX)
• وشملت jQuery
• مشمل bootstrap

الوثائق

متطلبات

برمجة	الوحدات النمطية
PHP> = 7	MBSTRING
Apache> = 2	mod_rewrite
mysql> = 5

تثبيت

1. تشغيل composer create-project pricop/fir /your-project
2. استيراد ملف fir.sql في قاعدة البيانات الخاصة بك.
3. افتح ملف app/includes/config.php ، وقم بتحديث القيم الخاصة YOURDBUSER ، YOURDBNAME ، YOURDBPASS ، https://localhost/your-project مع معلوماتك الخاصة.

يمكنك الآن الوصول إلى موقع الويب الخاص بك باستخدام عنوان URL الذي حددته في APP_PATH .

---

وحدات التحكم

إنشاء وحدة تحكم جديدة

• يمكن إنشاء وحدات التحكم في مجلد /app/controllers .
• يجب على وحدات التحكم تمديد فئة Controller الأساسية ، على سبيل المثال: class Auth extends Controller {} .
• يجب أن يكون لكل وحدة تحكم طريقة عامة ، تسمى الفهرس ، على سبيل المثال: public function index() {} .

تحميل نموذج

• لتحميل نموذج جديد ، استخدم طريقة $this->model('Example') .

إعادة عرض

• لإرجاع طريقة عرض ، داخل أساليبك ، سترجع ['content' => $this->view->render($data, 'auth/register')] ، حيث تكون $data كائن صفيف يحتوي على البيانات التي يتم تمريرها إلى طرق العرض ، في حين أن 'auth/register' سيكون مسار العرض.

التوجيه

• يتم تعيين الطرق بناءً على اسم وحدة التحكم وطرقها العامة ، عندما تكون طريقة عامة مفقودة ، فإنها ستؤدي تلقائيًا إلى طريقة index لوحدة التحكم.

إضافي

• يمكنك الوصول إلى مسار URL الحالي داخل وحدات التحكم باستخدام خاصية $this->url .
• يمكنك الوصول إلى سلاسل اللغة داخل وحدات التحكم باستخدام خاصية $this->lang .

مثال

 namespace Fir  Controllers ;

class Auth extends Controller
{
    public function index ()
    {
        return [ ' content ' => $ this -> view -> render ( $ data , ' auth/index ' )];
    }
    
    public function register ()
    {
        return [ ' content ' => $ this -> view -> render ( $ data , ' auth/register ' )];
    }
}

---

النماذج

إنشاء نموذج

• يمكن إنشاء النماذج في مجلد /app/models .
• يجب أن تمدد النماذج فئة Model الأساسي ، على سبيل المثال: class Auth extends Model {} .
• يمكنك الوصول إلى كائن قاعدة البيانات باستخدام خاصية $this->db .

مثال

 namespace Fir  Models ;

class Auth extends Model
{
    public function get ()
    {
        // SQL query here
    }
}

---

وجهات النظر

إنشاء عرض

• يمكن إنشاء وجهات النظر في مجلد /public/theme/views .

الوصول إلى البيانات في طرق العرض

• يحمل كائن صفيف $data جميع البيانات التي يتم تمريرها من وحدات التحكم.

إضافي

• يمكنك الهروب من السلاسل في وجهات نظر باستخدام وظيفة e ، على سبيل المثال: e('Example') .
• يمكنك عرض الرسائل المخزنة في $_SESSION['message'] باستخدام طريقة $this->message() .
• يمكنك عرض سلسلة لغة في طرق العرض باستخدام طريقة $this->lang('key') .
• يمكنك تقديم إدخال الرمز المميز CSRF لأشكالك باستخدام طريقة $this->token() .
• لعرض القائمة الكاملة للمساعدين المتاحين لمشاهدة طرق العرض ، راجع app/core/View.php .

مثال

 <?php
defined ( ' FIR ' ) OR exit ();
?>

<?= e ( " Hello World " ) ?> 

تختتم

على الرغم من أن هذه الوثائق قد تكون أكثر شمولاً ، إلا أن الكود تم التعليق جيدًا ، ويمكن العثور على معظم الأشياء التي تحتاج إلى معرفتها مباشرة في الأمثلة المقدمة في الإطار.

ترميز سعيد.