Moja pierwsza aplikacja w PRADO

-W tej sekcji, przeprowadzimy Cię przez proces tworzenia Twojej pierwszej aplikcaji w PRADO, słynną aplikację "Witaj świecie" (ang. "Hello World"). -

-"Witaj świecie" prawdopodobnie jest najprostszą interaktywną aplikacją w PRADO, którą możesz stworzyć. Wyświetla ona użytkownikowu końcowemu stronę z przyciskiem, którego napis to Kliknij mnie (ang. Click Me). Po tym jak użytkownik kliknie na przycisk, jego napis zmienia się na Witaj świecie. -

-Jest wiele dróg aby osiągnąć ten cel. Można przesłać (ang. submit) stronę do serwera, sprawdzić zmienną POST i wygenerować nową stronę z przyciskiem ze zaktualizowanym napisem. Można też przez proste użycie JavaScript zaktualizować napis podczas zdarzenia OnClick po stronie klienta. -

-PRADO promuje programowanie sterowane zdarzeniami i bazujące na komponentach. Przycisk jest reprezentowany przez obiekt TButton. Hermetyzuje on napis na przycisku jako właściwość Text przycisku oraz wiąże akcję naciśnięcia przez użytkownika przycisku ze zdarzeniem po stronie serwera OnClick. Aby odpowiedzieć na naciśnięcie przez użytkownika przycisku, należy po prostu przypisać funkcję do zdarzenia OnClick przycisku. Wewnątrz funkcji, właściwość Text przycisku jest zmodyfikowana na "Witaj świecie". Poniższy diagram pokazuje powyższą sekwencję. -

-Nasza aplikacja PRADO składa się z trzech plików index.php, Home.page and Home.php, które są zorganizowane w poniższy sposób, -

- -gdzie każdy katalog należy rozumieć następująco. Zauważ, że powyższa struktura katalogów jest rozszerzalna. Na przykład, można przenieść katalog protected poza katalog WWW. Będziesz wiedział jak tego dokonać, jeśli przejdziesz przez ten przewodnik. -

assets - katalog zawierający upublicznione prywatne pliki. Zobacz sekcję assets by dowiedzieć się więcej. Katalog ten musi być zapisywalny przez proces serwera.

protected - podstawowa ścieżka aplikacji zawierająca dane aplikacji oraz prywatne skrypty plików. Katalog ten powinien być skonfigurowany jako niedostępny dla użytkownika końcowego.

runtime - składująca uruchomieniowa ścieżka aplikacji (ang. application runtime storage path) przechowuje informacje rurchomieniowe aplikacji, takie jak stan aplikacji, keszowane dane, itp. Katalog ten musi być zapisywalny przez proces serwera.

pages - podstawowa ścieżka przechowująca wszystkie strony PRADO.

-Podpowiedż:Możesz również użyć framework/prado-cli.php -narzędzia linii poleceń -aby stworzyć strukturę katalogów dla projektu w PRADO. Na przykład, wpisz komendę -php ścieżka/do/prado-cli.php -c helloworld w katalogu gdzie chcesz stworzyć projekt helloworld (witaj świecie). -

-Trzy pliki, krórych potrzebujemy, kolejno oznaczają -

index.php - skrypt wejściowy aplikacji PRADO. Ten plik jest wymagany prez wszyskie aplikacje PRADO i jest jedynym skryptem, który jest bezpośrednio dostępny przez użytkownika końcowego. Zawartość index.php przeważnie zawiera następujące trzy linie, - -require_once('path/to/prado.php'); // załącz skrypt PRADO -$application=new TApplication; // utwórz instancję aplikacji PRADO -$application->run(); // uruchom aplikację - -

Home.page - szablon dla domyślnej strony, zwracany gdy użytkownik nie wybierze jawnie żadnej strony. Szablon określa warstwę prezentacji komponentów. W tym przykładzie, używamy dwóch komponentów, TForm oraz TButton, które odpowiadają odpowiednio znacznikom HTML <form> oraz <input>. Szablon posiada następującą treść - - - - <com:TForm> - <com:TButton Text="Kliknij mnie" OnClick="buttonClicked" /> - </com:TForm> - - - -

Home.php - klasa strony dla strony głównej Home. Zawieta przeważnie metody odpowiadające na zdarzeniaOnClick przycisku. - -class Home extends TPage -{ - public function buttonClicked($sender,$param) - { - // $sender wskazuje na komponent przycisku - $sender->Text="Witaj świecie!"; - } -} - -

-Aplikacja jest teraz gotowa i jest dostępna poprzez adres http://adres-serwera/helloworld/index.php, zakładając, że helloworld znajduje się bezpośrenio w KataloguGłównymDokumentó serwera (ang. DocumentRoot). Spróbuj zmienić TButton w Home.page na TLinkButton i zobacz co się stanie. -

-Kompletne źródło kodu dla tego demo można znaleźć w wydaniu PRADO. Możesz również spróbować demo online. -