Pt:Aplicacoes

Voltar à página principal

Uma Aplicação é uma instância de TApplication ou se suas classes filhas. Ela gerencia módulos que fornecem diferentes funcionalidades e que são carregados quando necessários. Fornece serviços aos usuários. É o lugar central para armazenar vários parâmetros utilizados numa aplicação. Numa aplicação PRADO, a instância da aplicação é o único objeto globalmente acessado chamando a função Prado::getApplication().

As aplicações são configuradas através de arquivos XML. Veja Configuração das Aplicações. São normalmente criadas em scripts de entrada como o seguinte:

require_once('/path/to/prado.php');
$application = new TApplication;
$application->run();

onde o método run() inicia a aplicação para cuidar das requisições dos usuários.

Organização de Diretórios

---

Uma aplicação PRADO mínima contém dois arquivos: um arquivo de entrada e um arquivo de template de página. Eles devem estar organizados como segue:

+ wwwroot
     |
     + assets
     |
     + protected
     |   |
     |   + pages
     |   |   |
     |   |   + Home.page
     |   |
     |   + runtime
     |
     + index.php

• wwwroot - raiz do documento web ou subdiretório
• index.php - script de entrada do aplicativo PRADO
• assets - diretório que armazena arquivos privados publicados. Veja a sessão assets
• protected - caminho base que armazena dados da aplicação e arquivos de script privados. Este diretório deve ser inacessível para a web ou pode ser situado fora dos diretórios web.
• runtime - caminho base que armazena arquivos em tempo de execussão. Este diretório é utilizado para armazenar informações em tempo de execussão, como o estado da aplicação, dados cacheados, etc.
• pages - caminho base do armazenamento de todas as páginas PRADO. Veja a sessão services
• Home.page - Página padrão retornada quando o usuário não especifica a página requisitada. Este arquivo é um template de página. O nome do arquivo sem sufixo é o nome da página. A classe de uma página é TPage. Se houver um arquivo de classe Home.php, a classe da página será Home.

Um aplicativo PRADO geralmente necessita de mais arquivos. Pode incluir um arquivo de configuração do aplicativo chamado application.xml sob o caminho base do aplicativo protected. As páginas podem ser organizadas em diretórios , alguns contendo arquivos de configuração de páginas chamados config.xml. Para mais detalhes veja a sessão de configurações.

Distribuição da Aplicação

---

Distriuir uma aplicação PRADO envolve principalmente copiar diretórios. Por exemplo, para distribuir uma aplicação mínima para um novo servidor, siga os passos:

1. Copie o conteúdo sob wwwroot para o diretório web acessível do novo servidor
2. Modifique o arquivo de entrada index.php para que inclua corretamente o arquivo prado.php
3. Remova todo o conteúdo dos diretórios assets e runtime e tenha a certeza de que ambos estão com atributo de gravação para o processo do servidor web

Cliclo de Vida de uma Aplicação