Alvanweb http://weblog.alvanweb.com یادداشت های مرتضی الوانی Thu, 23 Oct 2008 20:42:54 +0000 http://wordpress.org/?v=2.5 en 483518http://www.feedburner.com ساخت لینکدونی با CakePHP (بخش سوم) http://feeds.feedburner.com/~r/alvanweb/~3/430010900/ http://weblog.alvanweb.com/2008/10/24/create-linkdump-with-cakephp-part-3/#comments Thu, 23 Oct 2008 20:40:09 +0000 مرتضی الوانی http://weblog.alvanweb.com/?p=157 پیش نیازها: ساخت لینکدونی با CakePHP (بخش اول) و (بخش دوم)
در مراحل قبل داده‌ها را از دیتابیس خواندیم و در قالب لینک نمایش دادیم. در این بخش قصد داریم امکان افزودن لینک جدید، ویرایش و حذف لینک را اضافه کنیم و مختصری هم با Routes در کیک پی‌اچ‌پی آشنا شویم.

ساخت فرم و افزودن لینک

طبق نمونه‌های گذشته به فایل links_controller.php کنش add را بصورت زیر اضافه می‌کنیم تا بتوانیم لینک‌های جدیدی در دیتابیس اضافه کنیم:

  1. <?php
  2. class LinksController extends AppController {
  3.   var $name = 'Links';
  4.   function index() {
  5.     $this->set('links', $this->Link->find('all'));
  6.   }     
  7.   function view($id = null) {
  8.     $this->Link->id = $id;
  9.     $this->set('link', $this->Link->read());
  10.   }       
  11.   function add() {
  12.     if (!empty($this->data)) {
  13.      if ($this->Link->save($this->data)) {
  14. $this->flash('Your link has been saved.', '/links');
  15.      }
  16.     }
  17.   } 
  18. }
  19. ?>

تابع add را به این صورت تعریف می‌کنیم که چنانچه فرم ارسال شده خالی نبود، با استفاده از مدل Link سعی شود داده ذخیره شود اما چنانچه بنا به دلایلی ذخیره نشد، نما نمایش داده شود. این خود فرصتی را در اختیارمان قرار می‌دهد تا خطاهای ناشی از محتوای فیلدهای ارسالی را نمایش دهیم.

هنگامی کاربر به روش POST داده‌ها را به برنامه ارسال می‌کند، این اطلاعات در $this->data وجود دارند با استفاده از تابع pr‌ می‌توانید آن‌ها را چاپ کنید. تابع $this->flash() یک متد کنترلر است که برای چند ثانیه پیامی را به کاربر نشان می‌دهد. سپس کاربر را به صفحه‌ای که به عنوان پارامتر دوم دریافت می‌کند هدایت می‌کند. (در اینجا کاربر به صفحه‌ی links هدایت می‌شود)

در اینجا لازم است در مورد اشکال زدایی توکار فریم‌ورک (Debug) توضیح بدهم. کیک برای اشکال زدایی دو حالت تولید (Production) و توسعه (Development) دارد. حالت تولید مربوط به زمانی است که پروژه تان با کیک اتمام یافته و قصد دارید آن را ارائه کنید. حالت توسعه هم گویای زمان توسعه پروژه است. این حالت‌ها در فایل app\config\core.php با مقداردهی عددی از 0 تا 3 برای debug قابل تنظیم است.

مقدار 0 مربوط به حالت تولید می‌شود، در این حالت هیچ خطا و هشداری مشاهده نمی‌شود و تابع Flash که در بالا معرفی شد بصورت redirect عمل میکند (بطور خودکار کاربر به صفحه دیگر منتقل می‌شود) در حالتی که این مقدار بزرگتراز صفر تنظیم شود فریم‌ورک در حالت توسعه است و تابع Flash بطور خودکار عمل انتقال کاربر به صفحه جدید را انجام نمی‌دهد (بطور پیشفرض مقدار روی 2 تنظیم شده است)

متد save خطاها را بررسی خواهد کرد و چنانچه خطایی رخ دهد عمل ذخیره انجام نخواهد شد. در قسمت بعد توضیح خواهم داد که چگونه این خطاها را کنترل کنید.

معتبرسازی داده

هر برنامه‌نویس تحت وبی رویکردی برای بررسی صحت اطلاعات وارد شده در فیلدهای فرم‌ها دارد و تقریبا معتبرسازی اطلاعات وارد شده و هدایت کاربر به پرکردن صحیح فرم‌ها کار وقت گیری است. کیک در این مورد بی‌اندازه متنوع و انعطاف‌پذیر است.

برای بهره‌گیری از قابلیت‌های معتبرسازی فرم‌ها کافیست از FormHelper کیک استفاده کنید. FormHelper بطور پیشفرض در همه نماها که در آن عملگر $form بکار رود موجود است. نمای add را بصورت زیر ایجاد می‌کنیم:

  1. /app/views/links/add.ctp
  2. <h1>Add Link</h1>
  3. <?php
  4. echo $form->create('Link');
  5. echo $form->input('title');
  6. echo $form->input('url');
  7. echo $form->input('body', array('rows' => '3'));
  8. echo $form->end('Save Link');
  9. ?>

