From 654a9cae43358c7eecf3b522e9876aa7815e2453 Mon Sep 17 00:00:00 2001 From: Fabio Bas Date: Mon, 7 Dec 2015 15:57:51 +0100 Subject: Move urls from pradosoft.com to github's project page; drop unmaintained quickstart tutorial translations --- .../pages/GettingStarted/fr/AboutPrado.page | 71 ---------------- .../pages/GettingStarted/fr/CommandLine.page | 94 --------------------- .../pages/GettingStarted/fr/HelloWorld.page | 83 ------------------ .../pages/GettingStarted/fr/Installation.page | 29 ------- .../pages/GettingStarted/fr/Introduction.page | 19 ----- .../pages/GettingStarted/fr/NewFeatures.page | 24 ------ .../pages/GettingStarted/fr/Upgrading.page | 63 -------------- .../pages/GettingStarted/fr/directory.gif | Bin 2685 -> 0 bytes .../protected/pages/GettingStarted/fr/sequence.gif | Bin 5793 -> 0 bytes 9 files changed, 383 deletions(-) delete mode 100755 demos/quickstart/protected/pages/GettingStarted/fr/AboutPrado.page delete mode 100755 demos/quickstart/protected/pages/GettingStarted/fr/CommandLine.page delete mode 100755 demos/quickstart/protected/pages/GettingStarted/fr/HelloWorld.page delete mode 100755 demos/quickstart/protected/pages/GettingStarted/fr/Installation.page delete mode 100755 demos/quickstart/protected/pages/GettingStarted/fr/Introduction.page delete mode 100755 demos/quickstart/protected/pages/GettingStarted/fr/NewFeatures.page delete mode 100755 demos/quickstart/protected/pages/GettingStarted/fr/Upgrading.page delete mode 100755 demos/quickstart/protected/pages/GettingStarted/fr/directory.gif delete mode 100755 demos/quickstart/protected/pages/GettingStarted/fr/sequence.gif (limited to 'demos/quickstart/protected/pages/GettingStarted/fr') diff --git a/demos/quickstart/protected/pages/GettingStarted/fr/AboutPrado.page b/demos/quickstart/protected/pages/GettingStarted/fr/AboutPrado.page deleted file mode 100755 index 25bb0bc7..00000000 --- a/demos/quickstart/protected/pages/GettingStarted/fr/AboutPrado.page +++ /dev/null @@ -1,71 +0,0 @@ - -

Qu'est-ce que PRADO ?

-

-PRADO est un framework de programmation évènementielle basé sur des composants pour développer des applications Web en PHP5. PRADO signifie PHP Rapid Application Development Object-oriented. -

-

-Le but principal de PRADO est la réutilisation maximale de code dans la programmation Web. Par réutilisation, cela ne se limite pas à son propre code mais aussi celui d'autres développeurs, de manière la plus aisée possible. Cela est très important car cela évite de réinventer la roue et peut donc réduire de façon significative le temps de développement. L'introduction du concept de composant provient de cela. -

-

-Afin de parvenir au but ci-dessus, PRADO stipule un protocole d'écriture et d'utilisation des composants afin de construire des applications Web. Un composant est une brique logicielle qui peut être réutilisée avec quelques modifications. De nouveaux composants peuvent ainsi être construits en utilisant des composants existants. -

-

-Afin de faciliter l'intéraction avec les composants, PRADO implémente une programmation évènementielle qui permet la délégation des comportements aux composants. Les actions des utilisateurs comme le click sur un bouton de type submit sont capturées comme des évènements serveurs. Des méthodes ou fonctions peuvent être attachées à ces évènements et lorsque l'évènement se produit, elles sont automatiquement invoquées afin de répondre à ces même évènements. Comparé à la traditionnelle programmation Web où les développeurs doivent utiliser les variables POST ou GET, la programmation évènementielle aide les développeurs à se consacrer à la logique et réduit de façon significative le code répétitif. -

-

-Développer une application Web avec PRADO se résume à instancier des composants existants, les configurer en définissant leurs propriétés, leur affecter des fonctions répondants à ces mêmes évènements, et ainsi composer les pages de l'application. Cela est très similaire aux développants à l'aide de RAD, comme Borland Delphi et Microsoft Visual Basic, qui sont utilisés pour développer des applications GUI. -

