Guia Rápido Zend

Scripts de Layout

Em ambos os casos, entretanto, você precisará criar um script de layout. Scripts de layout simplesmente utilizam Zend_View (ou qualquer outra implementação de view que você esteja usando). Variáveis de layout são registradas com um marcador Zend_Layout, e podem ser acessadas via helper de marcador ou buscando-as como propriedades de objeto do objeto layout via helper de layout.

Como um exemplo:

<!DOCTYPE html
    PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html>
<head>
    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
    <title>Meu Site</title>
</head>
<body>
<?php
    // busca a chave 'content' usando um helper de layout:
    echo $this->layout()->content;

    // busca a chave 'foo' usando um helper marcador:
    echo $this->placeholder('Zend_Layout')->foo;

    // busca o objeto de layout e recupera várias chaves dele:
    $layout = $this->layout();
    echo $layout->bar;
    echo $layout->baz;
?>
</body>
</html>

Como Zend_Layout utiliza Zend_View para renderização, Você pode também usar quaisquer helpers de view registradas, e também ter acesso a quaisquer variáveis de view associadas. Particularmente útil são os vários helpers marcadores, que permitem a você recuperar conteúdo para áreas tais como a seção <head>, navegação, etc.:

<!DOCTYPE html
    PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html>
<head>
    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
    <?php echo $this->headTitle() ?>
    <?php echo $this->headScript() ?>
    <?php echo $this->headStyle() ?>
</head>
<body>
    <?php echo $this->render('header.phtml') ?>

    <div id="nav"><?php echo $this->placeholder('nav') ?></div>

    <div id="content"><?php echo $this->layout()->content ?></div>

    <?php echo $this->render('footer.phtml') ?>
</body>
</html>

Usando Zend_Layout com o MVC do Zend Framework

Zend_Controller oferece um rico conjunto de funcionalidades para extensão por meio de seus front controller plugins e action controller helpers. Zend_View também tem helpers. Zend_Layout toma vantagem desses diversos pontos de extensão quando usado com os componentes MVC.

Zend_Layout::startMvc() cria uma instância de Zend_Layout com qualquer configuração opcional que você fornecer. Ele registra então um front controller plugin que renderiza o layout com qualquer conteúdo de aplicação uma vez que o laço de despacho foi feito, e registra um action helper para permitir o acesso ao objeto layout a partir de seus action controllers. Adicionalmente, você pode a qualquer tempo pegar a instância de dentro de um view script usando o view helper Layout.

Primeiro, dê uma olhada em como inicializar Zend_Layout para uso com o MVC:

// Em seu bootstrap:
Zend_Layout::startMvc();

startMvc() pode tomar uma matriz opcional de opções ou um objeto Zend_Config para customizar a instância; essas opções são detalhadas nesta seção.

Em um action controller, você pode então acessar a instância de layout como um action helper:

class FooController extends Zend_Controller_Action
{
    public function barAction()
    {
        // desabilita layouts para este action:
        $this->_helper->layout->disableLayout();
    }

    public function bazAction()
    {
        // usa um script de layout diferente com este action:
        $this->_helper->layout->setLayout('foobaz');
    };
}

Em seus view scripts, você pode então acessar o objeto de layout via view helper Layout. Esse view helper é levemente diferente dos outros no que toca a não tomar argumentos, e retornar um objeto ao invés de um valor string. Isso permite que você imediatamente chame métodos no objeto de layout:

<?php $this->layout()->setLayout('foo'); // configura layout alternativo ?>

A qualquer tempo, você pode buscar a instância de Zend_Layout registrada com MVC via método estático getMvcInstance():

// Retorna null se startMvc() não foi o primeiro a ser chamado
$layout = Zend_Layout::getMvcInstance();

Finalmente, o front controller plugin de Zend_Layout tem uma importante característica em adição a renderização do layout: ele recupera todos os segmentos nomeados do objeto de resposta e associa variáveis, associando o segmento 'default' a variável 'content'. Isso permite a você acessar o conteúdo de sua aplicação e renderizá-lo em seus view scripts.

Como um exemplo, diremos que seu código primeiro ativa FooController::indexAction(), que renderiza algum conteúdo para o segmento de resposta padrão, e então prossegue para NavController::menuAction(), que renderiza conteúdo para o segmento de resposta 'nav'. Finalmente, você prossegue para CommentController::fetchAction() e busca alguns comentários, mas renderizar isso para o segmento de resposta é bom (o que adiciona conteúdo aquele segmento). Seu view script poderia então renderizar cada um separadamente:

<body>
    <!-- renders /nav/menu -->
    <div id="nav"><?php echo $this->layout()->nav ?></div>

    <!-- renders /foo/index + /comment/fetch -->
    <div id="content"><?php echo $this->layout()->content ?></div>
</body>

Essa característica é particularmente útil quando usada em conjunção com o action helper e plugin ActionStack, o qual você pode usar para configurar uma pilha de ações através da qual itertamos, e então criamos páginas widgetizadas.

Usando Zend_Layout como um Componente

Como um componente autônomo, Zend_Layout não oferece tantas características ou tanta conveniência como quanto é usado com o MVC. Entretanto, ele ainda tem dois benefícios a destacar:

Escopo de variáveis de layout.
Isolamento do view script de layout de outros scripts view.

Quando usado como um componente autônomo, simplesmente inicie o objeto layout, use os vários acessores para configurar estado, configure variáveis como propriedades de objeto, e renderize o layout:

$layout = new Zend_Layout();

// Configura um caminho de script de layout:
$layout->setLayoutPath('/path/to/layouts');

// Configura algumas variáveis:
$layout->content = $content;
$layout->nav     = $nav;

// Escolhe um script de layout diferente:
$layout->setLayout('foo');

// Renderiza o layout final
echo $layout->render();

Exemplo de Layout

Algumas vezes uma imagem vale mais que mil palavras. A seguir temos um exemplo de um script de layout.

A ordem real dos elementos pode variar, dependendo do CSS que você tenha configurado; por exemplo, se você está usando posicionamento absoluto, você pode ser capaz de ter a navegação exibida mais tarde no documento, mas ainda mostrar-se no topo; o mesmo poderia ser dito para a barra lateral ou o cabeçalho. A mecânica real de puxar o conteúdo permanece a mesma, entretanto.