در اینجا از $form->create() بمنظور ایجاد تگ باز form استفاده کردیم این کد خروجی زیر را تولید می‌کند:

  1. <form id="LinkAddForm" method="post" action="/cake/links/add">

اگر تابع create هیچ پارامتری نداشته باشد، بطور پیشفرض کیک action و method را مقدار‌دهی می‌کند. از $form->input() هم برای ایجاد عناصر فرم با همان نامی که به عنوان پارامتر می‌گیرد استفاده می‌شود. کیک توسط اولین پارامتر تشخیص می‌دهد که فیلد از چه نوعی است و دومین پارامتر این امکان را فراهم می کند که آرایه وسیعی با اختیارات فراوان تعیین کنیم. در اینجا تعداد سطرهای textarea لحاظ شده است. input() عناصر فرمی متفاوتی را، مبنی بر مدل فیلد مشخص شده، ایجاد می‌کند و این یکی از شگردهای کیک است.
با فراخوانی $form->end() یک کلید ارسال ایجاد، و تگ form بسته می‌شود. رشته‌ای که به عنوان اولین پارامتر end() قرار می‌گیرد، برابر مقدار (value) کلید ارسال خواهد بود.

حال اجازه بدهید به صفحه اصلی لینکدونی برگردیم و در فایل app/views/links/index.ctp لینک صفحه جدیدی را که بمنظور افزودن داده به دیتابیس ساختیم، قبل از جدول اضافه کنیم:

  1. <?php echo $html->link('Add Link','/links/add')?>

ممکنه تعجب کنید که چطور کیک صحت اعتبار این فیلدها را بررسی می‌کند. قاعده‌های معتبر‌سازی در مدل تعریف می‌شوند. بدین منظور مجدداً به مدل Link بر می‌گردیم و اصلاحاتی را به شکل زیر لحاظ می‌کنیم:

  1. <?php
  2. class Link extends AppModel {
  3.    var $name = 'Link';
  4.    var $validate = array(
  5.      'title' => array(
  6.      'rule' => array('minLength', 1)
  7.     ),
  8.      'url' => array(
  9.      'rule' => array('minLength', 1)
  10.     ),   
  11.      'body' => array(
  12.      'rule' => array('minLength', 1)
  13.     )
  14.   );   
  15. }
  16. ?>

آرایه $validate به کیک می‌گوید که هنگامی که متد save() فراخوانی شد چگونه صحت اطلاعات بررسی شود. در اینجا سه فیلد عنوان، آدرس و توضیحات را چک می‌کنیم که نبایستی خالی باشد. یکبار دیگر تکرار می‌کنم موتور معتبرسازی کیک بسیار قوی است چرا که شمار زیادی از قواعد پیش‌ساخته شده (بررسی صحت آدرس ایمیل، شماره کارت اعتباری، تلفن و ...) در آن گنجانده شده است و سفارشی سازی آنها انعطاف پذیری فوق العاده‌ای دارد. برای اطلاعات بیشر می توانید به اینجا رجوع کنید.

هم‌اکنون قواعد معتبرسازی لحاظ شده‌اند. فرم افزودن لینک را با فیلدهای خالی تست کنید تا ببینید چگونه کار می‌کند. هنگامی که از input() برای ایجاد عناصر فرم استفاده می‌کنیم، خطاهای مربوط به عدم صحت داده بطور خودکار نمایش داده می‌شوند.

حذف کردن لینک

قصد داریم امکانی را ایجاد کنیم که کاربران بتوانند لینک‌ها را از دیتابیس پاک کنند. خوب! با کنش delete() در LinksControlle به شکل زیر شروع می کنیم:

  1. function delete($id) {
  2. $this->Link->del($id);
  3. $this->flash('The link with id: '.$id.' has been deleted.', '/links');
  4. }

این تابع با گرفتن $id هر لینک، آن را از دیتابیس پاک می‌کند و با استفاده از flash() پیام تاییدی را مبنی بر حذف لینک قبل از ری‌دایرکت (انتقال خودکار) شدن به صفحه‌ی /links به کاربر نشان می‌دهد. با این وجود یکبار دیگر باید فایل index.ctp را بصورت زیر ویرایش کنیم و قابلیت حذف هر لینک را به آن بیفزاییم:

  1. <h1>Links:</h1>
  2. <p><?php echo $html->link('Add Link','/links/add')?></p>
  3.  
  4. <table>
  5. <tr>
  6. <th>Id</th>
  7. <th>Title</th>
  8. <th>Actions</th>
  9. <th>Created</th>
  10. </tr>
  11. <?php foreach ($links as $link): ?>
  12. <tr>
  13. <td><?php echo $link['Link']['id']; ?></td>
  14. <td><?php echo $html->link($link['Link']['title'],
  15. "/links/view/".$link['Link']['id']); ?></td>
  16. <td><?php echo $html->link('Delete', "/links/delete/{$link['Link']['id']}", null, 'Are you sure?' )?></td>
  17. <td><?php echo $link['Link']['created']; ?></td>
  18. </tr>
  19. <?php endforeach; ?>
  20. </table>

کد بالا از قابلیت توکار HtmlHelper بمنظور ایجاد یک دیالوگ جاوااسکریپتی تایید حذف لینک، قبل از اینکه کاربر لینک را حذف کند، استفاده می کند. می‌بینید این فریم‌ورک تا چه اندازه همه چیز را ساده کرده است!

