Symfony with angular.pptx

Utiliser AngularJs
avec Symfony2

Symfony et Angular JS
Esokia Ltd
•Agence de développement web
•Depuis 7 ans à l’île Maurice
•De très nombreux projets à Maurice et à l’international

Jérémy Gachet
•Développeur web depuis près de 10 ans en France et à Maurice
•Spécialisé dans les projets utilisant le framework Symfony depuis 5 ans.

•Framework de développement PHP très complet
•Norme de codages
•Un nombre énorme de “Bundles” (2500)
•Une documentation très aboutie
•Une communauté active
•Grosse demande client

•Framework de développement front
•MVC
•Two way data binding
•Routing
•One page app
•Projet lancé et supporté par Google

Pourquoi Coupler les deux frameworks?
● Vitesse et réactivité = meilleure expérience utilisateur
● Facilité de développements front avec AngularJS
● Indépendance du développement entre le front et le dev. (export plus facile
vers le mobile)

Difficultés
• Conflits
○ Routing géré par les deux systèmes
○ Même signe d’interpolation pour angular et twig
○ Gestion des formulaires
• Gestion de la sécurité
• Perte d’une partie des fonctionnalités apportées par les commandes de
Symfony

SECTION BREAK-
CENTURY GOTHIC
REGULAR 45pt /
LEADING 1.2
ALL CAPS

Solution proposée
● Symfony
○ Utiliser Symfony principalement en mode RESTfull.
○ Mais aussi pour la génération des templates et du cache serveur.
● AngularJS:
○ User interface, réception et traitement local des données en Json

Presentation REST
● REST (representational state transfer) est un style d’architecture
pour les systèmes hypermédia distribués.
Ses spécificités:
■ Séparation Client-serveur : les responsabilités sont séparées entre le client et
le serveur. L'interface utilisateur est séparée de celle du stockage des
données. Cela permet aux deux d'évoluer indépendamment.
■ Mise en cache : le serveur envoie une réponse qui donne l'information sur la
propension de cette réponse à être mise en cache
■ Un système hiérarchisé par couche : les états de l'application sont identifiés
par des ressources individuelles (URL)
http://fr.wikipedia.org/wiki/Representational_State_Transfer

Presentation REST
Créer des urls et renvoyer des données sérialisées. (en JSON ou XML)
Normes d’urls pour la récupération des données:
●GET http://mywebsite.com/books renvoie une liste de livres
●GET http://mywebsite.com/books/123 renvoie le livre avec la PK 123
●POST http://mywebsite.com/books + donnes en post pour ajouter un livre
●PUT http://mywebsite.com/books/123 + données PUT pour modifier un livre
●PATCH http://mywebsite.com/books/123 + données PATCH pour modifier une partie d’un livre
●DELETE http://mywebsite.com/books/87 pour supprimer le livre avec la PK 87
●GET http://mywebsite.com/books/87/comments pour recuperer tous les commentaires sur le livre avec la PK 87
●GET http://mywebsite.com/books/87/comments/125 pour recuperer le commentaire avec la PK 125 lie au livre avec la PK 87
Utilisation des méthodes et des codes réponses HTTP de manière adéquates.

Utiliser Symfony en mode RESTfull
Une distribution:
https://github.com/gimler/symfony-rest-edition
Qui intègre les bundles pour faciliter la création d’API REST

Les bundles:
JMSSerializerBundle
Pour serialize simplement vos entités en json et en xml. avec la possibilité de modifier les comportements à l’aide
d’annotations ou de méthodes spécifiques
un serilizer efficace :
$serializer = JMSSerializerSerializerBuilder::create()->build();
$serializer->serialize($object, 'json');

Les bundles:
JMSSerializerBundle
Des annotations pour modifier le contenu de vos serialisations:
● Changer le getter utilisé (et donc modifer le rendu d’un champs comme vous le souhaitez)
/** @JMS/Accessor(getter="getTrimmedName",setter="setName") */
private $name;
● Exclure un champ de l’export de votre entité
/** @JMS/Exclude */
private $password;
● Modifier la clé de l’export:
/** @JMS/SerializedName(my_property) */
private $myProperty;
Liste complète:
http://jmsyst.com/libs/serializer/master/reference/annotations

