Manual Smarty

olehMonte Ohrt dan Andrei Zmievski

Manual Smarty

Diterbitkan 07-09-2007 Hak Cipta 2001-2005 New Digital Group, Inc.

Daftar IsiKata Pengantar .................................................................................................................................... vi I. Memulai ........................................................................................................................................... 1 1. Apa itu Smarty? ........................................................................................................................ 2 2. Instalasi ................................................................................................................................... 4 Persyaratan .......................................................................................................................... 4 Instalasi Dasar ...................................................................................................................... 4 Extended Setup ..................................................................................................................... 7 II. Smarty Untuk Desainer Template ......................................................................................................... 9 3. Sintaks Dasar .......................................................................................................................... 11 Komentar .......................................................................................................................... 11 Variabel ............................................................................................................................ 12 Fungsi ............................................................................................................................... 13 Atribut .............................................................................................................................. 13 Menyertakan Vars dalam Tanda Kutip Ganda ........................................................................... 14 Matematika ........................................................................................................................ 14 Escaping Penguraian Smarty ................................................................................................. 15 4. Variabel ................................................................................................................................. 16 Variabel ditempatkan dari PHP .............................................................................................. 16 Variabel yang diambil dari file config ..................................................................................... 18 variabel terpakai {$smarty} ................................................................................................... 19 5. Pengubah Variabel ................................................................................................................... 22 capitalize ........................................................................................................................... 23 cat .................................................................................................................................... 24 count_characters ................................................................................................................. 24 count_paragraphs ................................................................................................................ 25 count_sentences .................................................................................................................. 25 count_words ...................................................................................................................... 26 date_format ........................................................................................................................ 26 default .............................................................................................................................. 29 escape ............................................................................................................................... 30 indent ............................................................................................................................... 31 lower ................................................................................................................................ 32 nl2br ................................................................................................................................. 32 regex_replace ..................................................................................................................... 33 replace .............................................................................................................................. 34 spacify .............................................................................................................................. 34 string_format ...................................................................................................................... 35 strip .................................................................................................................................. 35 strip_tags ........................................................................................................................... 36 truncate ............................................................................................................................. 37 upper ................................................................................................................................ 38 wordwrap .......................................................................................................................... 38 6. Menggabungkan Pengubah ........................................................................................................ 40 7. Fungsi Built-in ........................................................................................................................ 41 {capture} ........................................................................................................................... 41 {config_load} ..................................................................................................................... 42 {foreach},{foreachelse} ....................................................................................................... 44 {if},{elseif},{else} .............................................................................................................. 48 {include} ........................................................................................................................... 50 {include_php} .................................................................................................................... 52 {insert} ............................................................................................................................. 53 {ldelim},{rdelim} ............................................................................................................... 54 {literal} ............................................................................................................................. 55 iii

Manual Smarty

{php} ............................................................................................................................... 56 {section},{sectionelse} ........................................................................................................ 57 {strip} ............................................................................................................................... 66 8. Fungsi Kustom ........................................................................................................................ 67 {assign} ............................................................................................................................ 67 {counter} .......................................................................................................................... 68 {cycle} ............................................................................................................................. 69 {debug} ............................................................................................................................ 70 {eval} ............................................................................................................................... 70 {fetch} .............................................................................................................................. 72 {html_checkboxes} ............................................................................................................. 72 {html_image} ..................................................................................................................... 74 {html_options} ................................................................................................................... 75 {html_radios} ..................................................................................................................... 78 {html_select_date} .............................................................................................................. 80 {html_select_time} .............................................................................................................. 83 {html_table} ...................................................................................................................... 85 {mailto} ............................................................................................................................ 87 {math} .............................................................................................................................. 88 {popup} ............................................................................................................................ 90 {popup_init} ...................................................................................................................... 94 {textformat} ....................................................................................................................... 94 9. File Config ............................................................................................................................. 98 10. Konsole Debugging ................................................................................................................ 99 III. Smarty Untuk Pemrogram .............................................................................................................. 100 11. Konstan ............................................................................................................................... 102 SMARTY_DIR ................................................................................................................. 102 SMARTY_CORE_DIR ....................................................................................................... 102 12. Variabel Smarty Class ............................................................................................................ 103 $template_dir .................................................................................................................... 103 $compile_dir ..................................................................................................................... 103 $config_dir ....................................................................................................................... 104 $plugins_dir ...................................................................................................................... 104 $debugging ....................................................................................................................... 104 $debug_tpl ........................................................................................................................ 105 $debugging_ctrl ................................................................................................................. 105 $autoload_filters ................................................................................................................ 105 $compile_check ................................................................................................................. 105 $force_compile .................................................................................................................. 106 $caching ........................................................................................................................... 106 $cache_dir ........................................................................................................................ 106 $cache_lifetime ................................................................................................................. 106 $cache_handler_func .......................................................................................................... 107 $cache_modified_check ...................................................................................................... 107 $config_overwrite .............................................................................................................. 107 $config_booleanize ............................................................................................................ 108 $config_read_hidden .......................................................................................................... 108 $config_fix_newlines .......................................................................................................... 108 $default_template_handler_func ........................................................................................... 108 $php_handling ................................................................................................................... 108 $security .......................................................................................................................... 108 $secure_dir ....................................................................................................................... 109 $security_settings ............................................................................................................... 109 $trusted_dir ....................................................................................................................... 109 $left_delimiter ................................................................................................................... 109 $right_delimiter ................................................................................................................. 110 $compiler_class ................................................................................................................. 110 $request_vars_order ........................................................................................................... 110 iv

Manual Smarty

