Aplikacja

Aplikacja jest instancją TApplication lub klasy po niej dziedziczącej. Zarządza modułami dostarczającymi różnorodne funkcjonalności i ładuje je w razie potrzeby. Dostarcza użytkownikowu końcowemu serwisy. Jest centralnym miejscem do przechowywania różnych parametrów używanych w aplikacji. W aplikacji PRADO instancja aplikacji jest jedynym globalnie dostepnym obiektem poprzez wywołania funkcji Prado::getApplication().

Aplikacje są konfigurowane poprzez konfigurację aplikacji. Są zazwyczaj tworzone w skrypcie wejściowym w podobny do następującego sposób, require_once('/path/to/prado.php'); $application = new TApplication; $application->run(); gdzie metoda run() rozpoczyna działanie aplikacji obsługującej żądania użytkownika.

Organizacja folderów

Minimalna aplikacja PRADO zawiera dwa pliki: plik wejściowy i plik szablonu. Muszą być one zorganizowane w następujący sposób.

• wwwroot - główny katalog serwera WWW lub jeden z podkatalogów.
• index.php - skrypt wejściowy aplikacji PRADO.
• assets - katalog przechowujący opublikowane pliki prywatne. Zobacz sekcję assets.
• protected - podstawowa ścieżka aplikacji zawierająca jej dane oraz prywatne pliki skryptów. Ten folder powinien być niedostepny z zewnątrz lub powinien znajdować się poza strukturą serwera WWW.
• runtime - application runtime storage path. Ten folder jest używany przez PRADO do przechowywania informacji o wykonywanej aplikacji, takich jak stan aplikacji, kedzowane dane, itd.
• pages - podstawowa ścieżka przechowująca wszystkie strony PRADO. Zobacz sekcję serwisy.
• Home.page - domyślna strona zwracana gdy użytkownik nie poda jawnie żadanej strony. Jest to plik szablonu strony. Nazwa pliku bez rozszerzenia jest nazwą strony. Klasą strony jest klasa TPage. Jeśli znajduje się tam również plik klasy Home.php, klasą strony staje się Home.

Produktywna aplikacja PRADO zazwyczaj potrzebuje więcej plików. Może ona zawierać plik konfiguracji aplikacji application.xml w podstawej ścieżce aplikacji protected. Strony mogą być zorganizowane w foldery, część z nich może zawierać pliki konfiguracji strony config.xml. Aby dowiedzieć się wiecej, zajrzyć do sekcji konfiguracji.

Osadzanie aplikacji

Osadzanie aplikacji PRADO zazwyczaj wiąże się z kopiowaniem folderów. Na przykład, aby osadzić powyższą minimalną wersję aplikacji na innym serwerze należy wykonać następujące kroki.

1. Skopiuj zawartość z wwwroot do dostępnego poprzez WWW foldera na nowym serwerze.
2. Zmodyfikuj skrypt wejściowy index.php tak by prawidłowo inkludował plik prado.php.
3. Usuń całą zawartość z folderów assets i runtime i upewnij się, że oba umożliwiają zapis procesom serwera WWW.

Cykle życia aplikacji

Tak jak cykle życia strony tak aplikacja również posiada cykle życia. Moduły aplikacji mogą rejestrować zdarzenia dla cykli życia. Kiedy aplikacja znajduje się w konkretnym cyklu i wywołuje odpowiednie zdarzenie, zarejstrowana metoda modułu jest wywoływana automatycznie. Moduły załaczone w oficjalnym wydaniu PRADO, takie jak TAuthManager, używają tego sposobu aby wyknać swoje zadania.

Cykle życia aplikacji mogą zostać przedstawione następująco: