Ma première application PRADO

-Dans cette partie, nous allons vous guider afin de créer votre première application PRADO, la fameuse application "Hello World". -

-"Hello World" est peut-être l'application PRADO la plus simple et interactive que vous pouvez créer. Cela affiche une page avec un bouton où il est affiché Click Me. Lorsque l'utilisateur clicke sur la bouton, il est affiché Hello World. -

-Il y a plusieurs approches afin d'arriver au but ci-dessus. On peut envoyer la page au serveur, vérifier le contenu de la variable POST, et générer une nouvelle page avec le texte du bouton modifié. On peut également simplement utiliser du javascript afin de mettre à jour le libellé du bouton après l'évènement onclick. -

-PRADO privilégie une programmation évènementielle basée sur des composants. Le bouton est représenté par un objet TButton. Celui-ci comprend le libellé du bouton en tant que propriété Text et associe l'évènement "click" avec un évènement serveur OnClick. Afin de répondre à l'action de l'utilisateur sur le click du bouton, il suffit simplement d'attacher une fonction à l'évènement OnClick du bouton. Dans cette fonction, la propriété Text est modifiée en "Hello World". Le diagramme suivant image la séquence ci-dessus : -

-Notre application PRADO sera composée de trois fichiers, index.php, Home.page et Home.php, qui sont organisés de la façon suivante : -

- -où chaque répertoire est expliqué comme suit. Notez que la structure des répertoire peut être personnalisée. Par example, le dossier protected peut se trouver hors du répertoire Web public. Vous saurez comment faire à la suite de ce tutorial. -

assets - dossier de stockage des fichiers publiés privés. Voir la partie "assets" pour plus de détails. Le processus du serveur Web doit avoir les droits d'écriture sur ce répertoire.

protected - répertoire de base de l'application comprenant les données et fichiers privés. Ce répertoire se doit de ne pas être accessible au public.

runtime - répertoire de stockage des fichiers d'éxecution de l'application, comme des données de cache, etc. Le processus du serveur Web doit avoir les droits d'écriture sur ce répertoire.

pages - répertoire de base des pages PRADO.

-Astuce :Vous pouvez également utiliser le script framework/prado-cli.php -en ligne de commande -afin de créer la structure de votre projet PRADO. Par exemple, tapez la commande -php path/to/prado-cli.php -c helloworld dans le dossier où vous souhaitez créer votre projet helloworld. -

-Les trois fichiers dont nous avons besoin sont expliqués comme suit. -

index.php - script d'entrée de notre application PRADO. Ce fichier est requis par toutes les applications PRADO et il s'agit du seul script accessible par les utilisateurs finaux. Le contenu du fichier index.php consiste principalement aux trois lignes suivantes : - -require_once('path/to/prado.php'); // include du script prado -$application=new TApplication; // création de l'instance de l'application PRADO -$application->run(); // démarrage de l'application - -

Home.page - template de la page par défaut retournée lorsque les utilisateurs ne spécifient pas de façon explicite la page demandée. Un template désigne la présentation des composants. Dans cet exemple, nous utiliserons deux composants,TForm et TButton, qui correspondent respectivement aux tags HTML <form> et <input>. Le fichier template contient le contenu suivant : - - - - <com:TForm> - <com:TButton Text="Click me" OnClick="buttonClicked" /> - </com:TForm> - - - -

Home.php - fichier de classe pour la page Home page. Celui-ci contient principalement la méthode répondant à l'évènement OnClick du bouton. - -class Home extends TPage -{ - public function buttonClicked($sender,$param) - { - // $sender se rapporte au composant bouton - $sender->Text="Hello World!"; - } -} - -

-L'application is maintenant prête et est accesible à l'adresse -The application is now ready and can be accessed via: http://Web-server-address/helloworld/index.php, en supposant que helloworld soit directement sous la racine de votre serveur. Essayez de modifier le TButton de la page Home.page en TLinkButton et voyez ce qui se produit. -

-Le code source complet de cette démonstration peut être téléchargé dans la release de PRADO. Vous pouvez également essayer la démonstration en ligne. -