http://jonathan.demoutiez.net/Accueil/index/in/rss Tout sur l'actualite, informatique; robotique; high-tech, sur la programmation Java; PHP; C/C++, l'intelligence artificielle, venez decouvrir des inventions toujours plus surprenantes, ce site regroupe de nombreux services disponibles FTP; WAP;... fr Copyright ©2 M@ckerT. M@ckerT. http://mackert.ath.cx/ 20 http://jonathan.demoutiez.net/Symfony/40-base-de-donnees Le framework nous offre une souplesse d’utilisation et d’accès à la base de données qui vous fera gagner énormément de temps ! La base de données va être décrite dans un fichier de configuration : config/schema.yml. Nous allons d’abord différencier deux points, soit votre modèle de données : est déjà construit et nous ne pouvons pas le modifier : nous perdrons quelques atouts de Symfony;n’est pas encore définit ou nous pouvons la re-modeler. Noms de champs spécifiques id : Si un champ d’une table se nomme id alors il sera automatiquement considéré comme la clé primaire de la table. created_at & updated_at : Vous pouvez appeler un champ de type datetime`created_at ou updated_at pour que Symfony gère ces données automatiquement lors de l’insertion ou de la mise à jour de données. Système relationnel Symfony va nous permettre de gérer très simplement le système relationnel de notre modèle de données. Automatiquement si nous appelons nos champs comme il faut : Si un champs se nomme NOM_TABLE_EXISTANTE_id alors il sera automatiquement considéré comme la clé étrangère de la table NOM_TABLE_EXISTANTE. Ainsi le système relationne sera repris automatiquement dans notre système objet (ORM). Ecriture du schéma Ma base n’est pas encore créée : Nous allons éditer le fichier `config/schema.yml` comme suit: propel: nom_table: id: created_at: titre: varchar(255) texte: longvarchar nom_table_2: id: created_at: updated_at: nom_table_id: texte: varchar(255) description: longvarchar chiffre: int Une fois que nous avons décrit notre schéma SQL, nous allons pouvoir générer automatiquement les tables en base et la génération des objets (cf: le prochain article l’ORM)) : >symfony propel-build-all Ma base est déjà créée Si notre base est déjà écrite nous pouvons générer ce fichier automatiquement via la commande : >symfony propel-init-schema Nous pouvons ensuite y effectuer quelques modifications pour y préciser notre système relationnel par exemple : propel: nom_table: id: created_at: titre:varchar(255) texte: longvarchar nom_table_2: id: created_at: updated_at: texte: varchar(255) description: longvarchar chiffre: int _foreignKeys: nom_table: _attributes: { onDelete: cascade } references: - {local: nom_cle_etrangere, foreign: id } Ici nous n’allons pas créer les tables en base puisqu’elles existent déjà, nous allons donc juste générer les objets via l’ORM : >symfony propel-build-model 2007-08-27 12:52:19 http://jonathan.demoutiez.net/Symfony/39-entrons-dans-le-monde-de-symfony Jusqu’ici nous avons vu les grands points de Symfony mais surtout son fonctionnement (application / modules / actions / vues; partials / helpers). Mais symfony est un framework et nous offre donc une multitude d’helpers et de fonctions à disposition qui vont nous simplifier la vie. De nombreuses fonctions de Symfony permettent de générer une balise HTML. Les fonctions les plus courantes Liens HTML Puisque symfony utilise de l’url rewriting nous passerons systématiquement par les fonctions de symfony pour générer des liens. Ceci permettra de formater automatiquement les liens : Accueil/index?var1=value1 deviendra automatiquement : Accueil/index/var1/value1 link_to(TEXTE, LIEN, PROPRIETES) : génére un simple lien html. Le troisième paramètre est une chaine de caractères qui peut contenir tous les attributs possibles d’une balise A_ sous cette forme : _target=nom, popup=true, alt=text link_to('clic ici', 'PUB/index?pub=2', 'popup=true') Liens & Javascript En faisant appel à l’helper `Javascript` nous pourrons utiliser : link_to_function(TEXTE, CODE_JAVASCRIPT) qui génére un lien faisant appel à du code javascript onclick. link_to('clic ici', 'alert(\'BONJOUR !\')') ?> link_to_remote(TEXTE, array()), fait appel à une page en ajax. link_to_remote( 'clic ici', array( 'url' => 'MODULE/ACTION', 'update' => 'div_id_1', 'loading' => 'alert(\'Debut\')', 'complete' => 'alert(\'FIN\')', 'script' => true 'confirm' => 'Etes vous sur ?' ) ) loading permet de spécifier du code javascript à exécuter avant l’appel ajax, et complete après l’appel. update est l’id de l’élément HTML à mettre à jour. confirm permet de géré automatiquement une petite alert de confirmation. ATTENTION : si vous ne mettez pas script à true, le code Javascript récupéré en ajax ne sera pas executé ! Remarque : Cet helper offre de très nombreuses fonctions (tel que les fonctions de Drag And Drop par exemple) que vous trouverez dans la documentation officielle. Image équivaut à : image_tag('image'); Remarque : Certaines extensions seront prises en compte automatiquement (‘jpg’, ‘png’) sinon précisez la. L’image est automatiquement recherchée dans le dossier web/images, mais nous pourons accèder à d’autres dossiers : /images2/image ou encore sous_dossier_images/image Formulaire form_tag('MODULE/ACTION', 'method=post'); Saisissez : label_tag('input1', 'Saisissez : ') input_tag('input1', 'valeur') submit_tag('Ok') La balise select select_tag( 'NAME', options_for_select( array( 'value' => 'affiche', 'value1' => 'affiche1' ), 'valeur_par_defaut' ), 'size=2') Remarque : Vous pouvez spécifier des ‘optgroup’ : options_for_select( array( 'groupe 1' => array(), 'value' => 'affiche', 'groupe 2' => array(), 'value1' => 'affiche1' ), 'valeur_par_defaut' ) De nombreuses autres fonctions associées sont disponibles, ce qui rend le tout très intuitif. 2007-08-13 15:00:32 http://jonathan.demoutiez.net/Symfony/38-helper Un helper va comme le partial permettre de généraliser des bouts de vues, mais il ne contient pas directement une vue mais des fonctions qui retourneront les bouts de vue. Ces fonctions correspondent à un tout petit bout de vue contrairement à un partial qui peut contenir beaucoup d’éléments. Un helper pourra définir par exemple des fonctions qui vont attribuer des couleurs au titre selon des critères de niveaux;qui vont définir les options pour le select d’un formulaire (avec appel au model);... . Des fonctions comme link_to_remote; draggable_element; ... appartiennent à l’helper Javascript. Aussi il est possible que l’on ai besoin de faire du calcul ou de l’appel au model pour générer un bout de vue, nous ferons appel à l’utilisation d’un helper dans ce cas pour respecter notre système MVC. Définir un helper Les helpers d’une application vont se situer dans le dossier apps/NOM_APP/lib/helper/ (ou dans le dossier lib d’un module pour plus de spécificités) Un helper Menu aura pour nom de fichier le nom du helper suivit du mot clé Helper, exemple : menuHelper.php Faire appel à un helper L’appel à un helper se fait donc évidement dans une vue (ou encore un partial). Nous pourrons appeler des helpers via la fonction use_helper : use_helper('Menu') On peut également faire appel à plusieurs helpers en même temps : use_helper('Menu', 'helper2', ...) Une fois un helper appelé nous aurons accès aux fonctions définies dans celui-ci. 2007-08-08 11:32:21 http://jonathan.demoutiez.net/Symfony/37-partial Symfony est un framework dit « DRY » (Don’t Repeat Yourself), il intégre un système de partial et d’helper qui vont nous permettre de généraliser des “bouts de vues”.Partial Un partial se place dans le dossier templates du module le concernant. Le nom du fichier commencera systématiquement par le caractère `_`, exemple si on le nomme : `je_suis_un_partial`, le fichier se nomme : _je_suis_un_partial.php Un partial va pouvoir être appelé de n’importe quelle vue via l’instruction : include_partial('je_suis_un_partial'); Cette instruction appelle le partial et le “cherche” dans le module actuel. Dans le cas ou vous voulez appeler le partial d’un autre module, vous devez le préciser : include_partial('NOM_MODULE/je_suis_un_partial') A quoi ça sert ? Si par exemple vous avez un formulaire qui permet à l’utilisateur de saisir des informations lors de son inscription, souvent vous avez ce même formulaire qui permet à l’utilisateur de venir les modifier. Plûtot que d’écrire ce formulaire dans le fichier ‘modules/inscription/templates/inscriptionSuccess.php’ et de le recopier dans ‘modules/membre/templates/modifierInfosSuccess.php’. Nous allons écrire uniquement ce formulaire dans le partial ‘modules/inscription/templates/_formulaire.php’. Evidement nous pouvons passer des valeurs à un partial, voici comment procéder : include_partial( 'NOM_MODULE/je_suis_un_partial', array( 'nom_var1' => val1, 'nom_var2' => val2, ... ) ); 2007-08-06 10:57:48 http://jonathan.demoutiez.net/Symfony/36-resumons-essayons Essayons avec un exemple tout simple pour bien comprendre l’intéraction modules / actions / vues. Commençons par générer notre projet, notre première application et notre premier module : $> symfony init-project mon_premier_projet_symfony $> symfony init-app front $> symfony init-module front Accueil On définit notre module et action par défaut : apps/front/config/routing.yml # default ruleshomepage: url: / param: { module: Accueil, action: index }// ... Nous allons définir notre action index : apps/front/modules/Accueil/actions/actions.class.php class AccueilActions extends sfActions{ public function executeIndex(){ // Aucun traitement pour le moment... } apps/front/modules/Accueil/templates/indexSuccess.php Bienvenue...<br /> <br /> Ici nous sommes dans le module Accueil et l'action index. Définissons notre action autre, on rajoute la méthode executeAutre, apps/front/modules/Accueil/actions/actions.class.php public function executeAutre(){ // Aucun traitement pour le moment... } apps/front/modules/Accueil/templates/autreSuccess.php Voici mon autre action... Rendez-vous sur l’url : http://MON_DOMAINE/ ou http://MON_DOMAINE/Accueil/index et http://MON_DOMAINE/Accueil/autre Vous pouvez essayer de générer un deuxième module et une deuxième application et y faire vos essais. 2007-08-03 14:37:30 http://jonathan.demoutiez.net/Symfony/35-recuperer-dans-la-vue-une-variable-definie-dans-l-action Il nous sera bien sur indispensable de passer des variables de notre action à notre vue. Pour cela il suffit de passer la variable en attribut de classe. Exemple : public function executeIndex(){ ... $cout_en_francs = 1; $this->setVar('cout_en_euros', $cout_en_francs * 6.55); ...} Ici, dans la vue nous aurons accès à la variable cout_en_euro mais pas à la variable cout_en_francs : indexSuccess.php : Le cout est de <?= $cout_euros ?> € 2007-08-02 13:42:21 http://jonathan.demoutiez.net/Symfony/34-comment-sont-definies-les-vues Les vues d’un module sont stockées dans le dossier templates. La vue correspondante à une action doit avoir le même nom que celui de l’action suivi du mot clé Success. Vous trouverez donc par défaut dans un module la vue de l’action index qui est indexSuccess.php (action générée par défaut). 2007-08-02 13:41:54 http://jonathan.demoutiez.net/Symfony/33-comment-sont-definies-les-actions Les actions vont être définies sous formes de méthodes de la classe actions (du dossier actions de notre module). Rappel : Lors de la génération d’un module, l’action index est générée par défaut. Le nom d’une méthode d’action commence systématiquement par le mot clé execute : public function executeIndex(){ }  Remarque : L’instruction : $this->forward('default', 'index') (inscrite à la génération dans l’action index) est une redirection vers le module et l’action précisés (défault est un module intégré dans Symfony). La méthode forward permet d’effectuer une redirection ‘interne’ (invisible pour l’utilisateur), à ne pas confondre avec la méthode redirect qui elle est une rediction envoyé au client (elle renvoie par défaut le code 302). Vous l’avez compris, la méthode executeNOM_ACTION correspond au controleur de l’action (modèle MVC). Il pourra faire appel au modèle pour récupérer des valeurs en base; effectuer des calculs; ... . La vue correspondante à l’action sera ensuite appelée (A suivre dans le prochain post). 2007-08-01 15:25:53 http://jonathan.demoutiez.net/Symfony/32-configuration-d-un-module Comme expliqué précédemment, une application va permettre de distinguer divers grand point de notre projet (Back/Front/...). Un module lui va définir les diverses actions (Accueil/Inscription/...). Remarque : L’action par défaut d’un module est ‘index’. Un module contient également un dossier ‘config’ (vide par défaut), on peut y ajouter les mêmes scripts de configuration que contient une application et ainsi définir des spécificités propres à un module qui peuvent différer de l’application. (Exemple : dire qu’un module ne doit pas utiliser le layout; sécuriser le module; utiliser des filtres différents; ...). La configuration de l’application est donc la configuration par défaut de chacun des modules. 2007-06-25 17:32:00 http://jonathan.demoutiez.net/Symfony/31-le-principe-m-v-c Modèle – Vue – Controleur A l’exécution d’une requête, le Controleur est appelé et pourra intéragir avec le Modèle, il envoie ensuite les données à la Vue correspondante qui n’aura plus qu’à structurer la page à afficher. 2007-06-25 17:29:00 http://jonathan.demoutiez.net/Symfony/30-configuration-generale-d-une-application Le dossier config de l’application contient les fichiers suivants : app.ymlcache.ymlconfig.phpfactories.ymlfilters.ymlil8n.ymllogging.ymlrouting.ymlsecurity.ymlsettings.ymlview.yml Détaillons rapidement les fichiers view.yml et routing.yml pour bien débuter le projet : view.yml Ce fichier permet de configurer la vue générale (charte graphique) de l’application : balises metas;les fichiers CSS à inclure;les fichiers JS à inclure;le layout. Exemple : default:http_metas: content-type: text/htmlmetas: title: symfony project description: symfony project keywords: symfony, project language: frstylesheets: [main, feuille2]javascripts: [javascript]has_layout: onlayout: charte_1 Ici on a défini : les balises « meta » que l’on souhaite;les feuilles de style à utiliser (web/css/main.css, web/css/style.css);les fichiers «javascript» à appeler (web/js/javascript.js);l’utilisation d’un layout « charte_1 » : (apps/NOM_APPLICATION/templates/charte_1.php). Le layout est ce qui englobe le corps de la page qui sera généré par les modules. Nous verrons plus tard avec l’utilisation de components comment intégrer des menus dynamiques ou autres… Voici comment se présente le script du layout : <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"><html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"> <head> <?php include_http_metas() ?> <?php include_metas() ?> <?php include_title() ?> <link rel="shortcut icon" href="/favicon.ico" /> </head> <body> <!-- Code du haut de la page --> <!-- Code de l'eventuel menu --> <!-- Le corps de la page --> <!-- Inclusion du contenu généré par le module d'une action --> <?= $sf_data->getRaw('sf_content') ?> <!-- ... --> <!-- Code du bas de la page --> </body></html> routing.yml Ce fichier va permettre de gérer simplement l’url rewriting. Pour l’instant voyons juste comment modifier le module et l’action par défaut de l’application : homepage: url: / param: { module: MODULE_PAR_DEFAUT, action: ACTION_PAR_DEFAUT } ATTENTION : Une fois que vous avez modifié la configuration de votre projet, il est indispensable de vider le cache pour que les modifications soient prises en compte. Vider le cache >symfony cc 2007-06-25 17:17:00 http://jonathan.demoutiez.net/Symfony/29-generation-via-la-commande-symfony Symfony fonctionne avec un système d’applications / modules. Générer une application $>symfony init-app NOM_APPLICATION Voici l’architecture d’une application générée : apps/NOM_APPLICATION/config/apps/NOM_APPLICATION/il8n/apps/NOM_APPLICATION/lib/apps/NOM_APPLICATION/modules/apps/NOM_APPLICATION/templates/ Générer un module $>symfony init-module NOM_APPLICATION NOM_MODULE Voici l’architecture d’un module généré : apps/NOM_APPLICATION/modules/NOM_MODULE/actions/apps/NOM_APPLICATION/modules/NOM_MODULE/config/apps/NOM_APPLICATION/modules/NOM_MODULE/lib/apps/NOM_APPLICATION/modules/NOM_MODULE/templates/apps/NOM_APPLICATION/modules/NOM_MODULE/validate/ Lors de la génération de la première application du projet, le fichier index.php (dans le dossier web) va être généré « pointant » par défaut vers cette première application. L’application renvoie alors dans un premier temps vers le module par défaut de symfony. Remarque : Lors de la génération d’une autre application, un fichier NOM_APP.php sera généré (dans le dossier web). Il faudra donc préciser dans l’URL l’appel d’autres applications : http://domaine/NOM_APP.php/ Aussi il existe un mode développement (debug) que l’on peut atteindre en passant par le fichier “NOM_APPLICATION_dev.php” en mode prod define('SF_ENVIRONMENT', 'prod'); define('SF_DEBUG', false); en mode dev define('SF_ENVIRONMENT', 'dev'); define('SF_DEBUG', true); 2007-06-25 17:12:00 http://jonathan.demoutiez.net/Symfony/28-fichiers-de-configurations Le fichier de configuration config/config.php est à modifier selon vos besoins (inclusion de librairies, déclaration de globals, ...) : // Répertoire de Symfony : "OBLIGATOIRES"$sf_symfony_lib_dir = '/usr/share/php/symfony';$sf_symfony_data_dir = '/usr/share/php/data/symfony';// Définir vos constantesdefine ('URL', 'http://domaine');define ('LIB_DIR', SF_ROOT_DIR . '/lib/');define ('CGI_BIN', LIB_DIR . '/lib/cgi-bin/');// Inclure vos librairiesrequire_once(LIB_DIR . 'functions.inc.php');require_once(LIB_DIR . 'Email.class.php');// ... 2007-06-25 17:09:00 http://jonathan.demoutiez.net/Symfony/27-configuration-de-la-base-de-donnees Il y a deux fichiers à modifier pour cela : config/propel.ini propel.targetPackage = lib.modelpropel.packageObjectModel = truepropel.project = ##NOM_PROJET##propel.database = mysqlpropel.database.createUrl = mysql://HOTE/propel.database.url = mysql://##USER##:##PASS##@##HOTE##/##NOM_BASE## config/database.yml all:propel:class: sfPropelDatabaseparam:dsn: mysql://##USER##:##PASS##@##HOTE##/##NOM_BASE## 2007-06-25 17:06:00 http://jonathan.demoutiez.net/Symfony/26-configuration-d-apache Il est nécessaire que la configuration d'apache pointe directement vers le dossier web du projet via un 'VirtualHost'. 01:<VirtualHost *>02: DocumentRoot /var/www/##NOM_PROJET##/web03:04: <Directory />05: AllowOverride All06: </Directory>07:08:# Alias /sf /usr/share/php/data/symfony/web/sf09:10:# ScriptAlias /cgi-bin/ /var/www/NOM_PROJET/lib/cgi-bin/11:</VirtualHost> Il est aussi indispensable d’avoir accès au dossier `sf` (contenu dans Symfony) à la racine du site. Il y a pour cela plusieurs solutions : Créer un Alias dans la configuration d’apache (décommenter la ligne 8 du script ci-dessus). Créer un lien symbolique dans le dossier web vers le dossier sf du projet. $/web> ln -s /usr/share/php/data/symfony/web/sf Copier le dossier sf dans le dossier web $/web> cp -R /usr/share/php/data/symfony/web/sf . 2007-06-25 17:05:00 http://jonathan.demoutiez.net/Symfony/25-creation-d-un-projet Symfony nous offre donc la possibilité de créer rapidement un projet via la commande `symfony` : $> symfony init-project NOM_PROJET Ceci va permettre de générer l’architecture de dossier vu précédemment ainsi que les fichiers de configurations et de bases du projet. 2007-06-25 17:05:00 http://jonathan.demoutiez.net/Symfony/24-installation Il y a plusieurs solutions pour installer Symfony : Le plus simple est de passer par la bibliothèque PEAR : $> pear channel-discover pear.symfony-project.com $> pear install symfony/symfony Sinon, les sources sont également disponibles à l’adresse suivante : symfony-project.com Utiliser la commande `symfony` Nous aurons régulièrement besoin d’utiliser cette commande pour “diverses générations”; vider le cache; vider les logs; ... . En passant par PEAR la commande `symfony` sera directement accessible, sinon vous devrez soit : compléter votre variable PATH; créer un lien symbolique dans un de vos dossiers de scripts (à l’installation le script est placé dans `/usr/bin/`); utiliser ”./symfony” (généré à la racine de votre projet). Bash auto-completion Il vous suffit de créer un fichier symfony dans : /etc/bash_completion.d/ pour les Debian/etc/profile.d/ pour les RedHat et d’y mettre le contenu suivant : cliquez ici 2007-06-25 16:54:00 http://jonathan.demoutiez.net/Symfony/23-l-url-rewriting Symfony utilise de l’U.R.L. rewriting comme ceci : http://domaine/_NOM_ACTION_/_NOM_MODULE_/_NOM_VAR1_/VALEUR1/_NOM_VAR2_/VALEUR2... Nous remarquons que le passage de variables en méthode ‘GET’ ne va plus s’effectuer avec les caractères : ’?’, ’=’ et ‘&’, mais sera dans la continuité de l’U.R.L. séparé par des ’/’. Remarque : L’URL http://domaine/ appellera le module et l’action par défaut que l’on pourra définir (exemple: ‘Accueil/index’), mais si l’on veux passer des variables en paramètre, on sera obligé de les préciser : http://domaine/Accueil/index/var1/valeur1 et non : http://domaine/var1/valeur1 ici on appelle la module ‘var1’ et l’action ‘valeur1’, ce qui nous renverra sur une page erreur 404 2007-06-25 16:53:00 http://jonathan.demoutiez.net/Symfony/22-architecture-generale Voici l'architecture d'un projet symfony (à la racine): apps/ * Les applications du projet.batch/ * Les tâches automatisées du projet.cache/ * Le dossier de cache (géré par Symfony).config/ * La config général du projet.data/ * Les données de configurations relatives au projet. (Accès BDD…)doc/ * Emplacement de la documentation.lib/ * Contient entre autre le Modèle du projet, mais aussi les librairies communes aux applications.log/ * Emplacement des logs.plugins/ * Emplacement des plugins dédiés à Symfony.test/ * Gestion des tests fonctionnels et unitaires.web/ * Dossier accèssible d’internet il contient “index.php; images; CSS; JS; ...”  2007-06-25 16:52:00 http://jonathan.demoutiez.net/Symfony/21-application-module Un projet Symfony se base sur la création d’applications qui va permettre de séparer par exemple le front-office et le back-office. Les modules d’une application vont permettre de séparer chaque fonction distincte d’un projet (espace membre; catalogue; paiement; inscription; ...) Grâce à ce principe nous allons pouvoir obtenir un projet clair et structuré ! Le modèle, généré par propel est commun à toutes les applications, ce qui va nous permettre de pouvoir intéragir avec la base de données dans la totalité du projet. Nous en verrons les GRANDS avantages. 2007-06-25 16:51:00 http://jonathan.demoutiez.net/Symfony/12-qu-est-ce-que-symfony Symfony est un framework Open Source développé en PHP5. Inspiré de Ruby On Rail, il intégre PROPEL (ORM), CREOLE (Couche d’abstraction de base de données) et Mojavi (implémention MVC). Propel est un ORM, il permet de faire une correspondance entre le monde objet du langage et le monde relationnel de la base de données;CREOLE est une couche d’abstraction de base de données, elle va permettre de gérer n’importe quel gestionnaire de base de données;MVC : Le principe MVC permet de séparer nettement les couches MODELES (Base de données), VUES, CONTROLEURS. En réutilisant l’existant plutôt que de repartir à zéro Symfony reste à ce jours l’une des solutions les plus complètes en PHP. 2007-05-04 16:10:00