1.8 KiB
1.8 KiB
layout | permalink | title |
---|---|---|
default | templates/syntax/ | Syntax |
Syntax
While the actual syntax you use in your templates is entirely your choice (it's just PHP after all), we suggest the following syntax guidelines to help keep templates clean and legible.
Guidelines
- Always use HTML with inline PHP. Never use blocks of PHP.
- Always escape potentially dangerous variables prior to outputting using the built-in escape functions. More on escaping here.
- Always use the short echo syntax (
<?=
) when outputting variables. For all other inline PHP code, use full the<?php
tag. Do not use short tags. - Always use the alternative syntax for control structures, which are designed to make templates more legible.
- Never use PHP curly brackets.
- Only ever have one statement in each PHP tag.
- Avoid using semicolons. They are not needed when there is only one statement per PHP tag.
- Never use the
use
operator. Templates should not be interacting with classes in this way. - Never use the
for
,while
orswitch
control structures. Instead useif
andforeach
. - Avoid variable assignment.
Syntax example
Here is an example of a template that complies with the above syntax rules.
<?php $this->layout('template', ['title' => 'User Profile']) ?>
<h1>Welcome!</h1>
<p>Hello <?=$this->e($name)?></p>
<h2>Friends</h2>
<ul>
<?php foreach($friends as $friend): ?>
<li>
<a href="/profile/<?=$this->e($friend->id)?>">
<?=$this->e($friend->name)?>
</a>
</li>
<?php endforeach ?>
</ul>
<?php if ($invitations): ?>
<h2>Invitations</h2>
<p>You have some friend invites!</p>
<?php endif ?>