ALBORAQ TECH : طرق إعداد أو تنصيب إطار العمل الكيك cakephp على السيرفر

يمكن أن يكون إعداد إطار العمل الكيك cakephp إعداداً بسيطاً للغاية وهو أقل سرية أو معقداً وأكثر سرية. وسأسعى في هذه المقالة إلى تبيان ثلاثة طرق مختلفة من تنصيب وإعداد إطار العمل الكيك cakephp على السيرفر وأرجو أن لا نركز هنا على تسمية الطريقة بقدر معرفة كيفية تطبيق كل طريقة على حدة بشكل عملي.

·       الطريقة الأولى ( وهي الطريقة الخاصة بمرحلة التطوير ): حيث تكون روابط التطبيق في هذه الطريقة متضمنة اسم المجلد الذي نضع فيه ملفات ومجلدات التطبيق، وهي طريقة أقل سرية ولا تحتاج إلى إعدادات إضافية.

·       الطريقة الثانية ( يمكن أن نسميها طريقة خاصة بمرحلة النشر النهائي على السيرفر لتطبيق واحد): وهي تتطلب القدرة على تغيير الإعدادات الخاصة بجذر السيرفر أي (document root) ، وفي هذه الطريقة تكون الروابط نظيفة وسرية جداً.

·       الطريقة الثالثة ( الطريقة الاحترافية المتقدمة):تتضمن بعض الإعدادات الخاصة، والتي تسمح بوضع مجلدات إطار العمل الكيك cakephp في مجلدات مختلفة من ملفات نظام السيرفر. وهنا من الممكن مشاركة النواة الرئيسية لمكتبة إطار العمل الكيك cakephp عبر العديد من تطبيقاته.

شرح الطريقة الأولى: (مرحلة التطوير)

وهي أسرع طريقة في إعداد إطار العمل الكيك cake. وسنوضح في المثال التالي كيف يمكنك إعداد تطبيق إطار العمل الكيك cakephp وجعله ممكنا عند الرابط :

http://www.example.com/cake_1_2/

وسنفرض في هذا المثال أن جذر السيرفر هو في المسار التالي:

/var/www/html

وبعد تحميل أحدث نسخة مستقرة من إطار العمل الكيك cakephp وفك ضغط هذه النسخة ضمن مجلد اسمه cake_1_2 على سبيل المثال ضمن المسار السابق وبذلك تكون ملفات النظام موضحة كما يلي:

    /var/www/html

        /cake_1_2

            /app

            /cake

            /vendors

            /.htaccess

            /index.php

            /README

وهنا إذا كانت إعدادات السيرفر الأساسية الخاصة بتشغيل إطار العمل الكيك cakephp معدة بنجاح، ستجد أن التطبيق الخاص بمثالنا سيعمل عند الرابط التالي:

http://www.example.com/cake_1_2/.

شرح الطريقة الثانية:(مرحلة النشر) 

في هذه الطريقة يمكننا وضع مجلدات التطبيق في أي مكان من نظام ملفات السيرفر وسيكون ممكنا عند الرابط : http://www.example.com

ولا بد أن نلاحظ في هذه الحالة وجود صلاحيات على الأباشي Apache لتغيير جذر السيرفر أي DocumentRoot.

وبفرض أننا وضعنا مجلدات التطبيق في مجلد ما على السيرفر وليكن اسمه cake_install عندها سيكون توزع الملفات كما يلي:

    /cake_install/

        /app

            /webroot ( هذا هو المجلد الذي يجب أن يحدد كـجذر) 

        /cake

        /vendors

        /.htaccess

        /index.php

        /README 

حيث قمنا بتعيين جذر السيرفر لأباشي كما يلي:

DocumentRoot   /cake_install/app/webroot

 وهنا إذا كانت جميع الإعدادات صحيحة سيكون تطبيقك ممكنا عند الرابط التالي:

http://www.example.com

شرح الطريقة الثالثة:( الطريقة الاحترافية المتقدمة)

هنا يمكننا وضع مجلدات التطبيق في أماكن مختلفة، كما يمكننا فصل هذه المجلدات عن بعضها البعض، مما يتيح لنا مشاركة مكتبة إطار العمل الكيك مع العديد من التطبيقات لكن هذه الطريقة تحتاج إلى إعدات خاصة سنوضحها فيما يلي:

من المعلوم أن التطبيق المعتمد على إطار العمل الكيك له ثلاثة أجزاء رئيسية وكل جزء هو بمثابة مجلد موجود على السيرفر وهذه الأجزاء هي:

1.   النواة الرئيسية لمكتبة الكيك cakephp وهي موجودة في مجلد اسمه /cake .

2.   شيفرة أو كود التطبيق الذي يكتبه المطور وهو موجود في: /app .

3.   جذر التطبيق حيث يوجد ملف الـ index.php وهو عادة ضمن: /app/webroot .

كل من هذه المجلدات يمكن تغيير موقعه ضمن نظام ملفات السيرفر، مع مراعاة خصوصية الجذر webroot الذي من المفترض أن ملف الـ index.php الموجود ضمنه هو الذي سينفذ أولا وسيتم الوصول إليه مباشرة. ولعمل هذه التغييرات لابد من إخبار مكتبة الكيك بذلك عن طريق إجراء التعديلات التالية في ملف الـ index.php الموجود في الجذر:

التعديلات ستشمل ثلاثة ثوابت هامة وهي:

·       ROOT : الذي سيحوي مسار المجلد الذي يوجد ضمنه مجلد التطبيق app.

·       APP_DIR: الذي يتضمن الاسم الأساسي لمجلد التطبيق والذي يأتي بشكل افتراضي app.

·       CAKE_CORE_INCLUDE_PATH: الذي يجب أن يحدد المسار الحاوي على مجلد مكتبة الكيك.

وسنبين ما سبق من خلال المثال التالي:

لنفرض أننا نريد وضع مجلدات مشروعنا كما يلي:

·       مجلد مكتبة الكيك في المسار التالي: /usr/lib/cake .

·       مجلد جذر المشروع في المسار التالي: /var/www/mysite .

·       مجلد التطبيق حيث الشيفرة البرمجية التي يكتبها المطور في المسار التالي: /home/me/mysite .

الآن نجري التعديل على ملف index.php الموجود في المجلد الجذر للمشروع فتصبح تلك التغييرات كما يلي:

if (!defined('ROOT')) {
    define('ROOT', DS.'home'.DS.'me');
}
if (!defined('APP_DIR')) {
    define ('APP_DIR', 'mysite');
}
if (!defined('CAKE_CORE_INCLUDE_PATH')) {
    define('CAKE_CORE_INCLUDE_PATH', DS.'usr'.DS.'lib');
}

وهنا لا بد للانتباه إلى تعديل ملفات حقوق الوصول .htaccess الموجودة في كامل التطبيق بحيث نعيد التوجيه إلى المسار الموجود فيه المجلد الجذر، كما نذكر هنا بأننا استخدمنا الثابت DS بدلا من السلاش العادية وهو الأفضل لتفادي اختلافات المسارات من حيث وضع السلاش / أو \ .

وأخيراً آمل أن تكون هذه المقالة التي مصدرها هو موقع الكيك الرسمي http://book.cakephp.org وقد قمت بترجمتها بتصرف بما يتلائم مع القارئ العربي أن تنال رضاكم وتكون موضع الفائدة العارمة وأرجو إرسال تعليقاتكم على هذه المقالة لنتفادى أي تقصير فيها أو أية فكرة غير واضحة.