بداية

أول الخطوات

أنشيء قاعدة البيانات! س: لم هذه في البداية؟ ج: ليس أمر مهماً. إفعل الخطوات بارك الله فيك :).

1. إفتح المتصفح على الرابط التالي: http://localhost/phpmyadmin/.
2. أنشيء قاعدة بيانات جديدة وسمها، مثلا: "cakephp"، بنوع الترميز (بالإنجليزية: Collation) التالي:
   utf8_unicode_ci
3. إتركها فارغة حالياً لا يهم!

البدء بالعمل

حمل الكيك، في وقت كتابة هذا التدريب، الإصدار  1.2.0.7296rc2 هو المتوفر حالياً.

1. إذهب إلى هذا الرابط : CakePHP Downloads.
2. ستجد مجموعة روابط, لك الخيار أن تختار من بين:
   • كتب PDF صغيرة عادةً ثلاثة كتب.
   • ورابطين بالأسفل لنسخ CakePHP المتوفرة. أنا أخترت هذا اليوم (21-8-2008). الإصدار 1.2.0.7296rc2.
   • وعند تنزيل أحد الإصدارات ستخرج لك نافذة يخيرك بين التبرع للمشروع أو لا. أختر أي الخيارين حسب رغبتك ليتم تحميل الملف.
3. إفتح مدير الملفات وأذهب إلى المجلد،
   /opt/lampp/htdocs أنشيء مجلدا داخله وسمّه 'cakephp'، إفتح هذا المجلد.
4. إفتح الملف المضغوط الذي حملته من الموقع، في هذه الحالة عندي 'cake_1.2.0.7296-rc2.tar.bz2'.
   سيُفتح لك مدير الملفات المضغوطة، أدخل أول مجلد يصادفك "cake_1.2.0.7296-rc2"، وثم حدد المحتويات أمامك (عادةً 4 مجلدات وملفين)
   وفك ضغطه في المجلد 'cakephp' أي في المسار:
   /opt/lampp/htdocs/cakephp/
5. نفذ الأمر التالي، في سطر الأوامر:
   chmod -R 777 /opt/lampp/htdocs/cakephp/app/tmp
6. نفذ الأمر التالي في سطر الأوامر، (نسخ ملف):
   cp /opt/lampp/htdocs/cakephp/app/config/database.php.default /opt/lampp/htdocs/cakephp/app/config/database.php
7. حرر الملف المسمى "database.php" الموجود في المجلد:
   /opt/lampp/htdocs/cakephp/app/config/
8. أدخل فيه القيم، وحسب المبين:

   var $default = array(
   	'driver' => 'mysql',
   	'persistent' => false,
   	'host' => 'localhost',
   	'login' => 'user',
   	'password' => 'password',
   	'database' => 'database_name',
   	'prefix' => '',
   );

   ما يجب عليك أن تغيره حالياً (لأنك تعمل على الخادم المحلي) هو:
   login غيره من user إلى root
   password غيرها إلى كلمة سر قواعد البيانات
   database غيرها إلى إسم قاعدة البيانات (حاليا أسميناها cakephp).</li>

9. حرر الملف المسمى "core.php" الموجود في المجلد:
   /opt/lampp/htdocs/cakephp/app/config/
10. إبحث عن متغير إسمه "Security.salt" غير قيمتة (عادة تكون "DYhG93b0qyJfIxfs2....." إلى أي قيمة مشابهة) إلى أي أحرف وأرقام تختلف عن الموجود.
11. إفتح المتصفح على العنوان:
    http://www.somesite.com/cakephp/
12. والمفروض أن ترى أربعة مربعات خضر (كما في الصورة تحت) تشير إلى تمام العملية، أي خطأ يحصل في التطبيق قد يسبب ظهور علامة خطأ. حاول أن تعرف مسبب الخطأ وأن تصححه.
    
</ol>

تشغيل Cake PHP Command Line Interface

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

1. إضغط مفتاح "Atl+F2"
2. أكتب التالي:
   gksudo gedit /etc/environment


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

   PATH="/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin:/usr/games:/opt/lampp/bin"
LANGUAGE="en_US:en"
LANG="en_US.UTF-8"
3. ما يهمنا هو المتغير PATH، سنضيف له (داخل الإقتباس) في نهايته هذا المحتوى:
   :/opt/lampp/bin

4. فيصبح كما في مثالنا:
   PATH="usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin:/usr/games:/opt/lampp/bin:/opt/lampp/htdocs/cakephp/cake/console"
LANGUAGE="en_US:en"
LANG="en_US.UTF-8"
5. إحفظ الملف.
6. إضغط مفتاح "Atl+F2" وأكتب التالي أو أكتبه في سطر الأوامر Termianl
   . /etc/environment



لإختبار cakePHP Console. جرب الأمر التالي في سطر الأوامر، مع ملاحظة أن لتجريب سطر الأوامر يجب أن تكون في المجلد "app" لا غيره.

cd /opt/lampp/htdocs/cakephp/app/
cake console


يجب سيكون المخرج مشابهاً لهذا:

Model classes:
--------------</p>

Welcome to CakePHP v1.2.0.7296 RC2 Console
---------------------------------------------------------------
App : app
Path: /opt/lampp/htdocs/cakephp/app
---------------------------------------------------------------

>

لن نتطرق الآن لكيفية إستخدام الكونسول، يكفي أنك نجحت في تشغيله.

عن المستند

الكاتب: عمر الدليمي, http://www.omardo.com
للإتصال: أرحب بكافة الملاحظات والنصائح حول ما أكتب:  إتصل بي
الترخيص: Creative Commons 3.0 - by-sa</div>