Come sfruttare tutte le potenzialità di Symfony in Drupal 8
•
1 like•975 views
Drupal 8 mette gia a disposizione molte API di Symfony, ma non tutte. Vediamo come sfruttare le altre.
![#DrupalDaysIT
SERVIZI DEL CORE
• current_user
• string_translation
• database
• settings
• state
• config.factory
• cache_factory
• form_builder
• http_client
• ~ altri 200 (^(s){2}([a-z_.]*):$ su core.services.yml)](https://image.slidesharecdn.com/drupal8symfony-140509084610-phpapp02/85/Come-sfruttare-tutte-le-potenzialita-di-Symfony-in-Drupal-8-21-320.jpg)
Come sfruttare tutte le potenzialità di Symfony in Drupal 8
- 1. COME SFRUTTARE TUTTE LE POTENZIALITÀ DI SYMFONY IN DRUPAL 8
- 2. LUCA LUSSO • @lussoluca • www.linkedin.com/in/lussoluca • drupal.org/user/138068 • llusso@wellnet.it Senior Web Developer @Wellnet
- 3. #DrupalDaysIT BENVENUTI Sviluppatori Drupal7 ? Sviluppatori Symfony ? Sviluppatori Drupal8 ?
- 4. #DrupalDaysIT NUOVE API IN DRUPAL8 • Routing • Configuration management • Entity • Plugin • Views • Migrate • Typed Data • Validation • …
- 5. #DrupalDaysIT COMPONENTI DI SYMFONY IN DRUPAL8 • Classloader • Dependency injection • Event dispatcher • Http foundation • Http kernel • Routing • Serializer • Validator • Yaml • Twig
- 6. #DrupalDaysIT MODULI CUSTOM In un modulo custom posso usare: le nuove API di Drupal8 + tutte le API messe a disposizione dai componenti di Symfony +
- 7. #DrupalDaysIT TALK In questo talk vedremo un sacco di codice, non preoccupatevi… …però partiamo da un caso reale, giusto per non parlare a vuoto :-) +
- 8. #DrupalDaysIT PROBLEMA Identificare il motivo per cui una data pagina è lenta
- 9. #DrupalDaysIT DRUPAL DEVEL Il modulo Devel ha un logger per query, time e memoria
- 11. #DrupalDaysIT SYMFONY PROFILER E’ presente solo nella Standard Edition di Symfony. Quindi nel core di Drupal8 non ci sarà…
- 12. #DrupalDaysIT SYMFONY PROFILER Per poter misurare tutti questi valori il profiler di Symfony è molto integrato dentro il framework e usa API e concetti piuttosto specifici Posso fare una cosa simile per Drupal?
- 14. #DrupalDaysIT WEBPROFILER Profiler di Symfony per Drupal8!
- 17. #DrupalDaysIT ATTENZIONE 1 Drupal8 è ancora in versione alpha, gli esempi seguenti potrebbero non funzionare più!
- 18. #DrupalDaysIT ATTENZIONE 2 Esistono due versioni del modulo webprofiler ! • 8.x-1.x-alpha11 -> compatibile con la alpha11 del core • 8.x-dev -> compatibile con l’HEAD corrente del core
- 19. #DrupalDaysIT ESEMPIO Vedremo come sfruttare questi concetti Symfony in un modulo Drupal: ! • Service provider • Compiler • Event listener • Profiler
- 20. #DrupalDaysIT SERVICE PROVIDER • Symfony utilizza un’architettura a servizi • I servizi dovrebbero contenere la business logic dell’applicazione, non i controller! • Tutti i servizi del core sono definiti nel file core/core.services.yml • I moduli possono aggiungere nuovi servizi e modificare quelli esistenti
- 21. #DrupalDaysIT SERVIZI DEL CORE • current_user • string_translation • database • settings • state • config.factory • cache_factory • form_builder • http_client • ~ altri 200 (^(s){2}([a-z_.]*):$ su core.services.yml)
- 22. #DrupalDaysIT SERVIZI • Implementano una certa funzionalità • Aumentano la possibilità di riuso del codice • Rendono un applicazione più testabile • Possono essere facilmente sostituti • Vengono caricati solo se servono per gestire una data richiesta
- 23. #DrupalDaysIT SERVIZI Sono gestiti da un ServiceContainer che in automatico soddisfa le eventuali dipendenze attraverso un meccanismo chiamato Dependency Injection, ossia non è il servizio che carica le proprie dipendenze da altri servizi ma è il Container che istanzia le classi necessarie all’atto della creazione del servizio stesso.
- 24. #DrupalDaysIT SERVIZI Servizio B (es. Database) Servizio A (es. Mailer) Servizio C che dipende da A e B (es. Newsletter) Se chiedo al Container un’istanza del servizio C, prima verranno create le istanze dei servizi A e B. Il container userà poi queste istanze (tipicamente) come parametri del costruttore di C all’atto della sua creazione.
- 25. #DrupalDaysIT SERVICE PROVIDER • Durante il bootstrap Drupal cerca una classe chiamata nomemoduloServiceProvider e un file nomemodulo.services.yml all’interno di ciascun modulo attivo • Il file .yml permette di aggiungere nuovi servizi • La classe permette di modificare i servizi esistenti o di aggiungerne di nuovi • Alla fine del processo di scoperta e modifica dei servizi il ServiceContainer viene scritto su un file (tipicamente) in sites/ default/files/php (verrà eliminato solo da uno svuotamento eventuale della cache)
- 28. #DrupalDaysIT ESEMPIO • Service provider • Compiler • Event listener • Profiler
- 29. #DrupalDaysIT COMPILER • Dopo aver aggiunto o alterato i servizi il ServiceContainer viene “compilato” per ottimizzarlo e per aggiungere ulteriori funzionalità (parametri e tag) • Il ServiceContainer passa attraverso una sequenza ordinata di passi di compilazione. Molti di questi passi sono definiti da Symfony stesso, alcuni sono nel core di Drupal, i moduli possono definirne ulteriori • I passi di compilazione servono per gestire i riferimenti circolari, rimuovere servizi inutilizzati, trovare servizi con specifici tag, …
- 31. #DrupalDaysIT COMPILER PASS Un passo di compilazione potrebbe ad esempio cercare tutti i servizi che hanno un certo tag: ContainerBuilder::findTaggedServiceIds()
- 33. #DrupalDaysIT COMPILER PASS Oppure modificare un servizio esistente, ad esempio cambiando una delle dipendenze. Possiamo addirittura modificare completamente l’implementazione di un servizio (l’importante è che il nuovo servizio rispetti la stessa interfaccia di quello sostituito) -> servizi mock per il testing
- 34. #DrupalDaysIT COMPILER PASS Cambio una dipendenza Sostituisco un servizio con un altro
- 35. #DrupalDaysIT ESEMPIO • Service provider • Compiler • Event listener • Profiler
- 36. #DrupalDaysIT EVENT LISTENER Il componente EventDispatcher di Symfony permette di definire, sollevare e registrarsi ad eventi: EventDispatcher::dispatch($eventName, Event $e = null) EventSubscriberInterface::getSubscribedEvents()
- 37. #DrupalDaysIT EVENT LISTENER Definisco un servizio all’interno di nomemodulo.services.yml e gli aggiungo il tag “event_subscriber”. La classe relativa deve implementare l’interfaccia EventSubscriberInterface e definire il metodo getSubscribedEvents(); in questo metodo registro i listener agli eventi che mi interessano. Uno dei passi di compilazione si occuperà di trovare il mio servizio e di registrarlo all’interno del gestore degli eventi. Se qualcuno solleva uno degli eventi a cui mi sono registrato vengo notificato.
- 40. #DrupalDaysIT EVENT LISTENER • Posso definire i miei eventi e sollevarli in punti precisi dell’esecuzione di un mio codice • Sostanzialmente gli eventi potrebbero sostituire il meccanismo degli hook di Drupal e in effetti posso già usarli all’interno di moduli custom (probabilmente gli hook spariranno del tutto in Drupal9, sostituiti dagli eventi)
- 41. #DrupalDaysIT ESEMPIO • Service provider • Compiler • Event listener • Profiler
- 42. #DrupalDaysIT PROFILER • Il componente Http kernel contiene un tool per il profiling delle richieste • In Symfony Standard Edition il Profiler è definito nel WebProfilerBundle e usato dal FrameworkBundle (i bundle sono i moduli di Symfony) • Usa diversi DataCollectors per memorizzare informazioni su una specifica richiesta (tempo di esecuzione, memoria, routing, query al database, …) • Nell’implementazione di Symfony salva i profili sul filesystem, usando un token come nome del file
- 43. #DrupalDaysIT PROFILER L’infrastruttura per la generazione e il salvataggio dei profili è già tutta nel core di Drupal8, mancherebbero i pezzi aggiunti dal FrameworkBundle e dal WebprofilerBundler, però le funzionalità che questi due bundle usano sono già anch’esse nel core di Drupal8 (eventi, servizi, tag, …)
- 44. #DrupalDaysIT PROFILER Ogni singolo collettore di dati è registrato come servizio e marcato con il tag “data_collector”. La classe relativa deve estendere la classe DataCollector e implementare il metodo collect()
- 46. #DrupalDaysIT ESEMPIO • Service provider • Compiler • Event listener • Profiler
- 47. #DrupalDaysIT TOOLS • PHP 5.4 • GIT • Drush 7 • PhpStorm EAP (ha il supporto per Drupal8!)
- 48. #DrupalDaysIT APPROFONDIMENTI La versione 8.x del modulo examples (drupal.org/ project/examples) conterrà a breve molti esempi a riguardo di questi concetti, potete scaricarne una preview da qua: github.com/lussoluca/examples
- 49. #DrupalDaysIT RISORSE • drupal.org/node/2116747 • drupal.org/node/2133171 • symfony.com/doc/current/components/dependency_injection/index.html • symfony.com/doc/current/components/event_dispatcher/index.html • symfony.com/doc/current/cookbook/profiler/index.html
- 50. #DrupalDaysIT CONCLUSIONI • Drupal8 mette a disposizione innumerevoli nuove API, ma i componenti di Symfony inclusi nel core ne aggiungono a loro volta molte altre! • Molte delle API di Symfony sono esposte da Drupal8 in modo che i moduli contrib e custom ne possano beneficiare • I nostri moduli custom possono sfruttare tutte queste potenzialità per integrarsi sempre di più all’interno del framework
- 51. #DrupalDaysIT CONCLUSIONI Se vogliamo arrivare pronti all’uscita di Drupal8 potremmo già iniziare a ragionare a “servizi” nei nostri moduli custom per Drupal7, quello che ci serve sono un classloader in grado di capire i namespace di PHP 5.3 e il PSR-0/4 (quello standard di Drupal7 non lo è) e un implementazione di ServiceContainer: ! • drupal.org/project/xautoload -> PSR-0, PSR-4 • drupal.org/project/pimple_container Se progettiamo così la business logic della nostra applicazione, la migrazione di un modulo per Drupal7 a Drupal8 potrebbe essere meno faticosa
- 52. #DrupalDaysIT Vuoi contribuire a webprofiler? Contattaci! Abbiamo bisogno di codice, grafica, documentazione, idee drupal.org/project/webprofiler
- 55. #DrupalDaysIT TITOLO DIAPOSITIVA Corpo della diapositiva