STL: Simple Template Language Preview

იოსები — Wed, 02 Dec 2009 08:41:15 +0000

დიდი ხნის პაუზის შემდეგ მინდა წარმოგიდგინოთ ერთი ახალი პროექტი რომელზეც გარკვეული პერიოდია ვმუშაობ. ჯერჯერობით ეს არის პრივიუ რელიზი რომელიც მალე საბოლოო ფაზაში შევა და სრულ დოკუმენტაციასა და მაგალითებს შესაბამისად წარმოგიდგენთ. მანამდე კი მისი ნახვა და გადმოწერა შეგიძლიათ შემდეგი მისამართიდან: STL Library.

რა არის STL? როგორც სათაურმა მიგანიშნათ ეს არის PHP – ზე დაწერილი მარტივი და მოქნილი შაბლონების ენა და ამ ენის პროცესორი. STL არის მარტივად გამოყენებადი შაბლონების ენა რომელიც არის საკმაოდ მარტივად ასათვისებელი თუ თქვენ გაგაჩნიათ ნებისმიერ მსგავს შაბლონების ენასთან სულ მცირედი მუშაობის გამოცდილებაც კი. მისი სინტაქსი წააგავს Django, Jinja2, Smarty და სხვა მსგავსი შაბნოლენბის ენებს.

ბიბლიოთეკას არ აქვს არანაირი დამოკიდებულება სხვა გარე ბიბლიოთეკებზე და PHP – ს სპეციფიურ მოდულებზე. კი არის სრულად ე.წ. standalone და მისი გამოყენება შეგიძლიათ ნებისმიერ PHP პროექტში.

რა არის საჭირო მისი გამოყენებისთვის? სულ მცირედი: 1) თქვენს პროექტში უნდა ჩატვირთოთ stl.lib.php რომლის გადაწერაც შეგიძლიათ ზემოთ მითითებული მისამართიდან; 2) შექმნათ შაბლონი ნებისმიერ ტექსტურ ფორმატში(html, txt, xml და ა.შ); 3) შექმნათ STL_template კლასის ობიექტი, გადასცეთ მას საჭირო ტექსტური შაბლონი და კონტესტური ცვლადები და შეასრულოთ. სულ ეს არის და ეს. როგორ? მაგალითი იხილეთ ქვემოთ:

HTML შაბლონი – test.html

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17

{if students}
<h1>This is students list</h1>
<ul>
{for student in students}
<li>
<h2>{fn:ucfirst(strtolower(%student.name%))}</h2>
<ul>
{for friend in student.friends}
<li>%friend.name%</li>
{/for}
</ul>
</li>
{/for}
</ul>
{else}
<h1>The students list is empty :(</h1>
{/if}

ნაჩვენები შაბლონის მეშვეობით ხდება სტუდენტებისა და შესაბამისად ცალკეული სტუდენტის მეგობრების სიის გამობეჭდვა. ქვემოთ ნაჩვენებია შაბლონის ინიციალიზაციის კოდი:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34

//შაბლონის ობიექტის შექმნა
$tpl = new STL_template('test.html', true);

//შაბლონში მონაცემების დამატება
$tpl->put('students', array(
array(
'name' => 'John',
'friends' => array(
array(
'name' => 'Ann'
),
array(
'name' => 'Suzan'
),
array(
'name' => 'Tom'
)
)
),
array(
'name' => 'Tom',
'friends' => array(
array(
'name' => 'David'
),
array(
'name' => 'Mary'
)
)
)
));

//შაბლონის პროცესინგი, შესრულება და გამობეჭდვა
echo $tpl->process();

ნაჩვენები კოდის შესრულების შედეგად მიიღებთ სურათზე ნაჩვენებ შედეგს:

რაც შეეხება თავად ენის სინტაქსს როგორც მაგალითიდან ჩანს იგი საკმაოდ მარტივია, თუმცა ყურადღებას შეფაჩერებ რამდენიმე დეტალზე.

if/elseif/else ოპერატორი
ეს არის ერთერთი ყველაზე ხშირად გამოყენებადი ოპერატორი და შესაბამისად მაქსიმუმი გავაკეთე იმისთვის რომ მისი გამოყენება მაქსიმალურად ეფექტურად იყოს შესაძლებელი. მაგალითში ნაჩვენები კოდის ფრაგმენტი “{if students}” უბრალოდ ამოწმებს არის თუ არა აღწერილი ცვლადი სახელით “students” და აქვს თუ არა მას მინიჭებული საწყისი მნიშვნელობა. თუმცა პირობა შესაძლებელია იყოს გაცილებით უფრო კომპლექსური. ქვემოთ ნაჩვენებია ამ ოპერატორის გამოყენების ნიმუშები:

1
2
3
4
5
6
7

{if students && someOtherVariable=="some test value" || testValue in someCollection}
Do something
{elseif !students && !someOtherVariable}
Do something else
{else}
UPS :D
{/if}

გარდა if/elseif/else ოპერატორისა ასევე შეგიძლიათ პოპულარული და უმნიშვნელოვანი foreach ოპერატორის გამოყენება, მაგ:

1
2
3

{for student in students}
%student.name%
{/for}

ნაჩვენებ მაგალითში მოხდება “students” კოლექციის იტერაცია ხოლო ყოველი მომდევნო ელემენტის ახალ “student” ცვლადზე მინიჭება. მოგვიანებით კი შეგიძლიათ ახალი “student” ობიექტისა და მისი თვისებების გამოყენება.

ცვლადების გამობეჭდვა ხდება სპეციალური ფორმატის მეშვეობით, კერძოდ კი ცვლადი უნდა განათავსოთ პროცენტის(%) სიმბოლოებში.

ამ მომენტისათვის ასევე უკვე არსებობს ფუნქციების გამოძახების საშუალება, მაგალითში ნჩვენები ფრაგმენტი:

1	{fn:ucfirst(strtolower(%student.name%))}

ფრაგმენტიდან ჩანს რომ ხდება ორი ფუნქციის გამოძახება: 1) strtolower() PHP ფუნქცია რომელიც მნიშვნელობას გადაიყვანს ქვედა რეგისტრის სიმბოლოებში; 2) ucfirst PHP ფუნქცია რომელიც სტრიქონის პირველ სიმბოლოს გადაიყვანს ზედა რეგისტრის სიმბოლოში.

ასევე STL – ს აქვს მოდულების მხარდაჭერა თუმცა ამაზე ოდნავ მოგვიანებით შეგატყობინებთ პროექტის დარელიზების შემდეგ.

ამ მომენტისათვის სულ ეს არის, დოკუმენტაციასა და უფრო ვრცელ მაგალითებს შემოგთავაზებთ სულ მალე

Code.ge Blog » stl

STL: Simple Template Language Preview