http://www.stato-framework.org/documentation/ 2010-04-27T08:07:51+02:00 http://www.stato-framework.org/documentation/ http://www.stato-framework.org/documentation/lib/images/favicon.ico text/html 2010-04-15T01:00:43+02:00 http://www.stato-framework.org/documentation/fr/associations?rev=1271286043&do=diff Déclaration Forme simplifiée : class Product extends SActiveRecord { public static $relationships = array ( 'group' => 'belongs_to', 'details' => 'has_many' ); } Dans le cas de la forme simplifiée, la classe de destination (option class_name) sera supposée porter le même nom que l'association, ou le singulier de ce nom si l'association est de type has_many ou many_to_many. text/html 2009-04-03T02:27:47+02:00 http://www.stato-framework.org/documentation/fr/caching?rev=1238718467&do=diff Caching de pages La totalité des données générées par une action est mise en cache sous forme de page HTML, que le serveur web peut délivrer directement sans faire appel à Stato. Le gain de performance est bien sûr énorme, mais cette forme de mise en cache ne peut être utilisée que sur des contenus statiques, auxquels les utilisateurs peuvent accéder sans être loggés. L'expiration du cache se fait manuellement, en appelant la méthode expire_page. text/html 2009-04-03T02:27:47+02:00 http://www.stato-framework.org/documentation/fr/controllers?rev=1238718467&do=diff Les contrôleurs vous permettent de définir des actions qui, après avoir rempli leur rôle, font le rendu d'un template ou redirigent vers une autre action. Chaque action est définie par une méthode publique qui sera rendu accessible lors d'une requête par le biais du Routing. text/html 2009-04-03T02:27:47+02:00 http://www.stato-framework.org/documentation/fr/db?rev=1238718467&do=diff A l'heure actuelle, Stato ne peut fonctionner qu'avec MySQL. Des pilotes pour PostgreSQL et SQLLite sont toutefois en cours de développement. 2 pilotes sont disponibles pour MySQL : le premier utilise l'extension MySQL standard, le second utilise PDO. Le choix du pilote et la saisie des paramètres de connexion se font dans le fichier conf/database.php : text/html 2009-04-20T18:41:00+02:00 http://www.stato-framework.org/documentation/fr/forms?rev=1240245660&do=diff Stato dispose d'un ensemble de classes facilitant la mise en place des formulaires dans vos applications. Elles prennent en charge un bon nombre des tâches courantes comme : * la génération automatique des éléments de formulaires * la validation des données soumises * le réaffichage du formulaire en cas d'erreurs de validation * le filtrage des données soumises et leur conversion dans le type PHP adéquat text/html 2009-04-03T02:27:47+02:00 http://www.stato-framework.org/documentation/fr/helpers?rev=1238718467&do=diff Helpers de formulaires Ces helpers sont conçus pour générer des éléments de formulaires en relation avec des objets assignés au template. Voici un exemple (l'objet $this->person ayant été assigné dans une action du controller) : // on définit un objet dans le controller $this->person = new Person(); $this->person->name = 'Batman'; $this->person->password = 'secret'; $this->person->single = true; $this->person->description = 'dark superhero'; // le formulaire ainsi défini <form action="save_… text/html 2009-08-11T08:54:21+02:00 http://www.stato-framework.org/documentation/fr/index?rev=1249973661&do=diff Ce manuel concerne la version de Stato en cours de développement (le trunk), qui peut être assez différente des versions précédentes. Vous pouvez également consulter le manuel des versions 0.8, 0.9 et 0.9.1. * Introduction à Stato * Installation d'un serveur de développement sous windows * Installation et création d'un nouveau projet text/html 2009-04-03T02:27:47+02:00 http://www.stato-framework.org/documentation/fr/installation?rev=1238718467&do=diff Configuration requise Vous devez utiliser au minimum PHP 5.1, avec les extensions dom, simplexml, pcre, session, spl, mbstring et mcrypt (seules les 2 dernières ne sont en général pas installées par défaut). La version ligne de commande de PHP (PHP-CLI) est également nécessaire pour utiliser les scripts d'administration. text/html 2009-10-06T05:54:12+02:00 http://www.stato-framework.org/documentation/fr/installationserveur?rev=1254801252&do=diff Il s'agit d'installer un envirronnement de développement pour un projet statoFramework sur un poste local. Si vous disposez d'un serveur correctement configuré pour utiliser stato vous pouvez sauter cette étape. Vous devez au minimum avoir PHP 5.1, avec les extensions dom, simplexml, pcre, session, spl, mbstring et mcrypt (seules les 2 dernières ne sont en général pas installées par défaut). La version ligne de commande de PHP (PHP-CLI) est également nécessaire pour utiliser les scripts d'admini… text/html 2009-04-03T02:27:47+02:00 http://www.stato-framework.org/documentation/fr/introduction?rev=1238718467&do=diff Convention over configuration Stato repose en grande partie sur ce principe de “conventions, plutôt que configuration”, inspiré par RubyOnRails. L'intérêt majeur est de pouvoir écrire moins de code ! Stato se repose sur des conventions de nommage pour déduire les relations entre les divers composants de votre application. Par exemple, une action nommée view() dans un controller PostsController sera suivie du rendu d'un template nommé view.php dans le dossier app/views/posts (à moins que vous ne… text/html 2009-04-07T01:57:00+02:00 http://www.stato-framework.org/documentation/fr/mailer?rev=1239062220&do=diff La classe SMailer vous permet, comme son nom l'indique, d'envoyer des mails depuis votre application. 2 modes d'envoi sont disponibles : le premier s'appuie sur la méthode mail() de PHP, le second utilise SMTP. Votre classe de mailing (nous l'appellerons Notifier) peut être placée où vous le souhaitez dans l'arborescence de votre application (même si le dossier app/models est recommandé), l'essentiel est de lui préciser dans quel dossier trouver les templates : text/html 2009-04-03T02:27:47+02:00 http://www.stato-framework.org/documentation/fr/migrations?rev=1238718467&do=diff Les migrations vous permettent de gérer plus facilement les évolutions du schéma de votre base de données. Vous pouvez par exemple créer un fichier de migration pour ajouter un nouveau champ à l'une des tables, tester votre code en local, puis déployer le changement sur le serveur de production, tout en conservant la possibilité de revenir à une version antérieure de votre schéma. text/html 2009-07-21T15:01:19+02:00 http://www.stato-framework.org/documentation/fr/models?rev=1248181279&do=diff ActiveRecord est un des designs patterns les plus simples pour faire de l'Object Relational Mapping. La définition qu'en donne Martin Fowler est : An object that wraps a row in a database table or view, encapsulates the database access, and adds domain logic on that data. text/html 2009-04-03T02:27:47+02:00 http://www.stato-framework.org/documentation/fr/pagination?rev=1238718467&do=diff Pagination dans une action class PhotosController extends ApplicationController { public function index() { list($this->photos_pages, $this->photos) = $this->paginate(Photo::$objects->all(), 20); } } La méthode paginate() retourne un tableau contenant une instance de SPaginator ($this->photos_pages) ainsi qu'une instance de SQuerySet représentant la page en cours. text/html 2009-08-11T07:59:47+02:00 http://www.stato-framework.org/documentation/fr/queries?rev=1249970387&do=diff La classe SQuerySet vous permet de récupérer des enregistrements dans votre base de données. Une instance de cette classe représente une collection d'objets issus de la base, filtrés par certains critères. En fait, cette classe permet d'opérer des SELECT, et les filtres sont des clauses de type WHERE ou LIMIT. text/html 2009-04-03T02:27:47+02:00 http://www.stato-framework.org/documentation/fr/routing?rev=1238718467&do=diff Le système de routing de Stato vous offre la possibilité de faire de l'URL rewriting en PHP, c'est à dire de faire correspondre une requête entrante à un contrôleur et une action. Les routes sont définies dans le fichier conf/routes.php. A l'ouverture de ce fichier, vous trouverez le code suivant : text/html 2009-04-03T02:27:47+02:00 http://www.stato-framework.org/documentation/fr/tutoriel?rev=1238718467&do=diff Préliminaires Afin de suivre ce tutoriel, vous devez avoir un environnement de développement adéquat : consultez la doc concernant l'installation et créez un nouveau projet nommé blog. Hello World ! Le but de ce tutoriel est de créer un petit moteur de blog. Si vous avez correctement créé votre appli comme indiqué dans les préliminaires, vous devez avoir un dossier blog/ à la racine de votre serveur web. Nous supposerons que vous avez créé un alias blog plutôt qu'un virtualhost. text/html 2009-08-11T08:05:02+02:00 http://www.stato-framework.org/documentation/fr/tutoriel_part_1?rev=1249970702&do=diff Ce tutoriel concerne la version de Stato en cours de développement (le trunk), qui peut être assez différente des versions précédentes. L'objectif de ce tutoriel est de vous montrer comment créer une application web de A à Z avec le framework Stato. Nous allons donc développer ensemble un site de recommandation de bières, à la sauce 2.0 bien sûr. Il existe déjà au moins un site de ce type, Coastr, mais cela reste un concept plus fun à implémenter qu'un moteur de blog ;) text/html 2009-06-15T18:02:39+02:00 http://www.stato-framework.org/documentation/fr/tutoriel_part_2?rev=1245081759&do=diff Ce tutoriel concerne la version de Stato en cours de développement (le trunk), qui peut être assez différente des versions précédentes. Nous nous sommes quittés après avoir créé une vue affichant les dernières bières ajoutées. Cette vue utilisait le helper link_to pour créer des liens vers la fiche de chaque bière : text/html 2009-04-07T21:16:56+02:00 http://www.stato-framework.org/documentation/fr/unit_tests?rev=1239131816&do=diff Stato s'appuie sur l'excellente librairie PHPUnit pour vous fournir l'environnement nécessaire à l'écriture de tests pour vos applications. text/html 2009-04-03T02:27:47+02:00 http://www.stato-framework.org/documentation/fr/views?rev=1238718467&do=diff Les views sont en fait des templates PHP. Il s'agit donc d'un mélange de HTML et de PHP, le PHP étant délimité par des tags <? ?> ou <?= ?> (le = remplaçant en fait la fonction echo). Vous pouvez également utiliser les tags ASP/Ruby <% %> et <%= %>. Attention : n'oubliez pas de mettre un espace entre les tags et le code PHP. text/html 2009-04-03T02:27:47+02:00 http://www.stato-framework.org/documentation/fr/webservices?rev=1238718467&do=diff Utilisation d'un client Stato dispose d'un ensemble de classes client vous permettant d'accéder à des web services. Pour l'instant, seul le protocole XMLRPC est utilisable. La conversion entre les types XMLRPC et PHP est automatique, et l'appel d'une méthode dans un espace de noms XMLRPC se fait dans la notation objet de PHP.