آموزش اسمارتي از مبتدي تا حرفه اي

[amir-haghighi]

به ياد او::

با توجه به سوالاتي كه بعضي از دوستان انجام داده بودند و با توجه به اينكه در بعضي از سوالات ديدم كه كاربران محترم نياز مبرم به آشنايي با يك موتور قالب قدرتمند و كامل براي php رو دارند تصميم گرفتم كه يك مقاله خوب و جامع در مورد اسمارتي رو براي دوستان عزيز آماده كنم.

از اونجايي كه قبلا در بعضي از سايتها در مورد اسمارتي مقالاتي مطرح شده بود كه نسبتا هم كامل بودند من تصميم گرفتم كه ديگه خودم مقاله رو از 0 ننويسم و مقاله همون دوستان رو با كمي تغييرات ارائه كنم.

اما دوستان منتظر روشها و ترفند هاي جالبي از اسمارتي باشند كه فكر كنم من اولين نفري هستم كه در انجمنهاي ايراني اونها رو مطرح ميكنه.

اسمارتی یه کلاس Php هست که برای مدیریت کدهای استفاده شده در وب سایت بکار میره و موجب میشه که براحتی اجزاء سایت رو ویرایش کنیم برام خیلی مهم و جذاب بود بطور مثال شما درنظر بگیرید یه مطلبی که بصورت خبر در یک سایت منتظر شده چطور میتواند تیتر خبر / تاریخ انتشار خبر / نویسنده خبر / متن خبر را بصورت قالبمند نمایش دهد !؟ برای تحقق به این آرمان اسمارتی این امکان را میدهد که تمپلیتی قابل ویرایش و قابل استفاده در تگ های HTML طراحی کنیم ! با این اوصاف دیگه هم Programer و هم Designer در صورت نیاز چنانچه تمایل به دست بردن در ظاهر و یا کدهای سیستم داشته باشند بدون دخالت در حیطه کاری هم میتونند کار خودشون رو بدون هیچ مشکلی انجام دهند

خوب این یک مقدمه بود که فکر میکنم بصورت ساده و سلیس توضیح دادم بهتره حالا بریم سر اصل مطلب و برای بیان اون بهتره یه مقدار کتابی تر و رسمی تر صحبت کنیم

------------------------------
برای شروع اسمارتی بهتر است با سایت این موتور تمپلیت اشنا بشویم برای دسترسی به این کلاس و دریافت اخرین نسخه میتوانید از آدرس اینترنتی www.smarty.net جدیدترین پکیج که شامل اخرین تغییرات نیز میباشد دریافت کنید
Template Engine های فراوانی برای Php موجود هست که میتوان اسمارتی یکی از برترین های آنها دانست Smarty از Php و Zend Engine بهره میگیرد و برنامه ها را با کمترین زمان ممکن اجرا میکند چون اسمارتی یکبار الگو را کامپایل میکند تا زمانی که الگو تغییری حاصل نکند دیگر نیاز به کامپایل ان ندارد اط طرفی همانطور که در ادامه بطور مفصل عرض خواهم کرد Smarty از Caching به نحو احسنت بهره گرفته است


باید توجه داشت که Smarty بصورت شیءگرا طراحی شده و عمل میکند که برای استفاده از آن میبایست یک Instance از آن ایجاد کرد که نمونه آن در زیر آورده شده است

 <?php

require_once('Smarty.class.php'); // use absolute path here, if necessary

$smarty = new Smarty;

?>  

اسمارتی درون شاخه ای که فراخوانی میشود اما بدلیل موارد امنیتی الگو ها نباید درون شاخه هایی که از طریق وب قابل دسترسی میباشند جاگذاری شوند از این جهت برای معرفی مسیر Smarty بدین شکل عمل میکنیم

$smarty->template_dir = '/var/www/templates/app1/template/';

$smarty->compile_dir = '/var/www/templates/app1/compile/';

$smarty->config_dir = '/var/www/templates/app1/config/';

$smarty->cache_dir = '/var/www/templates/app1/cache/'; 

شاخه Template مسیری است که اسمارتی درون آن بدنبال فایل های tpl. میگردد (منظور فایل های مربوط به ساختار تمپلیت میباشد)
شاخه Compileمسیری است که اسمارتی درون آن الگوهای کامپایل شده را ذخیره میکند
شاخه Config مسیری است که اسمارتی درون آن بدنبال فایل های تنظیمات میگردد
شاخه Cache مسیری است که اسمارتی درون آن فایل های Cache شده خود را ذخیره میکند