Les bundles:
FOSRestBundle:
Les routes REST sont normées et très répétitives à écrire. Ce bundle vous génère vos routes dynamiquement à partir du nom
de vos controllers.
# app/config/routing.yml
users:
type: rest
resource: AcmeHelloBundleControllerUsersController

<?php
use FOSRestBundleRoutingClassResourceInterface;
class UserController implements ClassResourceInterface
{
public function getUsersAction()
{} // "get_users" [GET] /users
public function postUsersAction()
{} // "new_users" [POST] /users
public function getUserAction($slug)
{} // "get_user" [GET] /users/{slug}
public function getUserCommentsAction($slug)
{} // "get_user_comments" [GET] /users/{slug}/comments
}

Exemple complet d’action :
<?php
/**
* Returns an user by username/email.
* @param string $slug Username or Email
* @Secure(roles="ROLE_USER")
*/
public function getUserAction($slug)
{
$userManager = $this->container->get('fos_user.user_manager');
$user = $userManager->findUserByUsernameOrEmail($slug);
return $user;
} // "get_user" [GET] /users/{slug}

Pensez à sécuriser vos actions
● En mode REST, vos URL sont les seuls garants de la sécurité de votre
application.
● Annotation @secure : toute la puissance de symfony

BazingaHateoasBundle
Ajoutez automatiquement un lien vers votre ressource à vos réponses
{
"user": {
"id": 123,
"first_name": "John",
"last_name": "Doe",
"_links": {
"self": { "href": "http://example.com/api/users/123" }
}
}
}
Possibilité de paramétrer la génération des liens en fonction des privilèges de
l’utilisateur. (le lien delete n’est pas envoyé le l’utilisateur n’a pas le droit de
supprimer une entité)