ویرایش لینک

اگر مراحل قبل را فراگرفته باشید از الان شما یک حرفه‌‌ای کیک پی‌اچ‌پی هستید! پس می‌بایستی الگوی ادامه کار را حدس بزنید. یک کنش می‌سازیم و سپس نما را اضافه می‌کنیم. در زیر کنش edit() را که باید در LinksControlle لحاظ شود می‌بینید:

  1. function edit($id = null) {
  2.  $this->Link->id = $id;
  3.  if (empty($this->data)) {
  4.   $this->data = $this->Link->read();
  5.  } else {
  6.   if ($this->Link->save($this->data)) {
  7. $this->flash('Your link has been updated.','/links');
  8.   }
  9.  }
  10. }

این تابع ابتدا داده ارسالی فرم را بررسی می‌کند ، اگر هیچ چیزی فرستاده نشده باشد لینک‌ها را به نما منتقل می‌کند. اگر داده‌ای در نتیجه تغییر، ارسال شده باشد سعی می‌کند از طریق مدل Link داده‌ جدید را در دیتابیس ذخیره کند (یا خطاهای ناشی از عدم اعتبار داده را نشان خواهد داد) نمای edit بصورت زیر است:

  1. /app/views/links/edit.ctp
  2. <h1>Edit Link</h1>
  3. <?php
  4. echo $form->create('Link', array('action' => 'edit'));
  5. echo $form->input('title');
  6. echo $form->input('url');
  7. echo $form->input('body', array('rows' => '3'));
  8. echo $form->input('id', array('type'=>'hidden'));
  9. echo $form->end('Save Link');
  10. ?>

خروجی کد بالا فرمی خواهد بود که درفیلدهای آن اطلاعات لینکی که درخواست ویرایش آن داده شده قرار دارد. باید در اینجا توجه کنید که id هر لینک بصورت یک عنصر مخفی (hidden) در فرم آمده است. در حقیقت هنگامی که id هر لینک با اطلاعات ارسال شده باشد کیک تشخیص می‌دهد که این لینک باید ویرایش شود در صورتی که اگر id با اطلاعات ارسالی نباشد هنگامی که تابع save() فراخوانی می‌شود یک لینک جدید اضافه خواهد شد.

مجدداً به نمای index برمی‌گردیم و قابلیت ویرایش هر لینک را به صورت زیر در کنار پیوند مربوط به حذف لینک اضافه می‌کنیم (تا در صفحه‌ی اصلی قابلیت ویرایش لینک را داشته باشیم):

  1. <?php echo $html->link('Edit', '/links/edit/'.$link['Link']['id']);?>

تا اینجا آموختید که چگونه با CakePHP یک لینکدونی ساده بسازید. قابلیت‌هایی نظیر افزودن، ویرایش و حذف لینک تنها به این دلیل بود که با نحوه ایجاد کنش در کنترلر آشنا شوید و بتوانید نماهای مربوطه را ایجاد کنید. به ادمه بحث در مورد Routes (مسیرها) می‌پردازیم.

مسیرها (Routes) در CakePHP

برای بعضی‌ها تنظیمات پیشفرض کیک در مورد مسیرها کافی است. اما توسعه دهندگان نسبت به کاربرپسند کردن URL‌ها و سازگاری با موتورهای جستجو حساس هستند. از اینرو می‌توانند از تنظیمات Routes استفاده کنند. در این آموزش تغییرات ناچیزی را در این مورد لحاظ می‌کنیم برای اطلاعات بیشتر و تکنیک‌های مسیر‌دهی پیشرفته، بخش Routes Configuration در مستندات کیک را ببینید.

تا اینجا که لینکدونی را ایجاد کردیم چنانچه کاربری به صفحه‌ی اصلی (شاخه دایرکتوری اصلی) به نشانی example.com/cake مراجعه کند بطور پیشفرض PagesController فراخوانی می‌شود و نمایی بنام home رندر می‌شود. قصد داریم مسیر را طوری تعیین کنیم که با درخواست شاخه اصلی، لیست لینک‌ها نمایش داده شود.