روش دیگری نیز روشی دیگر جهت معرفی این متغییرها وجود دارد که روش ارث بری نامیده میشود که بصورت زی میتوانید عمل کنید.

 <?php

// require the Smarty class

require_once('Smarty.class.php');

// extend the Smarty class

class my_Smarty extends Smarty {

function my_Smarty() {

// create the Smarty object

$this->Smarty();

// set Smarty folders

$this->template_dir = '/var/www/templates/app1/template/';

$this->compile_dir = '/var/www/templates/app1/compile/';

$this->config_dir = '/var/www/templates/app1/config/';

$this->cache_dir = '/var/www/templates/app1/cache/';

// set other Smarty options

$this->use_sub_dirs = false;

}

}

?>  

خصوصیات اسمارتی Smarty


1- دارای سرعت زیاد میباشد
2- تا زمانی که در PHP خطایی رخ نداده باشد، مفید بود و بدون مشکل کار میکند.
3- فقط یکبار کامپایل می شود.
4- فقط فایلهایی را که تغییر کرده اند را دوباره کامپایل می نماید.
5- شما می توانید توابع سفارشی و یا متغیرهای ویرایشگر استفاده کنید، بنابراین قالبها قالب انعطاف پذیری پیدا می کنند.
6- قالب ها با استفاده از تگهای حائل (delimiter tag) یعنی {} ، {{}} ، <—{}--!> قابل پیکربندی می باشند.
7- ساختارهای if/elseif/else/endif در عبارات PHP گذاشته می شوند، یعنی عبارت {if …} می تواند ساده و یا پیچیده باشد.
8- اجازه استفاده بخش ها مثل if ها و غیره را بصورت نامحدود تودرتو وجود دارد.
9- می توان کدهای PHP را در فایلهای Template درون سازی نمود، اگر چه توصیه نمیشود
10- امکان ساپورت Caching که یکی از بزرگترین و بهترین قابلیت های اسمارتی محسوب میشود

* توجه : برای استفاده از اسمارتی به Php 4.0.6 به بالا نیاز است.

[tanha2007]

سلام.
اگر لطف نمایید یک مثال ساده را نیز بیان دارید ...

[ravandi]

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

[Bahram0110]

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

include ("Smarty/libs/Smarty.class.php");

[amir-haghighi]

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

خوب دوست عزیز شما باید اسمارتی رو دانلود کنید و به برنامه خودتون اظافه کنید.یعنی اینکه ابتدا باید کدها رو در برنامه خودتون در یک مسیر خاص قرار بدید و در نهایت هم اونها رو توسط include و یا require به کد اصلی خودتون اظافه کنید.بعد باید یک نمونه از اسمارتی رو بسازید و ادامه ماجرا ...

[tanha2007]

سلام.
خوب اگر میشه یک مثال را کار توضیح دهید، تا بشه اون را کاملا فهمید که چیست ....

[vahid4134]

smarty خودت منوال کاملی داره ها
http://www.smarty.net/manual/en/

[amir-haghighi]

همانطور که قبلا اشاره کرده بودیم Cache در اسمارتی نکته بسیار مهمی محسوب شده بگونه ای که پس از یکبار فراخوانی تمپلیت در موارد بعدی نیازی به فراخوانی مجدد و متقابلا خواندن از دتابیس و Feed های مختلف نیست در واقع این عملکرد خارق العاده اسمارتی میباشد که موجب افزایش سرعت آن میشود
بطوریکه میبیندی در بخش خصوصیات بدین صورت ذکر شده It is extremely fast یعنی بشدت سریع که نشان دهنده این امر میباشد

1. شروع Caching در اسمارتی


بطور کلی استفاده از قابلیت Cacheدر اسمارتی باعث ، ایجاد تغیرات در صدا زدن display() وfetch() میشود که این دو تابع بیشتر کاربرد را در اسمارتی دارند که تابع اول برای نمایش فایل تمپلیت و تابع دوم برای خواند دیتابیس مورد استفاده قرار میگیرد.زمانی که خروجی توابع display() یا fetch() کش میشود ، فایل Cache شده در دایرکتوری $cache_dir ایجاد میشود ، این فایل میتواند یک فایل تمپلیت ، Config و ... را در بر بگیرد.


