Instale los archivos de la libreria de Smarty que estan en el directorio de distribución /libs/. Estos son los archivos PHP que usted NO EDITARA. Estos archivos son toda las aplicaciones comunes y ellos son actualizados cuando usted actualiza a una nueva versión de Smarty.

Smarty.class.php
Smarty_Compiler.class.php
Config_File.class.php
debug.tpl
/internals/*.php (all of them)
/plugins/*.php (all of them)

    

Smarty utiliza una constante de PHP llamada SMARTY_DIR que es la ruta para el directorio de la biblioteca de Smarty 'libs/'. Basicamente, si su aplicación puede encontrar el archivo Smarty.class.php , usted no necesita definir SMARTY_DIR, Smarty lo encontrará. Por consiguiente si, Smarty.class.php no esta incluido en el path, y no es abastecido por una ruta absoluta para encontrar su aplicación, entonces usted debe definir SMARTY_DIR manualmente. SMARTY_DIR debe incluir una barra de seguimento.

Aquí esta un ejemplo de como se crea una instancia de Smarty en sus scripts PHP:

<?php
require('Smarty.class.php');
$smarty = new Smarty;
?>

    

Intente correr el script de arriba. Si usted obtiene un error diciendo que el archivo Smarty.class.php no fue encontrado, puedes usar una de las siguientes opciones:

<?php
require('/usr/local/lib/php/Smarty/Smarty.class.php');
$smarty = new Smarty;
?>

    

<?php
// Edite su archivo php.ini, y adicione el directorio de la libreria de Smarty
// include_path  y  reinicie su servidor web.
// Entonces lo siguiente debe funcionar:
require('Smarty.class.php');
$smarty = new Smarty;
?>

    

<?php
define('SMARTY_DIR', '/usr/local/lib/php/Smarty/');
require(SMARTY_DIR . 'Smarty.class.php');
$smarty = new Smarty;
?>

    

Ahora que la libreria de archivos esta en su sitio, es tiempo de configurar los directorios de Smarty para su aplicación.

Smarty require cuatro directorios (por defaul) llamados 'templates/', 'templates_c/', 'configs/' y 'cache/'.

Cada uno de estos son para definir las propiedades de las clases de Smarty. $template_dir, $compile_dir, $config_dir, y $cache_dir respectivamente. Es altamente recomendado que usted configure un grupo separado de estos directorios para cada aplicación que utilice de Smarty.

Asegurece que usted sabe la ubicación del document root de su servidor web. En nuestro ejemplo, el document root esta en /web/www.example.com/docs/. Los directorios de Smarty solo son accesados por la libreria de Smarty y nunca son accesados directamente por el navegador. Por consiguiente para evitar cualquier preocupación con la seguridad, es recomendado colocar estos directorios fuera del document root.

Para nuestro ejemplo de instalación, configuraremos el ambiente de Smarty para una aplicación de libro de visitas. Escojemos una aplicación solo con el proposito de crear un directorio de nombre convencional. Usted puede usar el mismo ambiente para cualquier aplicación, solamente sustituya "guestbook" con el nombre de su aplicación. Nosotros colocaremos nuestros directorios de Smarty dentro de /web/www.example.com/smarty/guestbook/.

Usted necesita tener por lo menos un archivo dentro de su document root, y que sea accesado por el navegador. Nosotros llamamos el script de 'index.php', y lo colocamos en un subdirectorio dentro del document root llamado /guestbook/.

Veamos nuestra estructura de archivos hasta hora:

/usr/local/lib/php/Smarty/Smarty.class.php
/usr/local/lib/php/Smarty/Smarty_Compiler.class.php
/usr/local/lib/php/Smarty/Config_File.class.php
/usr/local/lib/php/Smarty/debug.tpl
/usr/local/lib/php/Smarty/internals/*.php
/usr/local/lib/php/Smarty/plugins/*.php

/web/www.example.com/smarty/guestbook/templates/
/web/www.example.com/smarty/guestbook/templates_c/
/web/www.example.com/smarty/guestbook/configs/
/web/www.example.com/smarty/guestbook/cache/

/web/www.example.com/docs/guestbook/index.php

    

Smarty necesitara permisos de escritura (usuarios de windows ingnorar) para $compile_dir y $cache_dir, esto garantiza que el usuario del servidor pueda escribir en ellos. Este es generalmente el usuarios "nobody" y el grupo "nobody". Para usuarios con X sistema operativo, el default es "www" y el grupo "www". Si usted esta usando Apache, puede ver en su archivo httpd.conf (normalmente en "/usr/local/apache/conf/") cual es el usuario y grupo que estan siendo usados.

chown nobody:nobody /web/www.example.com/smarty/guestbook/templates_c/
chmod 770 /web/www.example.com/smarty/guestbook/templates_c/

chown nobody:nobody /web/www.example.com/smarty/guestbook/cache/
chmod 770 /web/www.example.com/smarty/guestbook/cache/

    

Nosotros necesitamos crear el archivo index.tpl, para que Smarty lo pueda cargar. Este estara localizado en su $template_dir.

{* Smarty *}

Hello, {$name}!

    

Ahora vamos a editar el index.php. crearemos una instancia de Smarty, daremos valor a las variables del template y mostraremos el archivo index.tpl. En el ambiente de nuestro ejemplo, "/usr/local/lib/php/Smarty" esta dentro de include_path. Asegurese que exista el mismo, o utilice la ruta absoluta.

<?php

// load Smarty library
require('Smarty.class.php');

$smarty = new Smarty;

$smarty->template_dir = '/web/www.example.com/smarty/guestbook/templates/';
$smarty->compile_dir = '/web/www.example.com/smarty/guestbook/templates_c/';
$smarty->config_dir = '/web/www.example.com/smarty/guestbook/configs/';
$smarty->cache_dir = '/web/www.example.com/smarty/guestbook/cache/';

$smarty->assign('name','Ned');

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

    

Ahora carge el archivo index.php desde su navegador web. Usted debera ver "Hello, Ned!"

Usted a completado la configuracion basica para el Smarty!