$request_use_auto_globals ................................................................................................... 110 $error_reporting ................................................................................................................. 110 $compile_id ...................................................................................................................... 110 $use_sub_dirs .................................................................................................................... 111 $default_modifiers ............................................................................................................. 111 $default_resource_type ....................................................................................................... 111 13. Smarty Class Methods() ......................................................................................................... 112 14. Caching ............................................................................................................................... 154 Menyiapkan Cache ............................................................................................................. 154 Multipel Caches Per Halaman ............................................................................................... 156 Grup Cache ....................................................................................................................... 157 Mengontrol Plugins ynd Bisa Di-cache' Output ........................................................................ 158 15. Fitur Lanjutan ....................................................................................................................... 160 Obyek .............................................................................................................................. 160 Prefilters .......................................................................................................................... 161 Postfilters ......................................................................................................................... 162 Filter Output ..................................................................................................................... 162 Fungsi Pengendali Cache ..................................................................................................... 163 Sumber daya ..................................................................................................................... 165 16. Memperluas Smarty Dengan Plugins ......................................................................................... 168 Bagaimana Plugin Bekerja ................................................................................................... 168 Konvensi Penamaan ........................................................................................................... 168 Menulis Plugin .................................................................................................................. 169 Fungsi Template ................................................................................................................ 170 Pengubah .......................................................................................................................... 171 Fungsi Blok ...................................................................................................................... 172 Fungsi Kompilator ............................................................................................................. 173 Prefilters/Postfilters ............................................................................................................ 174 Filter Output ..................................................................................................................... 175 Sumber daya ..................................................................................................................... 175 Inserts .............................................................................................................................. 177 IV. Apendiks ..................................................................................................................................... 178 17. Pemecahan masalah ............................................................................................................... 179 Kesalahan Smarty/PHP ....................................................................................................... 179 18. Tips & Trik .......................................................................................................................... 181 Penanganan Variabel Kosong ............................................................................................... 181 Menangani Variabel Default ................................................................................................. 181 Mengoper jugul variabel ke header template ............................................................................ 182 Dates ............................................................................................................................... 182 WAP/WML ...................................................................................................................... 183 Componentized Templates ................................................................................................... 184 Obfuscating E-mail Addresses .............................................................................................. 185 19. Sumber daya ........................................................................................................................ 186 20. BUGS ................................................................................................................................. 187

v

Kata PengantarTidak diragukan lagi salah satu pertanyaan yang paling sering diajukan pada milis PHP: bagaimana saya membuat naskah PHP independen terhadap tata letak? Sementara PHP dihitung sebagai "bahasa penaskahan melekat HTML", setelah menulis beberapa proyek yang mencampur PHP dan HTML secara bebas, datanglah satu ide yang memisahkan formulir dan isis adalah Good Thing [TM]. Sebagai tambahan, dalam banyak perusahaan aturan pendesain tata letak dan pemrogram adalah terpisah. Konsekuensinya, pencarian solusi templating terjadi kemudian. Dalam perusahaan kami contohnya, pengembangan aplikasi terjadi sebagai berikut: Setelah peryaratan dokumen selesai, pendesain interface membuat maket interface dan memberikannya ke pemrogram. Pemrogram mengimplementasikan logika bisnis dalam PHP dan menggunakan maket interface untuk membuat rangka template. Proyek kemudian diserahkan ke pendesain HTML/ata letak halaman web, orang tang membawa template sampai penuh dengan kemegahan. Proyek mungkin bolak-balik diantara pemrogram/HTML beberapa kali. Selanjutnya, adalah penting untuk mempunyai dukungan template karena pemrogram tidak ingin melakukan hal yang berkaitan dengan HTML dan tidan ingin pendesain HTML memaketkannya dengan kode PHP. Pendesain memerlukan dukungan untuk file konfigurasi, blok dinamis dan hal lain yang berkenaan dengan interface, tapi mereka tidak harus berhadapan dengan kerumitan bahasa pemrograman PHP. Melihat di banyaknya solusi template untuk PHP hari ini, kebanyakan darinya menyediakan cara yang belum sempurna atas penggantian variabel ke dalam template dan melakukan bentuk terbatas dari fungsionalitas blok dinamis. Tapi kebutuhan kita memerlukan sedikit lebih banyak dari itu. Kami tidak menginginkan pemrogram untuk berurusan dengan tata letak HTML SAMA SEKALI, tapi ini hampir tidak bisa dihindari. Sebagai contoh, jika pendesain menginginkan warna latar belakang untuk berubah pada blok dinamis, ini harus dikerjakan dengan pemrogram terlebih dulu. Kami juga membutuhkan pendesain untuk bisa menggunakan file konfigurasinya sendiri, dan menarik variabel darinya ke dalam template. Daftar terus bertambah. Kami mulai menulis spesifikasi untuk mesin template di akhir 1999. Setelah menyelesaikan spesifikasi, kami mulai bekerja pada mesin template yang ditulis dalam C yang dengan harapan dapat diterima untuk disertakan dengan PHP. Kami tidak hanya mengalami teknis yang kompleks, tapi juga ada debat panas mengenai apa yang harus dilakukan dan tidak oleh mesin template . Dari pengalaman ini, kami memutuskan bahwa mesin template harus ditulis dalam PHP sebagai kelas, agar setiap orang menggunakannya bila sesuai. Maka kami menulis mesin yang tidak hanya itu dan SmartTemplate memperlihatkan keberadaannya (catatan: kelas ini tidak pernah dikirimkan untuk umum). Ia adalah kelas yang mengerjakan hampir apapun yang kami inginkan: substitusi variabel reguler, didukung termasuk template lain, integrasi dengan file konfigurasi, melekatkan kode PHP, fungsionalitas pernyataan 'if' terbatas dan blok dinamis lebih stabil yang dapat diperbanyak secara berulang. Ia melakukan ini semua dengan ekspresi reguler dan kode diubah menjadi, harus kami katakan, bisa dipahami. Ia juga tercatat lambat dalam aplikasi besar dari semua penguraian dan ekspresi reguler mengerjakannya harus melakukannya untuk setiap permintaan. Masalah terbesar dari sudut pandang pemrogram adalah semua pekerjaan yang perlu dalam naskah PHP untuk menyiapkan dan memproses template dan blok dimasis. Bagaimana kami membuat ini lebih mudah? Lalu datanglah bayangan atas apa yang secara utama menjadi Smarty. Kami mengtahui seberapa cepat kode PHP tanpa melebihkan penguraian template. Kami juga mengetahui bagaimana teliti dan memaksanya bahasa PHP terlihat bagi umumnya pendesain, dan ini bisa diatasi dengan sintaks template yang lebih sederhana. Lalu bagaimana jika kami menggabungkan dua kekuatan? Selanjutnya, Smarty dilahirkan... :-)

