IntroduçãoZend_View é uma classe para trabalhar com a parte de visualização do
padrão de projeto MVC. Basicamente ela existe para separar o script de visualização dos
controladores e modelos. Ela fornece um sistema de assistentes, filtros de saída e escape
de variáveis.
Zend_View é um sistema de template agnóstico; você pode usar o
PHP como sua linguagem de template, ou criar instâncias de outros
sistemas de template e manipulá-las dentro do seu script de visualização.
Essencialmente, o funcionamento do Zend_View acontece em duas etapas
principais: 1. Seu script controlador cria uma instância de
Zend_View, atribuindo-lhe variáveis. 2. O controlador instrui o
Zend_View a renderizar uma determinada visualização, passando o
controle ao script de visualização, responsável pela geração da saída a ser visualizada.
Script Controlador
Neste exemplo simples, suponhamos que seu controlador tenha uma listagem contendo dados
sobre livros, que queremos renderizar para uma visualização. O controlador poderia ser
algo como isto:
'Hernando de Soto',
'title' => 'The Mystery of Capitalism'
),
array(
'author' => 'Henry Hazlitt',
'title' => 'Economics in One Lesson'
),
array(
'author' => 'Milton Friedman',
'title' => 'Free to Choose'
)
);
// agora atribua os dados do livro a uma instância Zend_View
Zend_Loader::loadClass('Zend_View');
$view = new Zend_View();
$view->books = $data;
// e renderize um script de visualização chamado "booklist.php"
echo $view->render('booklist.php');
]]>Script Visualizador
Agora necessitaremos do script de visualização associado, "booklist.php". Trata-se de um
script PHP como qualquer outro, com uma exceção: ele executa dentro
do escopo da instância de Zend_View, o que implica que as
referências a $this apontam para as propriedades e métodos da instância
Zend_View. (Variáveis atribuídas à instância pelo controlador são
propriedades públicas da instância de Zend_View). Deste modo, um
script de visualização muito básico poderia se parecer com isto:
books): ?>
Autor
Título
books as $key => $val): ?>
escape($val['author']) ?>
escape($val['title']) ?>
Não existem livros a serem exibidos.
]]>
Observe a forma como empregamos o método "escape()" para escapar o conteúdo das
variáveis para a saída.
OpçõesZend_View possui diversas opções que podem ser definidas para
configurar o comportamento de seus scripts de visualização.
basePath: indica o caminho base na qual será definido os
caminhos dos scripts, assistentes e filtros. Ele assume uma estrutura de
diretórios de:
Isto pode ser definido via setBasePath(),
addBasePath() ou passar a opção
basePath para o construtor.
encoding: indica a codificação de caracteres para usar com
htmlentities(),
htmlspecialchars(), e outras operações. O padrão é
UTF-8. Pode ser definido através setEncoding() ou
passar a opção encoding para o construtor.
escape: indica uma chamada de retorno para ser usada por
escape(). Pode ser definido através
setEscape() ou passar a opção escape para
o construtor.
filter: indica um filtro para uso após a renderização de um
script de visualização. Pode ser definido através
setFilter(), addFilter() ou
passar a opção filter para o construtor.
strictVars: força Zend_View para
emitir avisos e alertas quando as variáveis de visualização não inicializadas
são acessadas. Pode ser definido chamando
strictVars(true) ou passar a opção
strictVars para o construtor.
Tags Curtas em Scripts de Visualização
Em nossos exemplos, fazemos uso das tags longas do PHP:
<?php. Nós também favorecemos o uso da sintaxe
alternativa para estruturas de controle. Estes são atalhos convenientes para
usar quando escrevemos scripts de visualização, pois fazem as construções mais concisas,
mantem as declarações sobre linhas simples e eliminam a necessidade de caçar os
parênteses dentro de HTML.
In previous versions, we often recommended using short tags (<?
and <?=), as they make the view scripts slightly less verbose.
However, the default for the php.inishort_open_tag setting is typically off in production or on shared
hosts -- making their use not terribly portable. If you use template
XML in view scripts, short open tags will cause the templates to fail
validation. Finally, if you use short tags when short_open_tag is
off, the view scripts will either cause errors or simply echo PHP
code back to the viewer.
If, despite these warnings, you wish to use short tags but they are disabled, you have
two options:
Turn on short tags in your .htaccess file:
This will only be possible if you are allowed to create and
utilize .htaccess files. This directive can
also be added to your httpd.conf file.
Enable an optional stream wrapper to convert short tags to
long tags on the fly:
setUseStreamWrapper(true);
]]>
This registers Zend_View_Stream as a stream
wrapper for view scripts, and will ensure that your code
continues to work as if short tags were enabled.
View Stream Wrapper Degrades Performance
Usage of the stream wrapper will degrade
performance of your application, though actual benchmarks are
unavailable to quantify the amount of degradation. We recommend
that you either enable short tags, convert your scripts to use
full tags, or have a good partial and/or full page content
caching strategy in place.
Utility Accessors
Typically, you'll only ever need to call on assign(),
render(), or one of the methods for setting/adding
filter, helper, and script paths. However, if you wish to extend
Zend_View yourself, or need access to some of its
internals, a number of accessors exist:
getVars() will return all assigned variables.
clearVars() will clear all assigned variables;
useful when you wish to re-use a view object, but want to
control what variables are available.
getScriptPath($script) will retrieve the
resolved path to a given view script.
getScriptPaths() will retrieve all registered
script paths.
getHelperPath($helper) will retrieve the
resolved path to the named helper class.
getHelperPaths() will retrieve all registered
helper paths.
getFilterPath($filter) will retrieve the
resolved path to the named filter class.
getFilterPaths() will retrieve all registered
filter paths.