PHP template Smarty User Guide

Generally, our solution is to design the page by the artist and deliver it to the program designer for development, and then deliver the art to improve the page. Repeat the page several times back and forth. If the program designer is unfamiliar with HTML, it is a tough task for both parties, and the efficiency is also lower. In this case, template support is very important.

We know that as a member of the open-source community, PHP provides various template engines, such as FastTemplate, Smarty, and SimpleTemplate. However, Smarty is a PHP template engine that currently uses a lot of resources, today, I want to share with you how to install and use the PHP template Smarty in PHP development.

Preparations

1. Select the directory for installing Smarty

If you have server permissions, you can choose to install Smarty outside the WEB application documentation directory, and then include the Smarty installation directory address in the include_path option in the PHP. ini file.

If it is a virtual host permission or several projects, you can install Smarty in their respective project directories, In the require Smarty file, or use the Smarty template engine. For the sake of security, you can use apache to disable access to related directories.

In addition, the two PHP templates have different Smarty installation methods in terms of portability. The first method needs to ensure that each server has the same Smarty configuration. The second method does not affect the configuration of each server. You can select the Smarty installation method as needed.

2. Download Smarty. I chose Smarty-2.6.25.

Install PHP template Smarty

1. decompress the downloaded Smarty-2.6.25 package

2. Copy the libs folder to the WEB program directory. My directory is testsmarty.

For installation methods in Linux, refer to here.

After installing the Smarty template, we started to use the Smarty.

Use PHP template Smarty

1. Create related directories

Because in the process of using Smarty, Smarty generates compiled template files, other configuration files, and cache files, we need to create related directories. Under the testsmarty directory, I also created the tpls directory and the templates, templates_c, configs, and cache directories under the tpls directory. Why do we need to create these directories? Open the Smarty. class. php file. We can see that the Smarty class defines some member attributes.

$ Template_dir: Specifies the directory address to be placed in all template files. By default, the directory is "./templates", that is, find the template directory under the same directory of the PHP Execution program.

$ Compile_dir: Specifies the directory where all template files compiled by Smarty are stored. The default directory is "./templates_c", that is, find the compiling directory under the same directory of the PHP Execution program. If you create this directory on a Linux server, you also need to modify the directory permission so that it has the write permission.

$ Config_dir: Set the directory used to store the special configuration files of the template. The default directory is "./configs", that is, find the configuration directory under the same directory of the PHP Execution program.

$ Cache_dir: When the cache feature is enabled, all templates cached by the PHP template Smarty are placed in the directory specified by this attribute. The default directory is "./cache", that is, to find the cache directory under the same directory of the PHP Execution program. You can also use your custom cache handler to control cached files, which will ignore this setting. Similarly, if you create this directory on a Linux server, you also need to modify the directory permission so that it has the write permission.

For the sake of system security and portability, we recommend that you do not create these directories in the same directory of the PHP Execution program. You can create these directories in addition to the PHP Execution program directory, if you have already created a PHP Execution program in the same directory, you can use Apache to restrict access to directories.

2. Create related configuration files

We need to create a configuration file to overwrite the default member attributes of the PHP template Smarty class and name it main. php, saved in the smarty Directory, which script needs to use Smarty in the future, we just need to put main. include php.

 
 

  
  
< ?  
  
  
include("./smarty/libs/Smarty.class.php");  
  
  
define('SMARTY_ROOT', './smarty/tpls');  
  
  
$tpl = new Smarty();  
  
  
$tpl->template_dir = SMARTY_ROOT."/templates/";  
  
  
$tpl->compile_dir = SMARTY_ROOT."/templates_c/";  
  
  
$tpl->config_dir = SMARTY_ROOT."/configs/";  
  
  
$tpl->cache_dir = SMARTY_ROOT."/cache/";  
  
  
$tpl->caching=1;  
  
  
$tpl->cache_lifetime=60*60*24;  
  
  
$tpl->left_delimiter = '< {';  
  
  
$tpl->right_delimiter = '}>';  
  
  
?> 
 
 

Note:

Line 1-8: defines a smarty object, and sets the directory for storing template files, compilation files, cache files, and configuration files to overwrite the default values in Smarty. class. php.

Row 9-10: set to enable the cache and set the cache validity period to 1 day.
Knowledge Point: $ caching is used to set whether the cache function is enabled. The default value is 0 or invalid. You can also set multiple caches for the same template. When the value is 1 or 2, the cache is started. 1. Tell Smarty to use the current $ cache_lifetime variable to determine whether the cache has expired. 2. Tell the PHP template Smarty to use the cache_lifetime value when the cache is generated. We recommend that you disable caching during project development and set the value to 0.

Line 11-12: Set the Left and Right terminator of the smarty language. We know that braces are the default delimiters of the smarty language, but they may conflict when combined with javascript and css, so here we set it to <{And}>.

3. Create a template file

Generally, after the design of the meigong page is completed, the intersection of the two parties is a template file. after both parties agree, programmers do not need to spend too much energy on the front-end, this is the benefit of using the Smarty template engine for development.

First, create a simple template file named leapsoul. tpl. You can add the smarty variable to the html file and save the file as a tpl file.

 
 

  
  
< html> 
  
  
< head> 
  
  
< meta http-equiv="Content-type" 
content="text/html; charset=gb2312"> 
  
  
< title>   
  
  
< { $title }> 
  
  
< /title>   
  
  
< /head>   
  
  
 <body>   
  
  
< { $content }>   
  
  
< /body>   
  
  
< /html> 
 
 

Note: In this tpl file, the Smarty variables of the title and content PHP templates are set. The files are saved as leapsoul. tpl and saved in the directory of the testsmartytplstemplates template file.

4. Create an application file

The template file is similar to a presentation layer. After the template file is created, we need an application to drive the presentation layer. The application file is defined as smarty. php.

 
 

  
  
<?
  
  
Include ("smarty/main. php ");
  
  
$ Tpl-> assign ("title", "leapsoul.cn for you
Demonstrate smarty template technology ");
  
  
$ Tpl-> assign ("content", "leapsoul.cn
Demonstrate the smarty template technology through detailed installation and usage steps ");
  
  
$ Tpl-> display ("leapsoul. tpl ");
  
  
?>
 
 

Note:

In this Code, we mainly use the two functions assign and display in smarty. assign can be understood as a variable assignment, and display is mainly used to output webpages. More smarty functions will be introduced in detail in the future.

Other Instructions

Since we have enabled the cache function, interested friends can open cache and templates_c. The cache directory stores the cached files of this template. The file starts with cache information, for example, the file generation time and expiration time are not much different from other HTML files, while templates_c stores the PHP Execution file compiled by the template.

So far, the introduction of a simple getting started PHP template Smarty application instance is complete.