2. تنظیمات Caching

اولین کار فعال کردن قابلیت Caching در اسمارتی است ، اینکار با مقداردهی متغیر $caching انجام میشود.

 <?php

require('Smarty.class.php');

$smarty = new Smarty;



$smarty->caching = true;



$smarty->display('index.tpl');

?>  

در حالت معمولی تابع display(‘index.tpl’) هنگام صدا زدن ، فایل تمپلیت را رندر میکند و نتیجه را بصورت خروجی نمایش میدهد ، اما زمانی که شما Caching را فعال میکنید ، این تابع به هنگام رندر کردن فایل تمپیلیت ، یک کپی از انرا بصورت کپی Cache شده ، ذخیره میکند ، زمانی که دوباره تابع display(‘index.tpl’) صدا زده شود ، فایل Cache شده ، بصورت خروجی نمایش داده میشود و نیاز دوباره به رندر فایل تمپلیت نخواهد بود ، و این یعنی افزایش سرعت و کاهش بار بر روی سرور !

نکته : فایل های موجود در دایرکتوری $cache_dir نام های شبیه فایلهای تمپلیت اصلی دارند، اما با این تفاوت که دارای پسوند .php هستند ، اما این فایل های اسکریپتهای قابل اجرا (executable php scripts) نیستند ، دقت کنید که این فایل ها را ویرایش نکنید.

تمام صفحاتی که Cache میشوند ، دارای طول عمر مشخصی خواهند بود ، این زمان توسط متغیر $cache_lifetime مشخص میشوند ، مقدار پیشفرض این تابع ، 3600 ثانیه ، برابر 1 ساعت ، هست ، و پس از گذشت این زمان ، فایل های Cache غیر قابل استفاده میشوند و دراولین بار صدا زدن تابع display() با فایل های جدید رندر شده جایگزین میشوند.

امکان این که شما به هر صفحه طول عمر مشخصی بدهید نیز وجود دارد ، اینکار با با نسبت دادن مقدار 2 به متغیر $caching انجام میشود

<?php

require('Smarty.class.php');

$smarty = new Smarty;



$smarty->caching = 2; // lifetime is per cache



// set the cache_lifetime for index.tpl to 5 minutes

$smarty->cache_lifetime = 300;

$smarty->display('index.tpl');



// set the cache_lifetime for home.tpl to 1 hour

$smarty->cache_lifetime = 3600;

$smarty->display('home.tpl');



// NOTE: the following $cache_lifetime setting will not work when $caching = 2.

// The cache lifetime for home.tpl has already been set

// to 1 hour, and will no longer respect the value of $cache_lifetime.

// The home.tpl cache will still expire after 1 hour.

$smarty->cache_lifetime = 30; // 30 seconds

$smarty->display('home.tpl');

?>

اگر $compile_chek فعال باشد ، در هر بار اجرا شدن صفحات ، ابتدا اخرین زمان ایجاد Cache File چک شده و اگر از آن زمان به بعد تغییر دیگری در فایل تمپیلیت بوجود امده باشد ، فایل های Cache شده ی قبلی با فایل های جدید جایگزین میشود ، اینکار overhead کمی را ایجاد میکند که این مقدار ، بسیار ناچیز است و مشکلی ایجاد نمیکنید اما گر نیاز به بالاترین performance دارید باید ، برای دستیابی به بهترین performance مقدار $compile_chek را بصورت false تنظیم کنید.

متغیر $force_complie زمانی تنظیم میگردد که شما در حال ، تست و رفع خطا ( debugging ) باشید ، در این صورت ، در هر بار اجرا شدن صفحات ، فایل Cache جدید ایجاد میشود ، زیرا دراین زمان شما در پی رفع اشکلات و خطا هستید و با تغیر سورس برنامه ، تغیرات را نمیتوانید مشاهده کنید زیرا ، فایل های Cache شده ی قبلی نمایش داده میشوند ، راه دیگر این است که متغیر $caching را با مقدار false تنظیم کنید.

از تابع is_cheked() میتوانید برای فهمیدن اینکه ، تمپلیت مورد نظر در حال حاضر دارای فایل Cache معتبر هست یا خیر استفاده کنید ، و در صورتی که فایل Cache مورد نیاز موجود بود ، از ادامه عملیات رندر تمپیلیت و به دنبال دریافت اطلاعات و پردازش آنها ، جلوگیری کنید.

 <?php