vi

Bagian I. MemulaiDaftar Isi1. Apa itu Smarty? ................................................................................................................................ 2 2. Instalasi ........................................................................................................................................... 4 Persyaratan .......................................................................................................................... 4 Instalasi Dasar ...................................................................................................................... 4 Extended Setup ..................................................................................................................... 7

1

Bab 1. Apa itu Smarty?Smarty adalah mesin template untuk PHP. Lebih khusus, ia memfasilitasi cara yang bisa diatur untuk memisahkan logika aplikasi dan konten dari penampilannya. Ini jauh lebih baik dijelaskan dalam situasi di mana pemrogram aplikasi dan desainer template memainkan aturan yang berbeda, atau secara umum bukan orang yang sama. Sebagai contoh, katakanlah anda sedang membuat halaman web yang menampilkan artikel koran. Artikel $headline, $tagline, $author dan $body adalah elemen konten, tidak berisi informasi mengenai bagaimana akan ditampilkan. Ia akan dioper ke dalam Smarty oleh aplikasi. Kemudian desainer template mengedit template dan menggunakan kombinasi tag HTML dan tag template untuk membentuk presentasi terhadap variabel ini dengan elemen seperti tabel, div, warna latar belakang, ukuran font, style sheets, svg dll. Suatu hari pemrogram perlu mengubah cara konten artikel diambil (perubahan dalam logika aplikasi). Perubahan ini tidak mempengaruhi desainer template, konten masih akan muncul dalam template persis sama. Demikian juga jika desainer template ingin mendesain ulang template seutuhnya, ini tidak memerlukan perubahan logika aplikasi. Oleh karena itu, pemrogram dapat membuat perubahan terhadap logika aplikasi tanpa perlu merestrukturisasi template, dan desainer template bisa membuat perubahan terhadap template tanpa membongkar logika aplikasi.

Satu tujuan desain Smarty adalah pemisahan logika bisnis dan logika presentasi. Ini berarti template tentu saja dapat berisi logika di bawah kondisi yang hanya untuk presentasi saja. Hal seperti menyertakan template lain, memilih warna baris tabel, membesarkan huruf variabel, mengulang terus sebuah data array dan menampilkannya adalah contoh dari logika presentasi. Ini tidak berarti bahwa Smarty memaksa pemisahan logika bisnis dan presentasi. Smarty tidak mengetahui yang mana adalah yang mana, maka menempatkan logika bisnis dalam template adalah anda sendiri yang melakukannya. Juga, jika anda menginginkan tidak ada logika dalam template, anda tentunya dapat melakukannya dengan menetapkan konten cukup ke teks dan variabel saja.