- -

Pourquoi PRADO ?

-

-PRADO est le plus souvent cité comme un framework unique. En fait, il est tellement unique qu'il peut changer votre programmation PHP en une tâche amusante. La liste suivante est un rapide résumé des principales fonctionnalités de PRADO, -

- - -

Pour quelles applications PRADO est-il adapté ?

-

-PRADO est le plus adapté pour des applications Web très interactives. Il peut être utilisé pour développer des systèmes simples comme un blog, ou complexes comme un système de gestion de contenu (CMS), ou une solution complète de e-commerce. Puisque PRADO est basé sur une programmation orientée objet à travers sa méthodologie de composants, il convient particulièrement bien pour le travail en équipe et le développement d'entreprise. -

-

-PRADO intègre un système de cache complet qui peut aider les applications à tenir des charges de traffic élevées. Son architecture modulaire permet aux développeurs d'utiliser des modules de cache différents pour chaque besoin. Le cache peut s'effectuer sur toute ou partie d'une page Web. -

- -

Comment est PRADO comparé à d'autres Frameworks ?

-

-PRADO est souvent cité comme un framework unique. Sa particularité est principalement liée à la gestion des composants et à la programmation évènementielle qu'il essaie de promouvoir. Bien que ce paradigme ne soit pas nouveau dans la programmation d'application GUI, PRADO est peut-être le premier framework PHP à l'intégrer. -

-

-La plupart des frameworks PHP se focalise principalement sur la séparation des couches de présentation et de la logique en utilisant le design pattern MVC (Model-Vue-Contrôleur). PRADO atteint le même but en imposant que la logique se situe dans des classes et la présentation dans des templates. PRADO fait beaucoup plus sur d'autres aspects que le MVC. Il comble des manque dans la programmation PHP avec son modèle de composants Web riches, son support robuste des bases de données, sa gestion d'erreur flexible et beaucoup d'autre... -

- -

PRADO est-il assez stable ?

-

-Oui. Le projet PRADO a débuté en août 2004. Beaucoup de tests unitaires ont été écrits et fréquemment éxecutés afin d'assurer sa qualité. Il a été utilisé par des milliers de développeurs et beaucoup d'applications sont basés sur celui-ci. Les bugs et les demandes de fonctionnalités sont gérées à travers le système TRAC, nous avons une grande communauté d'utilisateurs et une équipe de développement afin d'assurer que toutes les questions sont répondues en un temps record. -

- -

Histoire de PRADO

-

-L'inspiration originale de PRADO vient de Apache Tapestry. Pendant le design et l'implémentation, j'ai emprunté beaucoup d'idées de Borland Delphi et Microsoft ASP.NET. La première version de PRADO a vue le jour en juin 2004 et était écrite en PHP4. Conduit par le concours de codage de Zend, j'ai réécrit PRADO en PHP5, qui est un changement majeur grâce au nouveau modèle objet fourni par PHP5. PRADO a remporté le grand prix du concours grâce aux votes du public ainsi que du jury. -

-

-En août 2004, PRADO a commencé à être hébergé sur SourceForge en projet Open Source. Peu après, le site du projet xisc.com a été annoncé au public. Grâce au fantastique support de l'équipe de développement et des utilisateurs de PRADO, PRADO a évolué en version 2.0 mi 2005. Dans cette version, Wei Zhuo a contribué à PRADO avec le support I18N et L10N. -

-

-En mai 2005, nous avons décidé de réécrire complètement le framework PRADO afin de résoudre quelques problèmes trouvés dans la version 2.0 et ajouter des fonctionnalités disponibles dans Microsoft ASP.NET 2.0. Après près d'un an de dur labeur et 50.000 lignes de nouveau code, la version 3.0 était finalement disponible en avril 2006. -

-

-Au démarrage de la version 3.0, des efforts significatifs ont été fournis afin d'assurer la qualité et la stabilité de PRADO. Si PRADO v2.x et v1.x sont la preuve du concept, nous pouvons affirmer que PRADO v3.x est un projet qui est désormais adapté pour le développement d'applications métiers. -