مسیرها در فایل app/config/routes.php تعیین می‌شوند. خط زیر مسیر پیشفرض شاخه اصلی را تعیین می‌کند. آن را توسط کامنت (//) غیرفعال کنید یا این خط را پاک کنید:

  1. Router::connect('/', array('controller' => 'pages', 'action' => 'display', 'home'));

خط فوق آدرس '/' را با صفحه پیشفرض کیک مرتبط می‌کند. ما می‌خواهیم آن را با کنترلر خودمان ارتباط دهیم بنابراین خط زیر را به این فایل اضافه می‌کنیم:

  1. Router::connect('/', array('controller' => 'links', 'action' => 'index'));

حال با رفتن به صفحه اصلی کیک به نشانی example.com/cake بجای صفحه پیشفرض لیست لینک‌ها را می‌بینید. می‌توانید نام شاخه اصلی را که در بخش اول آموزش cake گذاشتید، به linkdump تغییر دهید (تا هخوانی بیشتری با پروژه داشته باشد) بنابراین آدرس صفحه اصلی به example.com/linkdump تغییر خواهد کرد.

اگر نام شاخه را از cake به linkdump تغییر دادید فایل‌های تمپ را پاک کنید تا صفحه اصلی را ببینید. تنها جهت آشنایی شما با خطاهای پیکربندی اولیه کیک، نام دایرکتوری را ابتدا cake انتخاب کردم چون می‌توانست از همان ابتدا linkdump انتخاب شود.

سخن آخر

نوشتن این لینکدونی در اینجا به پایان رسید. ساده نبود؟! یادتان باشد این آموزش پایه بود CakePHP خیلی خیلی قابلیت‌های بیشتری از آنچه گفته شد دارد و بیش از آنچه تصور کنید انعطاف‌پذیر است. متاسفم از اینکه باید بگویم فرصت کافی ندارم تا آنچه از کیک می‌دانم بزبان ساده بیان کنم.

از همین الان می‌توانید پروژه‌های آزمایشی را با کیک شروع کنید. بزرگترین راهنما یعنی Manual و API کیک در اختیار شماست. اگر مشکلی داشتید در حد دانشم درخدمتم. موفق باشید. (مرتضی الوانی، آبانماه 1387)

دریافت فایل‌های ضمیمه

[+] دایرکتوری app این پروژه بهمراه فایل sql ساخت جدول
[+] آموزش کامل (بخش‌های اول و دوم و سوم) بصورت PDF

]]> http://weblog.alvanweb.com/2008/10/24/create-linkdump-with-cakephp-part-3/feed/ http://api.feedburner.com/awareness/1.0/GetItemData?uri=alvanweb&itemurl=http%3A%2F%2Fweblog.alvanweb.com%2F2008%2F10%2F24%2Fcreate-linkdump-with-cakephp-part-3%2Fhttp://weblog.alvanweb.com/2008/10/24/create-linkdump-with-cakephp-part-3/ ساخت لینکدونی با CakePHP (بخش دوم) http://feeds.feedburner.com/~r/alvanweb/~3/428933927/ http://weblog.alvanweb.com/2008/10/23/create-linkdump-with-cakephp-part-2/#comments Wed, 22 Oct 2008 20:43:33 +0000 مرتضی الوانی http://weblog.alvanweb.com/?p=156 پیش نیاز: ساخت لینکدونی با CakePHP (بخش اول)
در پست قبل تا ساخت پایگاه‌ داده و مقداردهی فایل database.php بمنظور ارتباط با MySQL پیش رفتیم. حال یک جدول بنام links با شش فیلد زیر در دیتابیس linkdump که قبلاً ساخته‌ایم ایجاد می‌کنیم. همچنین جهت تست دو لینک اضافه می‌کنیم:

  1. /* First, create our links table: */
  2. CREATE TABLE links (
  3. id INT UNSIGNED AUTO_INCREMENT PRIMARY KEY,
  4. url VARCHAR(255),
  5. title VARCHAR(255),
  6. body TEXT,
  7. created DATETIME DEFAULT NULL,
  8. modified DATETIME DEFAULT NULL
  9. );
  10. /* Then insert some links for testing: */
  11. INSERT INTO links (url, title, body, created) VALUES
  12. ('http://alvanweb.com', 'Alvanweb', 'All about web design and progrmming', NOW()),
  13. ('http://cakephp.org', 'CakePHP', 'The rapid development php framework', NOW());

نام‌ جدول و ستون‌ها اختیاری نیستند! اگر از قواعد نامگذاری جداول و کلاس‌های کیک پیروی کنید خواهید توانست از مزایای توابع توکار کیک بدون پیکر‌بندی براحتی استفاده کنید. کیک تا انجا انعطاف پذیر است که حتی با وجود عدم تطابق با طرح‌های پیشفرض می‌توانید آن را سفارشی کنید اما استفاده از قواعد در صرفه‌جویی زمان موثر است.

برای اطلاعات بیشتر در مورد این قواعد نامگذاری اینجا را ببینید. اما همین اندازه کافی است که بدانید جدول links بطور خودکار به مدلی بنام link اشاره دارد و همچنین فیلدهای created و modified بطور منطقی و خودکار توسط کیک مدیریت می‌شوند.

ایجاد یک مدل

به سراغ کدنویسی کیک می‌رویم. اولین فایلی که باید ایجاد کنیم یک مدل برای لینک‌ها است. به زبان ساده بگویم مدل در واقع نان و کره‌ی یک برنامه نوشته شده با کیک است. با ایجاد یک مدل با دیتابیس ارتباط برقرار کرده‌ایم. در ابتدا پایه کد را می‌نویسیم سپس اعمالی نظیر نمایش، افزودن، ویرایش و حذف لینک را اضافه خواهیم کرد.

کلاسی که به عنوان مدل تعریف می‌شود در app/models قرار می‌گیرد و محتویات فایلی که در app/models/link.php ذخیره خواهد شد بصورت زیر است:

  1. <?php
  2. class Link extends AppModel {
  3.    var $name = 'Link';
  4. }
  5. ?>

یادتان نرود قواعد نامگذاری در کیک بسیار مهم است. با نامیدن مدل بنام Link کیک بطور خودکار می‌تواند تشخیص دهد که این مدل توسط کنترلری بنام LinksController بکار گرفته خواهد شد و با جدولی بنام links در دیتابیس در ارتباط است.