require('Smarty.class.php');

$smarty = new Smarty;



$smarty->caching = true;



if(!$smarty->is_cached('index.tpl')) {

    // No cache available, do variable assignments here.

    $contents = get_database_contents();

    $smarty->assign($contents);

}



$smarty->display('index.tpl');

?>  

شما میتوانید قسمت هایی از صفحه خود را ، بصورت کاملا Daynamic نگه داشته و بقیه قسمت هارا Cache کنید ، اینکار با استفاده از تابع insert در Smarty Engine قابل انجام است ، برای مثال ، فرض کنید که در سمت راست صفحه خود یک بنر دارید که در هر بار اجرا شدن صفحه ، بنر متفاوتی را نمایش میدهد ( مثل همین بنر بالای همین صفحه مجید آنلاین ) ،در صورتی که تمام قسمتهای این صفحه Cache شود ، در هر بار اجرا شدن صفحه تنها همان بنری که در زمان Cache شدن موجود بوده ، نمایش داده میشود ، و نتایج متفاوت ظاهر نخواهد شد ، با استفاده از تابع insert شما میتوانید قسمتهای متخلفی از صفحه را از Cache شدن ، محفوظ نگه دارید و آنها را بصورت کاملا Daynamic نمایش دهید.

در صورتی که $compile_chek بصورت False تنظیم شده باشد ، پس چگونه میتوان ، در زمان تغیرات در فایل ها ، Cache جدید را جایگزین Cache های قبلی کرد ؟

فرض کنید که صفحه اصلی وبلاگ خود را Cache کردید ( یا بصورت Full Cache ، یا بصورت چند قسمتی . . . ) ، حال زمانی که شما یک مطلب جدید را وارد بانک اطلاعاتی میکنید ، با استفاده از توابع clear_all_cache() تمام فایل های Cache موجود را پاک کرده و یا با تابع clear_cache() تنها فایل های Cache قبلی را پاک کرده و تغیرات را جایگزین کند .

 <?php

require('Smarty.class.php');

$smarty = new Smarty;



$smarty->caching = true;



// clear out all cache files

$smarty->clear_all_cache();



// clear only cache for index.tpl

$smarty->clear_cache('index.tpl');



$smarty->display('index.tpl');

?>  

[reza699]

بسیار جالب ممنون میشم بحث رو ادامه بدید.

[a_bita]

سلام . تا اینجا که خوندم جالب بود.
من خودم یک کتاب اموزش اسمارتی گرفتم . اما هروقت میام بازش میکنم یه خورده سخت به نظر م میاد، میذارم واسه بعد.الان 4 ماهه این بعد هنوز نیومده.
اگه اینطوری بچه ها با هم شروع به تمرین و کار بکنن فکر کنم بهتر میشه تنبلی رو دور کرد.من خودم که کار با جمع بیشتر منو ترغیب به ادامه کار میکنه.
من بیشتر روزا انلاینم. tablighk@yahoo.com
فقط همکاری و تمرین.خودمم هنوز اماتورم.اما هی یه چیزایی بلدم

[saeid99]

اگه یه مثال ساده بزاری خوبه..
مثلا در فایل html به جای {title} عنوان سایت رو از دیتابیس بخونیم و به روش اسمارتی جایگزین کنیم ؟!!

[vimax65]

سلام
من پلاگين تقويم شمسي براي اسمارتي رو دانلود كردم
اما نميدونم چه جوري ميشه استفاده كرد!
مثلا تيكه كد من اينه:

{$datetime->cdate("`$setting.setting_dateformat`", $datetime->timezone("`$owner->user_info.user_signupdate`", $global_timezone))}

چطوري مي تونم فارسيش كنم؟

[binboy]

سلام
آیا برای استفاده اسمارتی در لوکال (زمپ، ویندوز) باید آن را نصب کرد؟
مقاله مرتبط و توضیح که راجب نصب روی xampp و wamp داده.
http://memohnish.wordpress.com/2009/...amp-and-xampp/
حالا اگر باید نصب کرد برای بردن و انتقالش روی سرور اصلی باید کار خاصی انجام داد یا فقط آپدیت کدهاست؟
با تشکر

[ravand]

خوب ميشد اين بحث كامل ميشد. اينكه چجوري با اسمارتي مطلبي رو توي قسمت ارسال مطلب يا عنوان مطلب چاپ كنيم؟