-
diff --git a/demos/quickstart/protected/pages/GettingStarted/fr/CommandLine.page b/demos/quickstart/protected/pages/GettingStarted/fr/CommandLine.page deleted file mode 100755 index d1406928..00000000 --- a/demos/quickstart/protected/pages/GettingStarted/fr/CommandLine.page +++ /dev/null @@ -1,94 +0,0 @@ - -

Outil en ligne de commande

-

Le script optionnel prado-cli.php du répertoire framework est un outil en ligne de commande destiné à éxecuter certaines tâches dans PRADO. -Le script prado-cli.php peut être utilisé pour créer le squelette de projet PRADO, des fichiers tests et accéder à un shell interactif PHP. -

-

Pré-requis

-

-Afin d'utiliser l'outil en ligne de commande, vous aurez à utiliser une console. De plus, PHP doit être capable d'éxecuter des scripts en ligne de commande. -

- -

Utilisation

-

-Si vous tapez php chemin/vers/framework/prado-cli.php, vous devez voir les informations suivantes. Alternativement, si vous n'êtes pas sous Windows, vous pouvez essayer de transformer le fichier prado-cli.php en un éxecutable

- -Command line tools for Prado 3.0.5. -usage: php prado-cli.php action [optional] -example: php prado-cli.php -c mysite - -actions: - -c - Creates a Prado project skeleton for the given . - - -t - Create test fixtures in the given . - - shell [directory] - Runs a PHP interactive interpreter. Initializes the Prado - application in the given [directory]. - - -

Les <parameter> sont les paramètres requis et [optional] -désignent les paramètres optionnels.

- -

Créer un nouveau squelette de projet PRADO

- -

Afin de créer un squelettre de projet PRADO, suivez les instructions suivantes :

-
    -
  1. Placez-vous dans le dossier où vous souhaitez créer le projet.
  2. -
  3. Tapez, php ../prado/framework/prado-cli.php -c helloworld, où - helloworld est le nom du dossier où vous souhaitez créer le squelette.
  4. -
  5. Tapez, php ../prado/framework/prado-cli.php -t helloworld afin de créer les fichiers tests du projet helloworld.
  6. -
- -

Shell interactif

-

-Le shell interactif vous permet d'évaluer des scripts PHP directement en ligne de commande. -Le script prado-cli.php peut être utilisé pour démarrer le shell et charger un projet PRADO existant. -Par exemple, chargons le projet de démo blog. En supposant que votre console se situe actuellement dans le répertoire prado de la distribution, tapez : -

-

- -$: php framework/prado-cli.php shell demos/blog - -Le résultat doit être - -Command line tools for Prado 3.0.5. -** Loaded Prado application in directory "demos\blog\protected". -PHP-Shell - Version 0.3.1 -(c) 2006, Jan Kneschke - ->> use '?' to open the inline help - ->> - -Ensuite, nous allons appeler une instance de l'application du blog PRADO, et de cette instance nous allons créer une instance du module'data'. Notez qu'un point-virgule à la fin de la ligne n'affiche pas la sortie. - - ->> $app = Prado::getApplication(); - ->> $db = $app->getModule('data'); - -Pour finir, nous voulons utiliser le module 'data' pour récupérer le post ayant l'ID=1. Notez que nous n'avons pas mis de point-virgule afin de voir le résultat de la commande. - ->> $db->queryPostByID(1) - -Aucune erreur ne doit se produire et vous devez dorénavant voir : - -PostRecord#1 -( - [ID] => 1 - [AuthorID] => 1 - [AuthorName] => 'Prado User' - [CreateTime] => 1148819691 - [ModifyTime] => 0 - [Title] => 'Welcome to Prado Weblog' - [Content] => 'Congratulations! You have successfully installed Prado Blog -- - a PRADO-driven weblog system. A default administrator account has been created. - Please login with admin/prado and update your password as soon as possible.' - [Status] => 0 - [CommentCount] => 0 -) - -