اگر کیک نتواند فایلی مطابق با مدل در app/models بیابد، بطور داینامیک یک آبجکت مدل ایجاد می‌کند. این همچنین به این معناست که اگر بطور تصادفی نام فایل مدل را اشتباه تایپ کنید (مثلا بجای link.php نام فایل links.php شود) کیک هیچ کدام از تنظیمات شما را لحاظ نمی کند و در عوض مقادیر پیشفرض خودش را جانشین خواهد کرد.

ایجاد یک کنترل‌کننده

در این مرحله برای لینک هایمان یک کنترلر ایجاد می‌کنیم. کنترلر جایی است که قصد داریم جزئیات لینک ها را استخراج کنیم. فایلی بنام links_controller.php را با محتویات پایه‌ی زیر در app/controllers ایجاد می‌کنیم:

  1. <?php
  2. class LinksController extends AppController {
  3.    var $name = 'Links';
  4. }
  5. ?>

حال اجازه دهید یک کنش (Action) به کنترلر بیفزایم. کنش اغلب به یک تابع در برنامه اشاره دارد. برای مثال وقتی کاربران درخواست example.com/cake/links/index را ‌می‌دهند (که با example.com/cake/links مشابه است) انتظار دارند با لیستی از لینک‌ها مواجه شوند. کدی که این کنش را تعریف می‌کند بصورت زیر است:

  1. <?php
  2. class LinksController extends AppController {
  3.    var $name = 'Links';
  4.    function index() {
  5.      $this->set('links', $this->Link->find('all'));
  6.    }
  7. }
  8. ?>

با تعریف تابع index در LinksController، کاربران می‌توانند به درخواستی مانند این example.com/cake/links/index دسترسی داشته باشند. بطور مشابه اگر تابعی بنام foobar تعریف کنیم کاربران قادر خواهند بود به درخواست example.com/links/foobar دسترسی داشته باشند.

ممکن است کنجکاو شوید تا به طریقی نام‌های کنترلر و کنش را تغییر دهید. فعلاً دست نگهدارید و از قواعد کیک بمنظور ایجاد کنش‌های قابل فهم استفاده کنید. در آینده بدین منظور با routes در کیک آشنا خواهید شد.

در این کنش از تابع set برای گذر داده از کنترل‌کننده به نمایش (view) استفاده می‌کنیم. این خط، متغیر links را برابر مقدار بازگشتی از find('all') تنظیم می‌کند. مدل لینک بطور خودکار در $this->Link موجود خواهد بود چراکه از قواعد نامگذاری کیک استفاده کردیم.

ایجاد یک نما

تا هم اکنون با جریان داده به مدل، منطق برنامه و روند تعریف شده توسط کنترلر آشنا شدید حال اجازه دهید یک نما برای کنش index که در بالا تعریف شد ایجاد کنیم. نماهای کیک در واقع نمایش اجزایی هستند که در طرح‌بندی (layout) برنامه کنار هم قرار میگیرند. برای بیشتر برنامه‌ها HTML مخلوط با PHP استفاده می‌شود اما می تواند بصورت XML، CSV یا حتی داده باینری باشد.

آخرین قسمت عنوان قبل را بیاد آورید، که چگونه متغیر links را با متد set به نما ارجاع می‌دادیم؟ خروجی آرایه را می‌توانیم به صورت زیر نشان دهیم:

  1. // print_r($links) output:
  3. (
  4.  [0] => Array
  5.   (
  6.         [Link] => Array
  7.          (
  8.          [id] => 1
  9.          [url] => http://alvanweb.com
  10.          [title] => Alvanweb
  11.  [body] => All about web design and progrmming
  12.          [created] => 2008-10-22 20:29:21
  13.          [modified] =>
  14.          )
  15.   )
  16.  [1] => Array
  17.   (
  18.         Link] => Array
  19.          (
  20.          [id] => 2
  21.          [url] => http://cakephp.org
  22.          [title] => CakePHP
  23.  [body] => The rapid development php framework
  24.          [created] => 2008-10-22 20:29:21
  25.          [modified] =>
  26.          )
  27.   )
  28. )

فایل‌های مربوط به نما در app/views در فولدری همنام با واژ‌ه‌ای که در کنترلر تعریف می‌شود، ذخیره می‌شوند. (در اینجا می‌بایستی نام فولدر ما links باشد) برای فرم‌دادن به داده‌ی لینک‌هایمان در قالب یک جدول زیبا(ایجاد صفحه‌ای برای کنش index)، از کد زیر استفاده می‌کنیم:

  1. /app/views/links/index.ctp
  2. <h1>Links:</h1>
  5. <th>Id</th>
  6. <th>Title</th>
  7. <th>Created</th>
  8. </tr>
  9. <?php foreach ($links as $link): ?>
  11. <td><?php echo $link['Link']['id']; ?></td>
  12. <td><?php echo $html->link($link['Link']['title'],
  13. "/links/view/".$link['Link']['id']); ?></td>
  14. <td><?php echo $link['Link']['created']; ?></td>
  15. </tr>
  16. <?php endforeach; ?>
  17. </table>

احتمالاً متوجه استفاده از آبجکتی بنام $html شده‌اید. این یک نمونه از کلاس HtmlHelper کیک است. کیک‌ پی‌اچ‌پی مجموعه‌ای از این آبجکت‌ها را تحت نام view helpers در خود گنجانده است مواردی از قبیل لینک‌گذاری، خروجی فرم، جاوااسکریپت و آژاکس از این دسته‌اند. اطلاعات تکمیلی درمورد کار با آنها را می‌توانید اینجا بیابید. اما انچه در اینجا مهم است که بدان اشاره شود متد link است که بوسیله‌ی پارامترهایی که گرفته است، یک لینک HTML را ایجاد خواهد کرد. در این مرحله می بایستی بتوانید در مرورگرتان مسیر example.com/cake/links/index را ببینید.

اگر بر روی هر یک از لینک‌ها کلیک کنید تا توضیحاتش را ببینید با صفحه‌ی خطایی مواجه خواهید شد مبنی بر این که کنش مربوطه در فایل کنترل‌کننده هنوز تعریف نشده است. بنابراین مجدداً به فایل links_controller.php بر‌ می‌گردیم تا یک کنش بنام view بمنظور نمایش اطلاعات هر لینک ایجاد کنیم:

  1. <?php
  2. class LinksController extends AppController {
  3.   var $name = 'Links';
  4.   function index() {
  5.     $this->set('links', $this->Link->find('all'));
  6.   }
  7.   function view($id = null) {
  8.     $this->Link->id = $id;
  9.     $this->set('link', $this->Link->read());
  10.   }   
  11. }
  12. ?>

خوب با set که از قبل آشنایی دارید اما نکته‌ای که در اینجا لازم است به آن اشاره کنیم این است که بجای find('all') از read استفاده کردیم چراکه قصد داریم اطلاعات تنها یک لینک را استخراج کنیم.

دقت کنید کنش view یک پارامتر می‌گیرد که برابر با ID هر لینک است. این پارامتر از طریق درخواست از طریق URL مقداردهی می‌شود بطوریکه اگر کاربری links/view/2 را درخواست دهد، مقدار 2 برابر ID خواهد بود. حال اجازه دهید نمای view را برای این کنش در app/views/links بصورت زیر ایجاد کنیم:

  1. /app/views/links/view.ctp
  2. <h1><?php echo $html->link($link['Link']['title'],
  3. $link['Link']['url']); ?></h1>
  4. <p><small>Created: <?php echo $link['Link']['created']?></small></p>
  5. <p><?php echo $link['Link']['body']?></p>

حال با کلیک بر روی هر لینک اطلاعات مربوط به آن لینک در صفحه‌ای دیگر نمایش داده خواهد شد. در پست بعدی سایر مراحل را دنبال خواهیم کرد.
ادامه: ساخت لینکدونی با CakePHP (بخش سوم)

]]> http://weblog.alvanweb.com/2008/10/23/create-linkdump-with-cakephp-part-2/feed/ http://api.feedburner.com/awareness/1.0/GetItemData?uri=alvanweb&itemurl=http%3A%2F%2Fweblog.alvanweb.com%2F2008%2F10%2F23%2Fcreate-linkdump-with-cakephp-part-2%2Fhttp://weblog.alvanweb.com/2008/10/23/create-linkdump-with-cakephp-part-2/ ساخت لینکدونی با CakePHP (بخش اول) http://feeds.feedburner.com/~r/alvanweb/~3/428687509/ http://weblog.alvanweb.com/2008/10/22/create-linkdump-with-cakephp-part-1/#comments Wed, 22 Oct 2008 16:03:54 +0000 مرتضی الوانی http://weblog.alvanweb.com/?p=155 در پست قبل با فریم‌ورک قدرتمند CakePHP و ساختار MVC آشنا شدیم. از آنجایی که فراگیری این ساختار جز با تمرین و در عمل ممکن نیست، در این پست و پست‌های آتی قصد داریم یک پروژه‌ی کوچک را با این فریم‌ورک مرحله به مرحله با هم دنبال کنیم. در ابتدا ساخت یک لینکدونی ساده که قابلیت افزودن، ویرایش و حذف لینک را دارد هدف نهایی است و در مرحله بعد در صورتیکه فرصت محدودم اجازه بیشتری بدهد قابلیت‌های دیگری نظیر شمارش کلیک، دسته‌بندی و امکان نظر‌دهی افزوده خواهد شد.

آنچه برای شروع کار با کیک مورد نیاز است

1) سرور HTTP،‌ ترجیاً Apache با mod_rewrite فعال (برای کاربرپسند کردن URL‌ها و کار با فایل‌های htaccess بهتر است قابلیت mod rewrite را فعال کنید. بدین منظور می‌بایستی فایل httpd.conf سرور آپاچی را ویرایش کنید)

2) پی‌‌اچ‌پی 4.3.2 یا بالاتر، کیک پی‌اچ‌پی با نسخه‌های 4 و 5 پی‌اچ‌پی کاملاً سازگار است. برای نصب PHP تحت ویندوز خواندن این مطلب پیشنهاد می‌شود.

برای اجرای کیک موارد فوق کافی است اما در مورد ساخت لینکدونی به یک پایگاه داده نیاز داریم. ترجیحاً از MySQL استفاده می‌کنیم. برای نصب و راه‌اندازی مای ‌اس‌کیو‌ال سرور، خواندن این مطلب پیشنهاد می‌شود. لازم به ذکر است، CakePHP علاوه بر MySQL از پایگا‌ه‌های داده زیر پشتیبانی می‌کند:

  • PostgreSQL| Firebird DB2 | Microsoft SQL Server | Oracle | SQLite | ODBC

برای راحت‌کار کردن با MySQL بهتر است از رابط تحت وب phpmyadmin استفاده کنید یا با استفاده از رابط گرافیکی MySQL GUI Tools دیتابیس را مدیریت کنید.

نحوه نصب و پیکربندی CakePHP

کیک کاملاً رایگان و کد‌باز است. به دو طریق می‌توانید آخرین نسخه از آن را دریافت کنید. اول اینکه یک نسخه فشرده شده‌ی (zip/tar.gz/tar.bz2) آن را از اینجا بگیرید یا از مخزن SVN (برای سری 1.2.x.x از اینجا) استفاده کنید. تمامی متعلقات کیک در پروژه‌ای بنام CakeForge جمع آوری شده است. دریافت مستقیم کیک بهمراه مستندات نسخه‌های 1.1 و 1.2 آن در اینجا موجود است. در این آموزش از سری 1.2 این فریم‌ورک استفاده می کنیم.

پس از دریافت کیک آن را به وب سرور خود منتقل کنید ساختار فولدر‌ها و فایل‌های بیس کیک به صورت زیر است:

CakePHP Files Structure

از فولدر App شروع می‌کنیم، این همان فولدری است که بیشترین کار توسعه پروژه‌ در آن انجام می شود. هر چند نام فایل‌ها و فولدر‌های موجود در این شاخه گویای همه چیز است اما اجازه دهید نگاه دقیقتری به محتویات آن داشته باشیم:

Config فایل‌های مربوط به پیکربندی برنامه معمولا در اینجا قرار دارند. دقت کنید این فایلها تنظیمات مربوط به هسته فریم ورک را شامل نمیشود (تنها تنظیمات مختصری در مورد پروژه‌ی کاریمان نظیر جزییات اتصال به پایگاه داده، محل قرار گیری فایل‌ها روی سرور و ...)

Controllers کنترل‌گرها و مولفه‌ها‌ی (کامپونت‌ها‌ی) پروژه‌ در این فولدر قرار خواهند گرفت. پیش از این گفتیم کنترل کننده (کنترلر) درخواست‌هایی که توسط کلاینت ایجاد شده را بررسی و به یه مسیر صحیح هدایت می کند.

Locale برای فایل‌های مربوط به بومی‌سازی پروژه مورد استفاده قرار می‌گیرد. برای مثال قصد دارید پروژه‌ای را شروع کنید که به چند زبان مختلف موجود باشد، فایل‌های حاوی سایر زبان‌ها در اینجا قرار می‌گیرند.

Models مدل‌‌های پروژه ‌در این فولدر قرار خواهند گرفت. قبلاً گفتیم که که مدل‌ها به نوعی به داده برنامه اشاره دارد. معمولاً جداول پایگاه‌های داده در اینجا مورد بحث قرار می‌گیرند بطوریکه به ازای هر جدول پایگاه داده، یک فایل در این فولدر قرار خواهد گرفت که بدان جدول اشاره دارد.

Plugins پکیج‌های پلاگین چنانچه در صورت نیاز برای پروژه نوشته شود در اینجا قرار خواهد گرفت. پس از اتمام پروژه می توانید افزونه‌هایی بنویسید که بدون تغییر اساسی در پروژه قابلیت‌های جداگانه‌ای بدان اضافه کند.

Tmp در این فولدر اطلاعات تمپ (موقتی) ذخیره می‌شوند. نحوه ذخیره اطلاعات به تنظیمات کیک بستگی خواهد داشت، اما بطور معمول توضیحات مدل، فایل‌های ثبت وقایع و گاهی اوقات اطلاعات نشست‌ها در این فولدر ذخیره می‌شوند.

Vendors کلاس‌ها یا کتابخانه‌هایی که توسط شخص برنامه‌نویس برای استفاده در برنامه نوشته می‌شوند باید در اینجا قرار بگیرند. جلوتر خواهید دید که بایک تابع توکار براحتی می‌توانید این محتویات را به پروژه‌ الحاق و از آنها استفاده کنید.

Views صفحات بصری که به نوعی با کاربر در ارتباط است شامل صفحات مربوط به طرح‌بندی، عناصر، خطا‌ها، راهنماها در اینجا قرار می‌گیرند.

Webroot در نهایت این فولدر در نصب برنامه می‌بایستی به عنوان root (شاخه اصلی) پروژه بکار گرفته شود. همچنین این فولدر فایل‌های مربوط به CSS، تصاویر و جاوااسکریپت را در بر خواهد داشت.

به فولدر اصلی بر‌میگردیم. دو فولدر cake و vendors هسته این فریم‌ورک را تشکیل می‌دهند و همین اندازه آشنایی با این دو فولدر برای کار با این فریم‌ورک کافی است (اگر مشتاقید به جمع توسعه دهندگان این فریم‌ورک بپوندید مستندات کیک درمورد توابع و کلاس‌های سازنده هسته کاملاً روشن است)

هر چند توضیحات ساختاری فایل‌ها و فولدرها می توانست بیش از این به تفصیل بیان شود اما بعلت کمبود وقت و دورشدن از هدف اصلی از آنها عبور می‌کنیم .

تنظیمات و مراحل ساخت لینکدونی

یک فولدر بنام cake در وب سرور می‌سازیم و محتویات کیک‌پی‌اچ‌پی را به آن منتقل می‌کنیم. در مرورگر آدرس دایرکتوری که فایل‌های پروژه در آن قرار دارد به صورت زیر خواهد بود:

CakePHP Base Address

اگر وب سرور را اجرا کرده باشید پس از ارسال درخواست صفحه‌‌ی خوش آمد کیک را مشاهده خواهید نمود. چنانچه چیدمان مطالب موجود آرایش منظمی ندارد (صفحه فاقد تصویر و استایل است)، احتمالاً mod rewrite سرور فعال نیست. بدین منظور فایل httpd.conf وب سرور آپاچی را با یک ویرایشگر متن با کرده و بدنبال خط زیر بگردید و با حذف علامت # از ابتدای خط، mod_rewrite.so را به ماژول‌های وب سرور اضافه کنید. حال وب سرور را ریستارت کنید و صفحه را ریفرش کنید مشکل باید حل شده باشد.

  1. #LoadModule rewrite_module modules/mod_rewrite.so

برای اجرای صحیح کیک بطور پیشفرض، تاکید بر این است که mod rewrite سرور فعال باشد اما چنانچه بنا به دلایلی نخواستید این ماژول را به وب سرور اضافه کنید، می‌بایستی تمامی فایل‌های htaccess را از فولدرهای کیک حذف کنید و در فایل app/config/core.php با حذف علامت کامنت (//) از ابتدای خط زیر، کیک را بدون mod rewrite اجرا کنید:

  1. Configure::write('App.baseUrl', env('SCRIPT_NAME'));

برای اولین مرتبه که کیک راه‌اندازی می‌شود، در صفحه اصلی هشدارهایی را خواهید دید. در نسخه 1.2 کیک، استایل بکار رفته با رنگ‌های زرد و سبز، کاربر را راهنمایی می‌کند. ابتدا فایل app/config/core.php را باز کنید. Security.salt را پیدا کنید و آن را به دلخواه تغییر دهید (می توانید دو سه کاراکتر آن رشته را تغییر دهید) این یک رشته تصادفی است که کیک برای رمزنگاری از آن استفاده می‌کند تا هنگامی که مقدار پیشفرض آن را تغییر ندهید خطای زرد رنگ مبنی بر تغییر آن در صفحه اصلی وجود خواهد داشت.

CakePHP Welcome Page

خطای زرد رنگ دیگری که در این صفحه خواهید دید مربوط به تنظیمات پایگاه داده است. بمنظور رفع آن فایل app/config/ database.php.default را به database.php تغییر نام دهید. پایگاه‌ داده‌ای بنام linkdump درMySQL بسازید و بمنظور ارتباط پایگاه داده به کیک فایل database.php را باز کنید و آرایه default را با آنچه قبلاً در نصب پایگاه داده وارد کرده‌اید تنظیم کنید:

  1. var $default = array(
  2. 'driver' => 'mysql',
  3. 'persistent' => false,
  4. 'host' => 'localhost',
  5. 'login' => 'root',
  6. 'password' => 'nbuser',
  7. 'database' => 'linkdump',
  8. 'prefix' => '',
  9. );

خطای دیگری که ممکن است موجود باشد مربوط به فولدر app\tmp است. قبلاً گفتیم که tmp برای ذخیره‌ی فایل‌های موقتی نظیر ثبت وقایع و نشست‌ها استفاده می‌شود از این رو می‌بایستی مجوز آن را طوری تعیین کنید که قابلیت نوشتن در فولدر فعال باشد. در صورتی که موارد فوق را درست انجام داده باشید صفحه‌ی اصلی کیک به صورت زیر خواهد بود:

CakePHP Welcome Page

در پست بعدی سایر مراحل را دنبال خواهیم کرد.
ادامه: ساخت لینکدونی با CakePHP (بخش دوم) و (بخش سوم)

]]> http://weblog.alvanweb.com/2008/10/22/create-linkdump-with-cakephp-part-1/feed/ http://api.feedburner.com/awareness/1.0/GetItemData?uri=alvanweb&itemurl=http%3A%2F%2Fweblog.alvanweb.com%2F2008%2F10%2F22%2Fcreate-linkdump-with-cakephp-part-1%2Fhttp://weblog.alvanweb.com/2008/10/22/create-linkdump-with-cakephp-part-1/ مقدمه‌ای بر معماری MVC در CakePHP http://feeds.feedburner.com/~r/alvanweb/~3/398934725/ http://weblog.alvanweb.com/2008/09/21/mvc-architecture-in-cakephp/#comments Sun, 21 Sep 2008 14:17:59 +0000 مرتضی الوانی http://weblog.alvanweb.com/?p=154 همانطور که در پست قبل گقتم