Salah satu aspek unik mengenai Smarty adalah kompilasi template. Ini berartu Smarty membaca file template dan membuat naskah PHP darinya. Sekali dibuat, selanjutnya ia dieksekusi darinya. Oleh karenanya tidak ada beban menguraikan file template untuk setiap permintaan, dan setiap template dapat memanfaatkan solusi cache kompilator PHP seperti eAccelerator [http:/ / eaccelerator.net/ ], ionCube [http:/ / www.php-accelerator.co.uk] mmCache [http:/ / turckmmcache.sourceforge.net/] atau Zend Accelerator [http://www.zend.com/] adalah beberapa diantaranya. Beberapa fitur Smarty: Sangat cepat. Efisien karena pengurai PHP yang mengerjakan pekerjaan beratnya. Tidak ada kelebihan penguraian template, hanya sekali mengompilasi. Pintar mengenai rekompilasi hanya file template yang telah diubah. Anda dapat membuat dengan mudah fungsi kustom dan pengubah variabel, agar bahasa template bisa diperluas secara 2

Apa itu Smarty?

ekstrim. Template bisa mengkonfigurasi sintaks tag {pemisah}, agar anda dapat menggunakan {$foo}, {{$foo}},, dll.

Konstruksi {if}..{elseif}..{else}..{/if} dioper ke pengurai PHP, maka sintaks ekspresi {if...} bisa berupa evaluasi sesederhana atau serumit yang anda inginkan. Membolehkan pengulangan tidak terbatas dari sections, if's dll. Dimungkinkan untuk menyertakan kode PHP langsung dalam file template anda, meskipun ini mungkin tidak diperlukan (ataupun direkomendasikan) karena mesin dapat dikustomisasi. Dukungan built-in caching Bebas sumber template Fungsi kustom penanganan cache Arsitektur Plugin

3

Bab 2. InstalasiDaftar IsiPersyaratan .......................................................................................................................................... 4 Instalasi Dasar ...................................................................................................................................... 4 Extended Setup ..................................................................................................................................... 7

PersyaratanSmarty membutuhkan server web yang menjalankan PHP 4.0.6 atau lebih tinggi.

Instalasi DasarInstalasi file librari Smarty yang ada dalam sub direktori /libs/ dari distributsi. Ini adalah file .php yang TIDAK BOLEH diedit. Ia berbagi diantara seluruh aplikasi dan hanya diubah ketika anda meingkatkannya ke versi Smarty baru. Dalam contoh di bawah ini Smarty tarball telah diuraikan ke: /usr/local/lib/Smarty-v.e.r/ untuk mesin *nix

dan c:\webroot\libs\Smarty-v.e.r\ untuk lingkungan windows.

Teladan 2.1. File librari Smarty yang DiperlukanSmarty-v.e.r/ libs/ Smarty.class.php Smarty_Compiler.class.php Config_File.class.php debug.tpl internals/*.php (all of them) plugins/*.php (all of them)

Smarty menggunakan konstan [http://php.net/define] PHP bernama SMARTY_DIR yang merupakan path file sistem lengkap ke direktori libs/ Smarty. Pada dasarnya, jika aplikasi anda dapat menemukan file Smarty.class.php, anda tidak perlu menyetel SMARTY_DIR karena Smarty akan mengetahui dirinya sendiri. Oleh karena itu, jika Smarty.class.php tidak dalam include_path [http://php.net/ini.core.php#ini.include-path] anda, atau anda tidak menyertakan path absolut kepadanya dalam aplikasi anda, maka anda harus mendefinisikan SMARTY_DIR secara manual. SMARTY_DIR harus menyertakan akhiran garis miring/. Ini adalah bagaimana anda membuat turunan Smarty dalam naskah PHP anda:

4

Instalasi

Coba menjalankan naskah di atas. Jika anda mendapatkan kesalahan yang mengatakan Smarty.class.php file could not be found, anda perlu melakukan salah satu dari yang berikut:

Teladan 2.2. Setel konstan SMARTY_DIR secara manual

5

Instalasi

Sekarang file librari itu di tempatnya, waktunya menyiapkan direktori Smarty untuk aplikasi anda: Smarty memerlukan empat direktori yang secara standar bernama templates/, templates_c/, configs/ dancache/

Setiap dari yang di atas tersebut bisa didefinisikan dengan properti kelas Smarty masing-masing $template_dir, $compile_dir, $config_dir, dan $cache_dir It is highly recommended that you setup a separate set of these directories for each application that will use Smarty

For our installation example, we will be setting up the Smarty environment for a guest book application. We picked an application only for the purpose of a directory naming convention. You can use the same environment for any application, just replace guestbook/ with the name of your application.

Teladan 2.6. What the file structure looks like/usr/local/lib/Smarty-v.e.r/libs/ Smarty.class.php Smarty_Compiler.class.php Config_File.class.php debug.tpl internals/*.php plugins/*.php /web/www.example.com/ guestbook/ templates/ index.tpl templates_c/ configs/ cache/ htdocs/ index.php

Be sure that you know the location of your web server's document root as a file path. In the following examples, the document root is /web/www.example.com/guestbook/htdocs/. The Smarty directories are only accessed by the Smarty library and never accessed directly by the web browser. Therefore to avoid any security concerns, it is recommended (but not mandatory) to place these directories outside of the web server's document root. You will need as least one file under your document root, and that is the script accessed by the web browser. We will name our script index.php, and place it in a subdirectory under the document root /htdocs/. Smarty will need write access (windows users please ignore) to the $compile_dir and $cache_dir directories (templates_c/ and cache/), so be sure the web server user account can write to them. Catatan: This is usually user nobody and group nobody. For OS X users, the default is user www and group www. If you are using Apache, you can look in your httpd.conf file to see what user and group are being used.

Teladan 2.7. Permissions and making directories writablechown nobody:nobody /web/www.example.com/guestbook/templates_c/ chmod 770 /web/www.example.com/guestbook/templates_c/ chown nobody:nobody /web/www.example.com/guestbook/cache/ chmod 770 /web/www.example.com/guestbook/cache/

6

Instalasi

Note: chmod 770 will be fairly tight security, it only allows user nobody and group nobody read/write access to the directories. If you would like to open up read access to anyone (mostly for your own convenience of viewing these files), you can use 775 instead. We need to create the index.tpl file that Smarty will display. This needs to be located in the $template_dir.

Teladan 2.8. /web/www.example.com/guestbook/templates/index.tpl{* Smarty *} Hello {$name}, welcome to Smarty!

Technical Note: {* Smarty *} is a template comment. It is not required, but it is good practice to start all your template files with this comment. It makes the file easy to recognize regardless of the file extension. For example, text editors could recognize the file and turn on special syntax highlighting. Now lets edit index.php. We'll create an instance of Smarty, assign() a template variable and display() the index.tpl file.

Teladan 2.9. Editing /web/www.example.com/docs/guestbook/index.php

Note: In our example, we are setting absolute paths to all of the Smarty directories. If / web/www.example.com/guestbook/ is within your PHP include_path, then these settings are not necessary. However, it is more efficient and (from experience) less error-prone to set them to absolute paths. This ensures that Smarty is getting files from the directories you intended. Now naviagate to the index.php file with the web browser. You should see "Hello Ned, welcome to Smarty!" You have completed the basic setup for Smarty!

Extended SetupThis is a continuation of the basic installation, please read that first! A slightly more flexible way to setup Smarty is to extend the class [http://php.net/ref.classobj] and initialize your Smarty 7

Instalasi

environment. So instead of repeatedly setting directory paths, assigning the same vars, etc., we can do that in one place. Lets create a new directory /php/includes/guestbook/ and make a new file called setup.php. In our example environment, /php/includes is in our include_path. Be sure you set this up too, or use absolute file paths.

Teladan 2.10. /php/includes/guestbook/setup.php

Now lets alter the index.php file to use setup.php:

Teladan 2.11. /web/www.example.com/guestbook/htdocs/index.php

Now you see it is quite simple to bring up an instance of Smarty, just use Smarty_GuestBook() which automatically initializes everything for our application.

8

Bagian II. Smarty Untuk Desainer TemplateDaftar Isi3. Sintaks Dasar .................................................................................................................................. Komentar .......................................................................................................................... Variabel ............................................................................................................................ Fungsi ............................................................................................................................... Atribut .............................................................................................................................. Menyertakan Vars dalam Tanda Kutip Ganda ........................................................................... Matematika ........................................................................................................................ Escaping Penguraian Smarty ................................................................................................. 4. Variabel ......................................................................................................................................... Variabel ditempatkan dari PHP .............................................................................................. Variabel yang diambil dari file config ..................................................................................... variabel terpakai {$smarty} ................................................................................................... 5. Pengubah Variabel ........................................................................................................................... capitalize ........................................................................................................................... cat .................................................................................................................................... count_characters ................................................................................................................. count_paragraphs ................................................................................................................ count_sentences .................................................................................................................. count_words ...................................................................................................................... date_format ........................................................................................................................ default .............................................................................................................................. escape ............................................................................................................................... indent ............................................................................................................................... lower ................................................................................................................................ nl2br ................................................................................................................................. regex_replace ..................................................................................................................... replace .............................................................................................................................. spacify .............................................................................................................................. string_format ...................................................................................................................... strip .................................................................................................................................. strip_tags ........................................................................................................................... truncate ............................................................................................................................. upper ................................................................................................................................ wordwrap .......................................................................................................................... 6. Menggabungkan Pengubah ................................................................................................................ 7. Fungsi Built-in ................................................................................................................................ {capture} ........................................................................................................................... {config_load} ..................................................................................................................... {foreach},{foreachelse} ....................................................................................................... {if},{elseif},{else} .............................................................................................................. {include} ........................................................................................................................... {include_php} .................................................................................................................... {insert} ............................................................................................................................. {ldelim},{rdelim} ............................................................................................................... {literal} ............................................................................................................................. {php} ............................................................................................................................... 9 11 11 12 13 13 14 14 15 16 16 18 19 22 23 24 24 25 25 26 26 29 30 31 32 32 33 34 34 35 35 36 37 38 38 40 41 41 42 44 48 50 52 53 54 55 56

Smarty Untuk Desainer Template

{section},{sectionelse} ........................................................................................................ {strip} ............................................................................................................................... 8. Fungsi Kustom ................................................................................................................................ {assign} ............................................................................................................................ {counter} .......................................................................................................................... {cycle} ............................................................................................................................. {debug} ............................................................................................................................ {eval} ............................................................................................................................... {fetch} .............................................................................................................................. {html_checkboxes} ............................................................................................................. {html_image} ..................................................................................................................... {html_options} ................................................................................................................... {html_radios} ..................................................................................................................... {html_select_date} .............................................................................................................. {html_select_time} .............................................................................................................. {html_table} ...................................................................................................................... {mailto} ............................................................................................................................ {math} .............................................................................................................................. {popup} ............................................................................................................................ {popup_init} ...................................................................................................................... {textformat} ....................................................................................................................... 9. File Config ..................................................................................................................................... 10. Konsole Debugging ........................................................................................................................

57 66 67 67 68 69 70 70 72 72 74 75 78 80 83 85 87 88 90 94 94 98 99

10

Bab 3. Sintaks DasarDaftar IsiKomentar .......................................................................................................................................... Variabel ............................................................................................................................................ Fungsi ............................................................................................................................................... Atribut .............................................................................................................................................. Menyertakan Vars dalam Tanda Kutip Ganda ........................................................................................... Matematika ........................................................................................................................................ Escaping Penguraian Smarty ................................................................................................................. Semua tag template Smarty ditutupi di dalam pembatas. Standarnya adalah { dan }, tapi bisa juga diubah. Untuk contoh dalam manual ini, kami menganggap bahwa anda menggunakan pembatas standar. Dalam Smarty, seluruh konten diluar pembatas ditampilkan sebagai konten statis, atau tidak diubah. Ketika Smarty menemukan tag template, ia mencoba untuk menginterpretasikannya, dan menampilkan output yang sesuai di tempatnya. 11 12 13 13 14 14 15

KomentarKomentar template dikelilingi oleh bintang, dan ditutup oleh tag pembatas seperti:{* ini adalah sebuah komentar *}

Komentar Smarty TIDAK ditampilkan dalam output template final, tidak seperti . Ini berguna untuk membuat catatan internal dalam template yang tak seorangpun akan melihatnya ;-)

Teladan 3.1. Komentar di dalam template{* Saya adalah komentar Smarty, Saya tidak ada dalam output terkompilasi {$title} {* komentar smarti satu baris lainnya *} {* ini komentar smarty multi baris tidak dikirimkan ke browser *} {********************************************************* Blok komentar multi baris dengan blok penghargaan @ pembuat: bg@example.com @ pemeliharan support@example.com @ para: var yang menetapkan gaya blok @ css: gaya output **********************************************************} {* File header dengan logo utama dan lainnya {include file='header.tpl'} *} *}

11

Sintaks Dasar

{* Catatan Dev: var $includeFile ditempatkan dalam naskah foo.php {include file=$includeFile} {* blok ini mubazir *} {* {html_options options=$vals selected=$selected_id} *} {* $affiliate|upper *} {* you cannot nest comments *} {* {* -- none -- *} {html_options options=$vals selected=$selected_id} *} {* tag cvs untuk template, di bawah 36 HARUS kurs amerika . akan tetapi ia diubah dalam cvs.. *} {* $Id: Exp $ *} {* $Id: *}

*}

VariabelVariabel template dimulai dengan tanda $dolar. Ia dapat berisi angka, huruf dan garis bawah, lebih mirip variabel PHP [http:/ / php.net/ language.variables]. Anda bisa mereferensi array dengan indeks secara numerik atau non-numerik. Juga referensi properi dan metode obyek. Variabel file config adalah kekecualian untuk sintaks $dolar dan sebaliknya direferensi dengan sekeliling #tanda kris#, atau via variabel $smarty.config.

Teladan 3.2. Variabel{$foo}

di mana konten index.tpl adalah:Hello {$firstname} {$lastname}, glad to see you can make it.

16

Variabel

{* ini tidak akan bekerja karena $variables adalah sensitif huruf *} This weeks meeting is in {$meetingplace}. {* ini akan bekerja *} This weeks meeting is in {$meetingPlace}.

Output di atas:Hello Doug Evans, glad to see you can make it.
This weeks meeting is in . This weeks meeting is in New York.

Array asosiatifAnda juga bisa mereferensi variabel array asosiatif yang ditempatkan dari PHP dengan menetapkan kunci setelah simbol '.' (titik).

Teladan 4.3. Mengakses variabel array asosiatif

di mana konten index.tpl adalah:{$Contacts.fax}
{$Contacts.email}
{* anda dapat menampilkan array dari array juga *} {$Contacts.phone.home}
{$Contacts.phone.cell}

ini akan menampilkan:555-222-9876
zaphod@slartibartfast.example.com
555-444-3333
555-111-1234

Indeks arrayAnda bisa mereferensi array dengan indeksnya, lebih mirip dengan sintaks PHP.

Teladan 4.4. Mengakses array dengan indeks

di mana index.tpl adalah:{$Contacts[0]}
{$Contacts[1]}
{* anda dapat menampilkan arrays dari arrays juga *} {$Contacts[2][0]}
{$Contacts[2][1]}

Ini akan menampilkan:555-222-9876
zaphod@slartibartfast.example.com
555-444-3333
555-111-1234

ObyekProperti obyek yang ditempatkan dari PHP dapat direferensi dengan menetapkan nama properti setelah simbol ->.

Teladan 4.5. Mengakses properti obyekname: {$person->name}
email: {$person->email}

ini akan menampilkan:name: Zaphod Beeblebrox
email: zaphod@slartibartfast.example.com

Variabel yang diambil dari file configVariabel yang diambil dari file config direferensi dengan menutupinya dalam #tanda kris#, atau dengan variabel smarty $smarty.config. Sintaks terakhir berguna untuk menyertakan ke dalam nilai atribut bertanda kutip.

Teladan 4.6. variabel configContoh file config - foo.conf:pageTitle = "This is mine" bodyBgColor = '#eeeeee' tableBorderSize = 3 tableBgColor = "#bbbbbb" rowBgColor = "#cccccc"

18

Variabel

Template yang memperlihatkan metode #hash#:{config_load file='foo.conf'} {#pageTitle#} First Last Address

Template yang memperlihatkan metode $smarty.config:{config_load file='foo.conf'} {$smarty.config.pageTitle} First Last Address

Kedua contoh akan menampilkan: This is mine First Last Address

Variabel file config tidak bisa dipakai sampai setelah diambil dari file config. Prosedur ini dijelaskan nanti dalam dokumen ini di bawah {config_load}. Lihat juga variabel dan variabel terpakai $smarty

variabel terpakai {$smarty}variabel PHP terpakai {$smarty} bisa digunakan untuk mengakses beberapa lingkungan dan variabel permintaan. Daftar lengkapnya sebagai berikut.

Variabel permintaanvariabel permintaan [http:/ / php.net/ reserved.variables] seperti $_GET, $_POST, $_COOKIE, $_SERVER, $_ENV dan $_SESSION (lihat $request_vars_order dan $request_use_auto_globals) bisa diakses seperti diperlihatkan dalam 19

Variabel

contoh di bawah ini:

Teladan 4.7. Menampilkan variabel permintaan{* menampilkan nilai halaman dari URL ($_GET) http://www.example.com/index.php?page=foo *} {$smarty.get.page} {* menampilkan variabel "page" dari sebuah formulir ($_POST['page']) *} {$smarty.post.page} {* menampilkan nilai cookie "username" ($_COOKIE['username']) *} {$smarty.cookies.username} {* menampilkan variabel server "SERVER_NAME" ($_SERVER['SERVER_NAME'])*} {$smarty.server.SERVER_NAME} {* menampilkan variabel lingkungan sistem "PATH" *} {$smarty.env.PATH} {* menampilkan variabel sesi php "id" ($_SESSION['id']) *} {$smarty.session.id} {* menampilkan "username" dari gabungan get/post/cookies/server/env *} {$smarty.request.username}

Catatan: Untuk alasan historis {$SCRIPT_NAME} dapat diakses secara {$smarty.server.SCRIPT_NAME} adalah cara yang diusulkan untuk mengakses nilai ini.click me click me

langsung,

meskipun

{$smarty.now}Cap waktu [http:/ / php.net/ function.time] saat ini bisa diakses dengan {$smarty.now}. Nilai merefleksikan jumlah detik berlalu sejak apa yang disebut Epoch pada 1 Januari 1970, dan dapat dikirimkan secara langsung ke pengubah date_format untuk ditampilkan. Catatan bahwa time() [http:/ / php.net/ function.time] dipanggil setiap kali ada permintaan; misalnya naskah yang mengambil tiga detik untuk dijalankan dengan sebuah panggilan ke $smarty.now di awal dan akhir akan menampilkan perbedaan tiga detik.{* gunakan pengubah date_format untuk menampilkan tangal dan jam saat ini *} {$smarty.now|date_format:'%Y-%m-%d %H:%M:%S'}

{$smarty.const}Anda dapat mengakses nilai konstan PHP secara langsung. Lihat juga konstan smarty.

Output konstan dalam template{$smarty.const.MY_CONST_VAL}

{$smarty.capture}20

Variabel

Output template ditangkap melalui fungsi built-in {capture}..{/capture} bisa diakses menggunakan variabel {$smarty.capture}. Lihat halaman {capture} untuk informasi lebih jauh.

{$smarty.config}Variabel {$smarty.config} bisa digunakan untuk merujuk ke variabel config yang diambil. {$smarty.config.foo} adalah sinonim untuk {#foo#}. Lihat halaman {config_load} untuk informasi lebih jauh.

{$smarty.section}, {$smarty.foreach}Variabel {$smarty.section} dan {$smarty.foreach} dapat digunakan untuk merujuk ke masing-masing properti pengulangan {section} dan {foreach}. Ini memiliki beberapa nilai kegunaan seperti .first, .index, dll.

{$smarty.template}Mengembalikan nama template yang sedang diproses saat ini. Contoh berikut memperlihatkan container.tpl dan banner.tpl yang disertakan dengan {$smarty.template} di dalam keduanya.Main container is {$smarty.template} {include file='banner.tpl'}

akan menampilkanMain page is container.tpl banner.tpl

{$smarty.version}Mengembalikan versi Smarty di mana template sudah dikompilasi dengannya.Powered by Smarty {$smarty.version}

{$smarty.ldelim}, {$smarty.rdelim}Variabel ini dipakai untuk mencetak nilai pembatas-kiri dan pembatas-kanan secara literal, sama seperti {ldelim},{rdelim}. Lihat juga variabel yang ditempati dan variabel config

21

Bab 5. Pengubah VariabelDaftar Isicapitalize ........................................................................................................................................... cat .................................................................................................................................................... count_characters ................................................................................................................................. count_paragraphs ................................................................................................................................ count_sentences .................................................................................................................................. count_words ...................................................................................................................................... date_format ........................................................................................................................................ default .............................................................................................................................................. escape ............................................................................................................................................... indent ............................................................................................................................................... lower ................................................................................................................................................ nl2br ................................................................................................................................................. regex_replace ..................................................................................................................................... replace .............................................................................................................................................. spacify .............................................................................................................................................. string_format ...................................................................................................................................... strip .................................................................................................................................................. strip_tags ........................................................................................................................................... truncate ............................................................................................................................................. upper ................................................................................................................................................ wordwrap .......................................................................................................................................... 23 24 24 25 25 26 26 29 30 31 32 32 33 34 34 35 35 36 37 38 38

Pengubah variabel dapat diterapkan ke variabel, fungsi kustom atau string. Untuk menerapkan pengubah, tetapkan nilai diikuti oleh | (pipa) dan nama pengubah. Pengubah bisa menerima parameter tambahan yang mempengaruhi sifatnya. Parameter ini mengikuti nama pengubah dan dipisahkan oleh : (titik dua). Juga, semua fungsi-php bisa dipakai sebagai pengubah secara implisit (lengkapnya di bawah) dan pengubah bisa digabungkan. .

Teladan 5.1. Contoh pengubah{* terapkan pengubah ke variabel *} {$title|upper} {* pengubah dengan parameter *} {$title|truncate:40:'...'} {* terapkan pengubah ke parameter fungsi *} {html_table loop=$myvar|upper} {* dengan parameter *} {html_table loop=$myvar|truncate:40:'...'} {* terapkan pengubah ke string literal *} {'foobar'|upper} {* menggunakan date_format untuk membentuk tanggal saat ini *} {$smarty.now|date_format:"%Y/%m/%d"} {* terapkan pengubah ke fungsi kustom *} {mailto|upper address='smarty@example.com'} {* menggunakan str_repeat php *}

22

Pengubah Variabel

{'='|str_repeat:80} {* penghitung php *} {$myArray|@count} {* acak pada ip server php *} {$smarty.server.SERVER_ADDR|shuffle} (* ini akan dibesarkan dan memotong seluruh array *} {html_options output=$myArray|upper|truncate:20}

Jika anda menerapkan pengubah ke variabel array daripada variabel nilai tunggal, pengubah akan diterapkan ke setiap nilai dalam array itu. Jika anda benar-benar menginginkan pengubah untuk bekerja pada seluruh array sebagai nilai, anda harus menambah nama pengubah dengan simbol @. Contoh: {$articleTitle|@count} - akan mencetak jumlah elemen dalam array $articleTitle menggunakan fungsi php count() [http://php.net/count] sebagai pengubah.

Pengubah adalah otomatis diambil dari $plugins_dir atau bisa didaftarkan secara eksplisit dengan fungsiregister_modifier(). Yang terakhir berguna untuk berbagi fungsi antara naskah php dan template Smarty.

Semua fungsi-php dapat dipakai sebagai pengubah secara implisit, seperti didemonstrasikan dalam contoh di atas. Akan tetapi, menggunakan fungsi-php sebagai pengubah mempunyai dua kesulitan: Pertama - adakalanya urutan parameter-fungsi bukan yang diinginkan. Membentu $foo dengan {"%2.f"|sprintf:$foo} sebenarnya bekerja, tapi perlu lebih intuitif, seperti {$foo|string_format:"%2.f"} yang disediakan oleh distribusi Smarty. Kedua - jika $security dihidupkan, semua fungsi-php yang dipakai sebagai pengubah harus dideklarasikan dalam elemen MODIFIER_FUNCS dari array $security_settings.

Lihat juga register_modifier(), menggabungkan pengubah. dan memperluas smarty dengan plugins

capitalizeIni dipakai untuk membesarkan huruf pertama dari seluruh kata dalam variable. Mirip dengan fungsi PHP ucfirst() [http://php.net/ucfirst]. Posisi Parameter 1 Tipe boolean Diperlukan Tidak DefaultFALSE

Deskripsi Ini menentukan apakah kata dengan digit akan dibesarkan atau tidak

Teladan 5.2. capitalize

23

Pengubah Variabel

Di mana template adalah:{$articleTitle} {$articleTitle|capitalize} {$articleTitle|capitalize:true}

Akan memperlihatkan:next x-men film, x3, delayed. Next X-Men Film, x3, Delayed. Next X-Men Film, X3, Delayed.

Lihat juga lower dan upper

catNilai ini digabungkan ke variabel yang disediakan. Posisi Parameter 1 Tipe string Diperlukan Tidak Default empty Deskripsi Nilai ini menggabung variabel yang disediakan.

Teladan 5.3. cat

Template yang menampilkan hasil database dalam tabel HTML Name>HomeCellEmail {section name=co loop=$contacts} view {$contacts[co].name} {$contacts[co].home} {$contacts[co].cell} {$contacts[co].email} {sectionelse} Tidak ada item yang ditemukan {/section}

.indexindex berisi indeks array saat ini, dimulai dengan nol atau atribut start bila diberikan. Ia bertambah satu atau dengan atribut step bila diberikan. Catatan Teknis: Jika properti step dan start tidak diubah, maka pekerjaan ini sama seperti properti iteration, kecuali ia dimulai dengan nol daripada satu.

Teladan 7.37. {section} index property

FYI: $custid[customer.index] dan $custid[customer] adalah sama.{section name=customer loop=$custid} {$smarty.section.customer.index} id: {$custid[customer]}
{/section}

Contoh di atas akan menampilkan:0 id: 1000
1 id: 1001
2 id: 1002

.index_previndex_prev adalah indeks pengulangan sebelumnya. Pada pengulangan pertama, ini disetel -1.

62

Fungsi Built-in

.index_nextindex_next adalah indeks pengulangan berikutnya. Pada pengulangan terakhir, ini masih satu lagi daripada indeks saat ini, memperhatikan setelan atribut step, jika diberikan.

Teladan 7.38. properti index, index_next dan index_prev

Template untuk menampilkan array di atas dalam sebuah tabel{* $rows[row.index] dan $rows[row] adalah identik dalam pengertian *} indexid index_prevprev_id index_nextnext_id {section name=row loop=$rows} {$smarty.section.row.index}{$rows[row]} {$smarty.section.row.index_prev}{$rows[row.index_prev]} {$smarty.section.row.index_next}{$rows[row.index_next]} {/section}

Contoh di atas akan menampilkan tabel yang berisi sebagai berikut:index 0 1 2 3 4 id 1001 1002 1003 1004 1005 index_prev -1 0 1 2 3 prev_id index_next 1 1001 2 1002 3 1003 4 1004 5 next_id 1002 1003 1004 1005

.iterationiteration berisi iterasi pengulangan saat ini dan dimulai dari satu. Catatan: Ini tidak dipengaruhi oleh properti {section} start, step dan max, tidak seperti properti index. iteration juga dimulai dengan satu daripada nol tidak seperti index. rownum adalah alias untuk iteration, keduanya sama.

Teladan 7.39. Properti iteration dari seksi

Template untuk menampilkan setiap elemen lain array $arr dengan step=2{section name=cu loop=$arr start=5 step=2}

63

Fungsi Built-in

iteration={$smarty.section.cu.iteration} index={$smarty.section.cu.index} id={$custid[cu]}
{/section}

Contoh di atas akan menampilkan:iteration=1 iteration=2 iteration=3 iteration=4 iteration=5 iteration=6 index=5 id=3005
index=7 id=3007
index=9 id=3009
index=11 id=3011
index=13 id=3013
index=15 id=3015

Contoh lain yang menggunakan properti iteration untuk mengeluarkan blok header tabel setiap lima baris. Menggunakan fungsi {if} dengan operator mod. {section name=co loop=$contacts} {if $smarty.section.co.iteration % 5 == 1} Name>HomeCellEmail {/if} view {$contacts[co].name} {$contacts[co].home} {$contacts[co].cell} {$contacts[co].email} {/section}

.firstfirst disetel TRUE jika iterasi {section} saat ini adalah yang pertama.

.lastlast disetel TRUE jika iterasi seksi saat ini adalah yang terakhir.

Teladan 7.40. properti {section} first dan lastContoh ini mengulang array $customers, mengeluarkan blok header pada iterasi pertama dan terakhir mengeluarkan blok footer. Juga menggunakan properti total.{section name=customer loop=$customers} {if $smarty.section.customer.first} idkustomer {/if} {$customers[customer].id}} {$customers[customer].name} {if $smarty.section.customer.last} {$smarty.section.customer.total} kustomer

64

Fungsi Built-in

{/if} {/section}

.rownumrownum berisi iterasi pengulangan saat ini, dimulai dengan satu. Ini adalah nama lain dari iterasi, cara kerjanya sama persis.

.looploop berisi angka indeks terakhir yang mengulang {section}. Ini bisa dipakai di dalam atau setelah {section}.

Teladan 7.41. properti {section} loop{section name=customer loop=$custid} {$smarty.section.customer.index} id: {$custid[customer]}
{/section} Ada {$smarty.section.customer.loop} kustomer yang ditampilkan di atas.

Contoh di atas akan menampilkan:0 id: 1 id: 2 id: Ada 3 1000
1001
1002
kustomer yang ditampilkan di atas.

.showshow dipakai sebagai parameter ke seksi dan berupa nilai boolean. Jika FALSE, seksi tidak akan ditampilkan. Jika terdapat {sectionelse}, akan ditampilkan sebagai alternatif.

Teladan 7.42. show propertiBoolean $show_customer_info sudah dikirimkan dari aplikasi PHP, untuk mengatur apakah seksi ditampilkan atau tidak.{section name=customer loop=$customers show=$show_customer_info} {$smarty.section.customer.rownum} id: {$customers[customer]}
{/section} {if $smarty.section.customer.show} seksi ditampilkan. {else} seksi tidak ditampilkan. {/if}

Contoh di atas akan menampilkan:1 id: 1000
2 id: 1001
3 id: 1002
the section was shown.

65

Fungsi Built-in

.totaltotal berisi jumlah iterasi yang akan {section} mengulangnya. Ini bisa dipakai di dalam atau setelah {section}.

Teladan 7.43. total contoh properti{section name=customer loop=$custid step=2} {$smarty.section.customer.index} id: {$custid[customer]}
{/section} Ada {$smarty.section.customer.total} kustomer yang ditampilkan di atas.

Lihat juga {foreach} dan $smarty.section.

{strip}Berulang kali desainer designers mengalami hal di mana spasi dan tombol enter mempengarhui output dari HTML yang dibuatnya ("fitur" browser), kemudian anda harus menjalankan semua tag anda bersamaan dalam template guna memperoleh hasil yang diinginkan. Ini biasanya berakhir dengan template yang tidak terbaca atau tidak teratur. Apapun spasi ekstra atau tanda tombol enter di dalam tag {strip}{/strip} dibuang di awal dan akhir baris sebelum ditampilkan. Dengan cara ini anda bisa memelihara template mudah dibaca, dan tidak mencemaskan tentang spasi ekstra yang menyebabkan masalah. Catatan: {strip}{/strip} tidak mempengaruhi isi dari variabel template, sebaliknya lihat pengubah strip.

Teladan 7.44. tag {strip}{* contoh berikut akan dijalankan semua ke dalam satu baris setelah output *} {strip} This is a test {/strip}

Contoh di atas akan menampilkan: