ثابت ROOT باید حاوی آدرس پوشه ای باشه که در برگیرنده برنامه ما هست .

ثابت APP_DIR تعیین کننده نام پوشه برنامه ما هست که به صورت پیش فرض این پوشه app نام داره و می تونیم تغییرش بدیم.

ثابت CAKE_CORE_INCLUDE_PATH هم باید شامل آدرس پوشه در برگیرنده هسته کیک باشه .

به عنوان مثال فرض کنید نام پوشه برنامه ای که نوشتیم ، webnevis_app هست و ما این پوشه رو در آدرس  home/payam/webnevis.net/adsmarket.ir/private قرار دادیم و همچنین هسته کیک (پوشه lib) رو هم در همین آدرس قرار دادیم بنابراین مقادیر این سه ثابت به شکل زیر خواهد بود :

if (!defined('ROOT')) {
	define('ROOT', '/home/payam/domains/webnevis.net/private');
}

if (!defined('APP_DIR')) {
	define('APP_DIR', 'webnevis_app');
}

define('CAKE_CORE_INCLUDE_PATH', '/home/payam/domains/webnevis.net/private/lib');

این روشی که با هم بررسی کردیم یکی از روش های نصب کیک هست ، برای اطلاعات بیشتر می تونید این لینک رو مطالعه کنید.

مهم ترین نکته ای که باید به ان توجه داشت این هست که در تنظیمات کیک،که در آدرس Core/config.php قرار دارد ، مقدار debug برابر با ۲ باشد تا تمام خطاها و اشکالات برنامه ، کوئری هایی که اجرا می شوند و همچنین خروجی های توابع و کلاس های مربوط به debugging به صورت کامل هنگام اجرای برنامه به ما نمایش داده شود و cache های ایجاد شده رفرش گردند.

 Configure::write('debug', 2);

به این ویژگی دو مقدار ۰ و ۱ هم می توانیم اختصاص دهیم که مقدار ۱ مانند همان حالت مقدار ۲ هست اما محدودیتهایی دارد و مقدار ۰ برای زمانیست که برنامه ما به صورت کامل نوشته و تست شده و آماده ارائه به کاربران می باشد.

تابع debug
اولین و ساده ترین تابعی که کیک در اختیار ما قرار داده ، تابع debug هست ، که یک تابع سراسریست و در بخش های مختلف برنامه برای نمایش مقادیر متغیرها می توانیم از آن استفاده کنیم . prototype و یا امضای این تابع به صورت زیر هست :

debug(mixed $var, boolean $showHtml = null, $showFrom = true)

اولین پارامتر این تابع ، متغیری هست که قصد بررسی آن را داریم .
پارامتر showHtml به صورت boolean هست و به صورت پیش فرض مقدار true را دارد،اگر کدهای html در متغیر وجود داشته باشد به جای اجرا ، نمایش داده می شود و پارامتر سوم نیز که به صورت پیش فرض true ست نام فایل و خطی که تابع debug را فراخوانی کرده،در خروجی نمایش می دهد .

کلاس Debugger

کلاس کاربردی و مفیدی هست که از نسخه ۱٫۲ به بعد تعریف شده و متدهای مختلفی برای ارزیابی کدهایی که نوشتیم در اختیارمان قرار می دهد، که در زیر برخی از کاربردی ترین آنها را بررسی میکنیم.همچنین متدهای این کلاس به صورت استاتیک هستند و نیازی به نمونه سازی از کلاس نیست و به صورت زیر قابل دسترس هستند :

 Debugger::methodName();

- متد dump
متغیری که به عنوان وررودی دریافت کرده است ، خیلی حرفه ای تر و واضح تر نسبت به تابع debug برایمان تشریح می کند .

//simple array
$arr=array(1,2,3);
Debugger::dump($arr);

//outputs
array(
	(int) 0 => (int) 1,
	(int) 1 => (int) 2,
	(int) 2 => (int) 3
)

- متد log
این متد تقریبا شبیه به متد dump هست اما با این تفاوت که خروجی خودش را به همراه یک سری اطلاعات مانند تاریخ و زمان اجرا ، stack trace اجرای برنامه تا خط مربوط به فراخوانی این متد را در شاخه tmp/logs در یک فایل متنی به نام debug ذخیره می کند . برای اجرای صحیح این متد دایرکتوری tmp/logs باید writable باشد .

- متد trace
با فراخوانی این متد در هر بخش از کدهای برنامه stack trace برنامه بازگردانده می شوده که می توانیم با استفاده از تابع print_r خود پی اچ پی و یا تابع pr که کیک برای چاپ آرایه ها به صورت خواناتر در اختیارمان قرار داده ، آن را در خروجی چاپ کنیم .

pr(Debugger::trace());

