PDF de programación - manual de smarty

Smarty Manual

por

Monte Ohrt <[email protected]>, Andrei Zmievski <[email protected]>, y Mario Ramírez

<[email protected]>

Smarty Manual

publicado 07-10-2004
Copyright © 2001-2004 ispi of Lincoln, Inc.

Tabla de contenidos
Prólogo .............................................................................................................................................. iv
I. Iniciando .......................................................................................................................................... 1
1. Que es Smarty? ......................................................................................................................... 2
2. Instalación ................................................................................................................................ 3
II. Smarty For Template Designers ........................................................................................................... 8
3. Basic Syntax ............................................................................................................................. 9
4. Variables ................................................................................................................................ 12
5. Modificadores de variables ........................................................................................................ 18
6. Combinando Modificadores ....................................................................................................... 35
7. Funciones Integradas ................................................................................................................ 36
8. Custom Functions .................................................................................................................... 55
9. Config Files ............................................................................................................................ 82
10. Debugging Console ................................................................................................................ 83
III. Smarty For Programmers ................................................................................................................. 84
11. Constantes ............................................................................................................................ 85
12. Variables .............................................................................................................................. 86
I. Metodos ................................................................................................................................. 93
13. Cache ................................................................................................................................. 134
14. Caracteristicas Avanzadas ....................................................................................................... 140
15. Extendiendo Smarty con plugins .............................................................................................. 148
IV. Appendixes .................................................................................................................................. 158
16. Localización de Errores .......................................................................................................... 159
17. Consejos y Trucos ................................................................................................................. 160
18. Fuentes ............................................................................................................................... 165
19. ERRORES ........................................................................................................................... 166

iii

Prólogo

Esta es indudablemente una de las preguntas que mas se hacen en las listas de correo de PHP: Como hacer mis scripts de
PHP independientes del diseño?. Mientras PHP se encarga de como "incrustar scripts en lenguaje HTML", después de escri-
bir los proyectos que mezclan PHP y HTML libremente, esto trae como consecuencia la idea de separar la forma y el conte-
nido, muy buena idea[TM]. En adición, en muchas compañias la interpretación de esquema es diseñador y programador por
separado. Por consiguiente, la busqueda trae como solución una plantilla(template).

Por ejemplo en nuestra compañia, el desarrollo de una aplicación es como sigue: Después de tener la documentación nece-
saria, el diseñador de web diseña el prototipo de la interfaz y la entrega al programador. El programador implementa las re-
glas de negocio en PHP y usa el prototipo para crear el "esqueleto" de la plantilla. El proyeto esta en manos de la persona
responsable del HTML designer/web page que produzca la plantilla para su gloria completa. El proyecto debe ir y regresar
entre programación/HTML varias veces. De esa manera, es importante para tener un buen suporte de templates porque los
programadores no quieren hacer nada con HTML ni quieren diseño HTML al rededor del codigo PHP. Los diseñadores pre-
cisan de soporte para archivos de configuración, bloques dinámicos y otras interfaces usadas, mas ellos no quieren ocuparse
con las compejidades del lenguaje de programación PHP.

Buscando, actualmente existen muchas soluciones de templates disponibles para PHP, la mayor parte de ellos les provee de
una forma rudimentaria de sustitución de variables dentro del template y hace una forma limitada de la funcionalidad diná-
mica del bloque. Pero nuestras necesidades requieren mas que eso. Porque no queremos programadores que no quieran tener
trato con HTML del todo, pero esto puede ser casi inevitable. Por ejemplo, si un diseñador quiere alternar colores de fondo
sobre bloques dinámicos, esto tuvo que trabajarse con el programador anticipadamente. Nosotros necesitamos también que
los diseñadores esten capacitados para usar archivos de configuración, y colocar variables de ellos dentro de los templates.
La lista continua.

Nosotros empezamos escribiendo por fuera una especulación para un motor de plantillas(templates) atrasado de 1999. Des-
pués de terminar la especulación, comenzamos a trabajar un motor de plantillas escrito en C que esperanzadoramente fue
aceptado para ser incorporado con PHP. No solamente nos encontramos con algunas complicadas barreras tecnicas, si no
también hubo acalorados debates sobre lo que exactamente debia de hacer o no un motor de plantillas. De esta experiencia,
decidimos que un motor de platillas devería ser escrito en PHP como una clase, para que cualquiera lo use de la misma for-
ma como ellos ven. Así nosotros escribimos un motor que es SmartTemplate ™ nunca volvio a existir(nota: esa clase nunca
fue enviada al público). Esta era una clase que ralizaba casi todo lo que nosotros necesitabamos: sustitución de variables re-
gulares, soporte incluso de otras plantillas, integración con archivos de configuración, incrustación de código PHP, funcio-
nalidades 'if' limitada y muchos mas bloques dinámicos robustos que podrían ser anidados muchas veces. Todo esto con ex-
presiones regulares y el código producido seria mejor, como diriamos nosotros, impenetrable. Eso era también notoriamente
lento en grandes aplicaciones por todas las interpretaciones y expresiones regulares trabajando en cada requisición. El ma-
yor problema del punto de vista de un programador era todo el trabajo necesario en el procesamiento del scripts PHP y pro-
cesamiento de bloques dinámicos de la plantilla. Como hacemos eso facilmente?

Entonces se origino la visión de que finalmente se convirtiera en Smarty. Nosotros sabemos que rápido es el código PHP sin
las cabeceras y la interpretación de plantillas(templates). También sabemos que meticuloso y arrogante es el lenguaje PHP
su poder debe ser aceptable para un diseñador, y este podría ser enmascarado con una simples sintaxis de planti-
llas(templates). Entonces que pasara si nosotros convinamos las dos fuerzas? De esta manera, nacio Smarty...

iv

Parte I. Iniciando

Tabla de contenidos
1. Que es Smarty? ................................................................................................................................. 2
2. Instalación ........................................................................................................................................ 3

1

Capítulo 1. Que es Smarty?

Smarty es un motor de plantillas para PHP. Mas especificamente, esta herramienta facilita la manera de separar la aplicación
lógica y el contenido en la presentación. La mejor descripción esta en una situación donde la aplicación del programador y
la plantilla del diseñador juegan diferentes roles, o en la mayoria de los casos no la misma persona. Por ejemplo: Digamos
que usted crea una pagina web, es decir, despliega el articulo de un diario. El encabezado del articulo, el rotulo, el autor y el
cuerpo son elementos del contenido, estos no contiene información de como quieren ser presentados. Estos son pasados por
la aplicación Smarty, donde el diseñador edita la plantilla, y usa una combinación de etiquetas HTML y etiquetas de planti-
lla para formatear la presentación de estos elementos (HTML, tablas, color de fondo, tamaño de letras, hojas de estilo,
etc...). Un día el programador necesita cambiar la manera de recuperar el contenido del articulo(un cambio en la aplicación
lógica.). Este cambio no afectara al diseñador de la plantilla, el contenido llegara a la plantilla exactamente igual. De la mis-
ma manera, si el diseñador de la plantilla quiere rediseñarla en su totalidad, estos cambios no afectaran la aplicación lógica.
Por lo tanto, el programador puede hacer cambios en la aplicación lógica sin que sea necesario restructurar la plantilla. Y el
diseñador de la plantilla puede hacer cambios sin que haya rompimiento con la aplicación lógica.

Ahora un pequeño resumen sobre que no hace Smarty. Smarty no intenta separar completamente la l