-
diff --git a/demos/quickstart/protected/pages/GettingStarted/fr/HelloWorld.page b/demos/quickstart/protected/pages/GettingStarted/fr/HelloWorld.page deleted file mode 100755 index 1e0f5574..00000000 --- a/demos/quickstart/protected/pages/GettingStarted/fr/HelloWorld.page +++ /dev/null @@ -1,83 +0,0 @@ - -

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. -

- - -
-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. -

- -
-

-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. -

-
- -
diff --git a/demos/quickstart/protected/pages/GettingStarted/fr/Installation.page b/demos/quickstart/protected/pages/GettingStarted/fr/Installation.page deleted file mode 100755 index 04b31cef..00000000 --- a/demos/quickstart/protected/pages/GettingStarted/fr/Installation.page +++ /dev/null @@ -1,29 +0,0 @@ - -

Installer PRADO

-
-

-Si vous voyez cette page à partir de votre serveur Web, c'est que l'installation s'est déjà bien déroulée. -

-

-La configuration minimum requise par PRADO est que le serveur Web supporte PHP 5. PRADO a été testé avec un serveur Apache sur une platforme Windows et Linux. Il est fort possible qu'il fonctionne avec d'autres platformes avec d'autres types de serveurs Web tant que PHP 5 est supporté. -

-
- -
-

-L'installation de PRADO se résume principalement au téléchargement et à la décompression des sources. -

-
    -
  1. Rendez-vous sur pradosoft.com afin de récupérer la dernière version de PRADO.
  2. -
  3. Décompressez le fichier PRADO dans le répertoire du serveur Web. -
-
-
-

-Votre installation de PRADO est terminée et vous pouvez commencer à utiliser les applications de démonstration incluses dans PRADO avec l'URL http://web-server-address/prado/demos/. Ici nous supposons que PRADO est décompressé dans le sous-répertoire prado sous le répertoire racine du serveur Web. -

-

-Si vous rencontrez un problème avec les applications de démonstration, merci d'utiliser le script de vérification des pré-requis de PRADO, accessible à l'adresse http://web-server-address/prado/requirements/index.php, afin de vérifier que votre configuration réponds bien aux exigences de PRADO. -

-
-
diff --git a/demos/quickstart/protected/pages/GettingStarted/fr/Introduction.page b/demos/quickstart/protected/pages/GettingStarted/fr/Introduction.page deleted file mode 100755 index 2a7768ee..00000000 --- a/demos/quickstart/protected/pages/GettingStarted/fr/Introduction.page +++ /dev/null @@ -1,19 +0,0 @@ - -

Bienvenue sur le tutorial de démarrage rapide de PRADO

-
-

-Ce tutorial est destiné à vous aider rapidement à créer votre propre application Web basée sur PRADO version 3.X. -

-

-Vous pouvez vous réferrer aux ressouces suivantes si vous trouvez que ce tutorial ne correspond pas à vos besoins. -

-
- - -
diff --git a/demos/quickstart/protected/pages/GettingStarted/fr/NewFeatures.page b/demos/quickstart/protected/pages/GettingStarted/fr/NewFeatures.page deleted file mode 100755 index 7e0805c4..00000000 --- a/demos/quickstart/protected/pages/GettingStarted/fr/NewFeatures.page +++ /dev/null @@ -1,24 +0,0 @@ - - -

Nouvelles fonctionnalités

- -

-Cette page résume les principale fonctionnalités introduites dans chaque version de PRADO. -

- -

Version 3.1.0

- - -
diff --git a/demos/quickstart/protected/pages/GettingStarted/fr/Upgrading.page b/demos/quickstart/protected/pages/GettingStarted/fr/Upgrading.page deleted file mode 100755 index 18d3b218..00000000 --- a/demos/quickstart/protected/pages/GettingStarted/fr/Upgrading.page +++ /dev/null @@ -1,63 +0,0 @@ - - -

Mise à jour à partir des versions v2.x et v1.x

- -
-

-PRADO v3.0 n'est pas rétro-compatible avec les versions précédents de PRADO. -

-

-La bonne nouvelle est que les propriétés et que les évènements de la plupart des contrôles restent identiques ainsi que la syntaxe des templates qui reste largement inchangée. Par conséquent, les connaissances des développeurs des anciennes versions restent applicables dans la v3.0. -

-