//outputs
PostsController::index() - APP/Controller/DownloadsController.php, line 48
Dispatcher::_invoke() - CORE/lib/Cake/Routing/Dispatcher.php, line 265
Dispatcher::dispatch() - CORE/lib/Cake/Routing/Dispatcher.php, line 237
[main] - APP/webroot/index.php, line 84

- متد getType
این متد همانطور که از نامش پیداست نوع (type) متغیری که به آن پاس داده شده را بر می گرداند و در صورتی که یک شی (object) به عنوان ورودی به آن داده شود نام کلاس آن شی رادر اختیارمان قرار می دهد .

- متد excerpt
گاهی وقت ها شاید نیازمند این باشید که بخشی از کدهای هسته کیک را ببینید تا روند اجرای کدها را بهتر درک کنید . با استفاده از این متد می توان بخشی از کدهای یک فایل از هسته کیک را استخراج و بررسی کرد .

Debugger::excerpt($file, $line, $context)

اولین وردی آدرس فایلی است که قصد داریم بخشی از کدهای آن را بررسی کینم
دومین ورودی شماره خط شروع
و سومین پارامتر تعداد خطهایی که قصد داریم بازگردانده شوند (از صفر شروع می شود و نتیجه به صورت آرایه بازگردانده می شود)

pr(Debugger::excerpt(ROOT . DS . 'index.php', 1, 7));

برای اطلاعات بیشتر و مشاهده مثال های کاملتر در مورد این کلاس می توانید اینجا را مطالعه نمایید.

کلاس CakeLog

log کردن یکی از روش های مرسوم برای خطایابی و اشکال زدایی برنامه هست ، در کیک برای این منظور کلاس CakeLog در نظر گرفته شده که در ابتدا باید این کلاس را در برنامه بارگذاری و سپس با استفاده از متد write اقدام به نوشتن log مورد نظرمان کنیم .

//Config/bootstrap.php
App::uses('CakeLog', 'Log');

//Anywhere in your application
CakeLog::write('debug', 'successfully!!');

توجه داشته باشید که در ابتدای اجرای کیک فایل bootstarp.php اجرا می شود بنابراین محل مناسبی برای بارگذاری کلاس cakeLog هست تا در هر نقطه از برنامه بتوانیم از این کلاس استفاده کنیم همچنین همانطور که فبلا اشاره کردم فایل debug در شاخه tmp/logs قرار دارد .

Debug Kit

debug kit پلاگینی بی نظیر و حرفه ای برای اشکال زدایی application مان هست  و به نظرم باید ابزار همیشگی یک آشپز کیک پی اچ پی باشد .
این پلاگین اطلاعات سودمند و مفیدی همچون لیست کوئری های اجرا شده ، لیست request ها ، sesssion های ثبت شده ، لیست متغیرهای پاس داده شده به view و … در دسترس برنامه نویس قرار میدهد که مطئنا برای یک توسعه دهنده مفید خواهد بود .
از طریق لینک https://github.com/cakephp/debug_kit قابل دسترس هست.
برای نصب مراحل زیر را دنبال کنید :
- پس از دانلود ، پلاگین رو از حالت فشرده در بیارید و به DebugKit تغییر نام بدید.
- پلاگین رو به پوشه Plugin در برنامه تان منتقل کنید.
- در فایل bootstrap.php پلاگین را لود کنید .

CakePlugin::load('DebugKit');

- در فایل AppController.php به لیست کامپوننت ها toolbar پلاگین را اضافه کنید .

public $components = array('DebugKit.Toolbar');

- از داشتن یک تولبار حرفه ای در هنگام توسعه برنامه تان لذت ببرید … !

موفق و پیروز باشید …

منبع : http://book.cakephp.org/2.0/en/development/debugging.html

در ابتدای کار فرض می کنیم در model قوانین زیر رو تعریف کردیم :

class User extends AppModel{

	public $validate = array(
		'username'=>array(
			'rule-1'=>array(
				'rule'=>'notEmpty',
				'required'=>TRUE,
				'message'=>'لطفا نام کاربری خود را وارد کنید'
			),
			'rule-2'=>array(
				'rule'=>'isUnique',
				'message'=>'نام کاربری وارد شده تکراری است',
				'on'=>'create'
			),
		),
		'password'=>array(
			'rule'=>'notEmpty',
			'required'=>TRUE,
			'message'=>'لطفا رمزعبور خود را وارد کنید'
		),
	);

}

اضافه کردن قانون جدید :
برای اضافه کردن قانون جدید از متد add استفاده می کنیم

$this->validator()->add('password','rule-2',array(
		'rule'=>'alphaNumeric',
		'message'=>'رمزعبور تنها باید شامل حروف و اعداد باشد'	
));

همچنین می توانیم از روش method chaining استفاده کنیم و متد add رو چندین بار فراخوانی کنیم .

$this->validator()
	->add('password','rule-2',array(
		'rule'=>'alphaNumeric',
		'message'=>'رمزعبور تنها باید شامل حروف و اعداد باشد'
	))
	->add('password','rule-3',array(
		'rule'=>array('minLength',6)
		'message'=>'رمزعبور حداقل باید شامل ۶ کاراکتر باشد'
	));

به جای روش بالا می توانیم به صورت زیر هم عمل کنیم و قوانین جدید رو به صورت آرایه به عنوان پارامتر دوم به متد پاس بدیم

$this->validator()
	->add('password',array(
		'rule-2'=>array(
		'rule'=>'alphaNumeric',
		'message'=>'رمزعبور تنها باید شامل حروف و اعداد باشد'
		),
		'rule-3'=>array(
			'rule'=>array('minLength',6)
			'message'=>'رمزعبور حداقل باید شامل ۶ کاراکتر باشد'
		)
	));

ویرایش قوانین موجود :

برای مثال قانون rule-2 از فیلد password  رو می خواهیم ویرایش کنیم

$this->validator()->getField('password')->setRule('rule-2',array(
		'rule'=>'numeric',
		'message'=>'رمزعبور باید تنها شامل اعداد باشد'
	)
);

و برای تغییر تمامی قوانین تعریف شده برای یک فیلد با استفاده از متد setRules داریم :

$this->validator()->getField('password')->setRules(array(
		'required'=>array(
			'rule'=>'notEmpty',
			'required'=>TRUE,
			'message'=>'رمزعبور خود را وارد کنید'
		),
		'length'=>array(
			'rule'=>array('between',6,12),
			'message'=>'رمزعبور باید شامل حداقل ۶ و حداکثر ۱۲ کاراکتر باشد'
		)
	)
);

همچنین اگر فقط بخوایم یک بخش از قانون تعریف شده رو تغییر بدیم :

$this->validator()->getField('password')->getRule('length')->message='رمزعبور وارد شده معتبر نیست';

حذف قوانین :

قطعه کد زیر قوانین تعریف شده برای فیلد password رو به طور کلی پاک میکنه .

$this->validator()->remove('password');

و کد زیر قانون length رو از بین قوانین تعریف شده برای فیلد password حذف میکنه

$this->validator()->remove('password','length');

اگر از کنترلر بخواهیم به این متد دسترسی داشته باشیم،برای مثال در کدهایی که توی این پست تعریف کردیم،به شکل زیر عمل می کنیم

$this->User->validator()->remove('password','length');

//other sample
$this->User->validator()->getField('password')->setRules(array(
		'required'=>array(
			'rule'=>'notEmpty',
			'required'=>TRUE,
			'message'=>'رمزعبور خود را وارد کنید'
		)
	)
);

امیدوارم این پست مفید بوده باشه ، موفق باشید .

لینک دانلود

امیدوارم که مفید باشه

برای ایجاد یک فایل element در کیک پی اچ پی وارد پوشه elements از بخش views شوید و یک فایل با نام دلخواه و پسوند ctp. ایجاد کنید سپس کدهای مد نظرتان را داخل آن وارد کنید ، برای نمایش element مورد نظرتان در سایر فایلهای بخش view هم از دستور زیر استفاده کنید :

echo $this->element('element_name');

برای آشنایی بیشتر با این بخش یک element ایجاد می کنیم که آخرین مطالب موجود در پایگاه داده را نمایش دهد.

در مرحله اول یک متد در کنترلر مربوط به مطالب تعریف می کنیم که آخرین مطالب را به ما برگرداند

class PostsController extends AppController
{

	var $name='Posts';

	function index()
	{
		$posts=$this->Post->find('all',array('limit'=>10));
		if(isset($this->params['requested']))
		{
			return $posts;
		}
		else
		{
			$this->set('posts',$posts);
		}
	}

}

در اینجا متد index از کنترلر posts رو به شکلی تعریف کردیم که وقتی با استفاده از متد requestAction این متد رو درخواست کردیم مطالب خوانده شده از دیتابیس return شود تا در فایل مربوط به element بتوانیم مورد استفاده قرار دهیم.

حالا در مسیر views/elements یک فایل با نام last_posts.ctp ایجاد کنید و کدهای زیر را داخل آن وارد کنید

Last Posts

<?php

$posts=$this->requestAction('posts/index');

if(is_array($posts)) :

?>


		<?php foreach($posts as $post) : ?>
		
<?php echo $this->Html->link($post['Post']['title'],array('controller'=>'posts','action'=>'view',$post['Post']['id'])); ?>
		<?php endforeach; ?>
		

<?php endif; ?>

حالا هر جا که می خواهید این element رو نمایش بدید از دستور زیر استفاده کنید

echo $this->element('last_posts');

موفق باشید