BazingaHateoasBundle
Vous pouvez également ajouter des liens vers les relations de votre entités ou les liens utilisés pour un
page dans une collection
{
"page": 1,
"limit": 10,
"pages": 1,
"_links": {
"self": {
"href": "/api/users?page=1&limit=10"
},
"first": {
},
"last": {

La validation des formulaires
• Désactivez le CSRF
Cette protection n’est utile que lorsqu’on identifie l’utilisateur à l’aide de cookies. (voir la partie Sécurité
pour plus d’informations sur l’authentification)
Avec fos rest bundle:
fos_rest:
disable_csrf_role: ROLE_API

Valider un formulaire :
Valider les formulaires ne se fait pas aussi simplement que l’on pourrait s’y attendre
o Utiliser les bons codes de responses HTTP :
 201 created après une création
 204 no content après un update ou un delete
 400 bad request si l’utilisateur envoi des paramètres invalides, etc…
Tips: Utiliser les constantes de la class Response:
Response::HTTP_CREATED
ou JsonResponse::HTTP_CREATED

Une requête Ajax ne renvoie pas des données que les formulaires de Symfony peuvent bind automatiquement.
Il faut donc le faire à la main:
$json_data = json_decode($request->request->get(“datas”), true);
$form = $this->createForm(new NoteType(), $note, array('method'=>$request->getMethod()));
//remove extra forms fields
$children = $form->all();
$data = array_intersect_key($json_data, $children);
//bind
$form->bind($data);
//return $form;
if ($form->isValid()) {
….

La sécurité
LexikJWTAuthenticationBundle
● Alterative simple à OAuth
● Utilisation d’un token JWT en header
● SSL
● Login via HTTP form
Intégration avec AngularJs :
https://github.com/auth0/angular-jwt

Intégrer

Utiliser Bower pour télécharger vos
modules
● Gestionnaire de dépendance pour
Javascript
● Téléchargement en ligne de
commande :
bower install angularjs
● Creation d’un fichier bower.js
fonctionnant comme le
composer.json
Intégrer Angular JS - Utiliser Bower

Utiliser assetic pour importer vos fichiers
La déclaration de vos modules doit donc toujours être faite en suivant les best practices pour éviter les
soucis lors de la minification :
['$scope', function($scope)...
app.controller('mainController', ['$scope', function($scope) {
$scope.message = 'HOORAY!';
}]);
https://docs.angularjs.org/tutorial/step_05
Intégrer Angular JS

Twig et AngularJS utilisent les mêmes symboles d’interpolation : {{ }}
Donc il faut modifier les symboles d'interprétation d’angularJS :
Au niveau de la déclaration du module:
angular.module('myApp', [], function($interpolateProvider) {
$interpolateProvider.startSymbol('[[');
$interpolateProvider.endSymbol(']]');
});
Angular fonctionnera désormais avec [[ myScopeVariable ]]
Intégrer Angular JS - les templates

Gérer les templates AngularJs avec twig
● Garder toute la puissance de twig
o Utilisation des balises {% spaceless %} {% endspaceless %}
o Utilisation du filtre |trans pour générer simplement et efficacement les
traductions des interfaces
● Sortir les templates du dossier public de l’application

Créer des routes pour accéder au template:
1. Static controller de Symfony2:
acme_privacy:
path: /privacy
defaults:
_controller: FrameworkBundle:Template:template
template: 'AcmeBundle:Static:privacy.html.twig'
a. Permet de créer des routes sans controller
b. inconvénient: 1 route à créer par template.

Créer des routes pour accéder au template:
Universal route:
Créer une route universelle pour accéder à vos templates statiques :
get_static_template:
path: /tpl/{templateName}.{_format}
defaults:
_controller: "EsokiaAdminBundle:Default:getStaticTemplate"
requirements:
_format: html
templateName: .+
options:
expose: true

Créer des routes pour accéder au template
Universal route - controller :
/**
* @Cache(expires="tomorrow")
*/
public function getStaticTemplateAction($templateName, $_format){
return $this->render('EsokiaAdminBundle:Default:Static/'.$templateName.'.'.$_format.'.twig');
}

En dehors de l’interface REST, le routing de symfony n’est utilisé que pour
● Accéder à la home page
● Accéder aux templates statics
● Les autres routes sont gérées par Angular JS
Intégrer Angular JS - Routing

Utiliser les routes dynamiques de Symfony avec Angular JS
● FOSJsRoutingBundle
Créer un fichier Javascript pour exposer vos routes:
o ajouter expose: true aux routes que vous voulez utiliser en JS
options:
expose: true
● Utiliser la fonction du bundle pour utiliser vos routes :
Routing.generate('route_id', /* your params */)

Utiliser les routes dynamiques de Symfony avec Angular JS
Exemple:
var userDetailsUrl = Routing.generate('get_static_template', {'templateName': 'userDetails',
'_format':'html'});
$routeProvider.when('/details/:username', {
controller: 'userDetailsController',
templateUrl: userDetailsUrl
})
Avantages :
● Pas de soucis de routing dans angular si vous déplacez vos fichiers js quand vous les compressez
avec assetic.
● Domain name agnostic

Solution 1 :
Override les templates de générations des formulaires de Symfony
● Permet de générer les templates de formulaire avec la ligne de commande
● Proche des habitudes des développeurs Symfony2
● Intéressant si beaucoup de formulaires sont standards
- Les templates de formulaires

Gérer les templates de formulaires avec Angular Js
● Abandonner complètement les templates de formulaire Symfony
● Utiliser Xeditable

XEditable:
● Série de directive de formulaire permettant le click-to-edit aussi appelé edit-in-
place
● Meilleure expérience utilisateur
● Une seule vue à créer pour les actions de visualisation et d’editing

Template de vue Template d’édition
● Un seul template, deux utilisations.
● Masquer le bouton d’édition pour les personnes non autorisées à éditer

Symfony et Angular JSSymfony et Angular JS
Merci
http://esokia-webagency.com

Symfony with angular.pptx

Contenu connexe

Tendances

En vedette

Similaire à Symfony with angular.pptx

Symfony with angular.pptx