-Nous résumons ci-dessous les changements les plus significatifs de la v3.0 afin d'aider les développeurs à migrer leurs applications v2.x et v1.x plus facilement, si besoin est. -

-
- -

Définition des composants

-

-La version 3.0 a complètement changé de besoin de fichiers de spécifications des composants. Il se fonde davantage sur des conventions pour définir les propriétés et les événements des composants . En particulié, une propriété est définit par la présence d'une méthode getter et/ou setter, tandis qu'un évènement est définit par l'existance d'une méthode on... .Les noms des propriétés et évènements dans la v3.0 sont tous les deux case-insensitive. Par conséquence, les développeurs sont désormais obligés de faire attention aux conversions de type lorsque la propriété d'un composant est définie. Par example, le code suivant est utilisé afin de définir la propriété Enabled propriétaire d'un TControl, qui est un type booléen, -

- -public function setEnabled($value) -{ - $value=TPropertyValue::ensureBoolean($value); - $this->setViewState('Enabled',$value,true); -} - -

-où la fonction TPropertyValue::ensureBoolean() est utilisée afin de s'assurer que la variable est bien un booléen. Ceci car lorsque la propriété est configurée dans un template, une chaîne de caractère est passée au setter. Dans les versions précédentes, PRADO connaissait le type de chaque propriété des composants grâce aux fichiers de spécifications et se chargeait de la conversion de type pour vous. -

- -

Contrôleur de l'application

-

-Le contrôleur de l'application implémente désormais une architecture modulaire. Les modules peuvent être ajoutés et configurés dans la configuration de l'application. Chaque module assure une fonction particulière et ils peuvent être coordonnés entre eux par le cycle de vie de l'application. Le concept des modules de la version 2.x a été replacé dans la v3.0 par les répertoires des pages. En conséquence, le format de configuration de l'application de la v3.0 est très différent des versions précédentes. -

- -

Pages

-

-Les pages dans la version 3.0 sont organisés dans des répertoires qui peuvent être comparés au concept des modules de la v2.x. Les pages sont demandées selon leur structure. Par exemple, une URL index.php?page=Controls.Samples.Sample1 sera utilisée pour servir une page nommée Sample1 se trouvant dans le répertoire [BasePath]/Controls/Samples, où [BasePath] se réfère au répertoire racine des pages. Le nom d'un fichier template d'une page doit avoir comme extension .page, principalement pour différencier les templates des pages des templates des contrôles qui se termineront par l'extension .tpl. -

- -

Relation des contrôles

-

-La version 3.0 redéfinit les relations entre les contrôles. En particulier, la relation parent-enfant se réfère désormais à la relation entre les contrôles et la présentation. Un nouveau nom de relation est introduit afin d'aider la gestion des identifiants des contrôles. Pour plus de détails, voir la section concernant les contrôles. -

- -

Syntaxe des Templates

-
-

-La syntaxe des contrôles dans les templates de la v3.0 est très similaire à celle des versions précédentes avec beaucoup d'améliorations. Un changement important est au sujet des expression dans le databinding. Dans la v3.0, cela est fait de la façon suivante,

- -<com:MyComponent PropertyName=<%# PHP expression %> .../> - -

-Les expressions et les tags d'états ont aussi changé. Pour plus de détails, voir la section concernant la définition des templates. -

-
-

Syntaxe des Thèmes

-

-Les thèmes dans la v3.0 sont définis comme les contrôles des templates avec quelques restrictions. -

- -
diff --git a/demos/quickstart/protected/pages/GettingStarted/fr/directory.gif b/demos/quickstart/protected/pages/GettingStarted/fr/directory.gif deleted file mode 100755 index e6c4f724..00000000 Binary files a/demos/quickstart/protected/pages/GettingStarted/fr/directory.gif and /dev/null differ diff --git a/demos/quickstart/protected/pages/GettingStarted/fr/sequence.gif b/demos/quickstart/protected/pages/GettingStarted/fr/sequence.gif deleted file mode 100755 index 4207a9bb..00000000 Binary files a/demos/quickstart/protected/pages/GettingStarted/fr/sequence.gif and /dev/null differ -- cgit v1.2.3