• Appréhender l'environnement de développement Drupal
• Comprendre les concepts et l'API Drupal 
• Modifier le comportement d'un module existant 
• Créer un module
• Créer un profil d'installation

Prérequis

• Connaitre PHP et avoir développé quelques scripts
• Avoir construit un site avec Drupal
• Notions de HTML, CSS, JavaScript et requêtes SQL

• Rappels PHP
• Environnement de développement
• Quelques outils utiles
• Bonnes pratiques, standards de code, documentation
• Architecture de Drupal & concepts de base
• Création du squelette d'un module
• Les premiers hooks
• Les différentes API
• Les nœuds, le contenu et les droits d'accès
• L'alteration des modules
• La form API
• Les mails
• Créer un thème basique
• Les profils d'installation

• POO
• Composer
• Symfony
• Routage et controlleurs
• Plugins
• Injection de dépendences et le conteneur de services

"Going off the island"

• Actuellement en version 8.8.x
• Beaucoup de choses ont changé depuis Drupal 7

• Viennent du PHP Framework Interoperability Group (FIG)
• Différentes normes
  • PSR-0 : autoloader standard
  • PSR-1 : normes de codage de base (Drupal les suit presque)
  • PSR-2 : normes de codage plus poussées (Drupal les suit presque)
  • PSR-3 : interface du logger (pas implémentée dans Drupal)
  • PSR-4 : autoloader amélioré (choisi par Drupal) : https://www.drupal.org/node/2156625
• À suivre : Symfony a quitté le FIG (après Laravel, Propel, Guzzle et Doctrine)

• Le plus populaire des frameworks PHP aujourd'hui (http://symfony.com/doc/current/index.html)
• Ensemble de composants réutilisables
• Certains sont réutilisés par Drupal

• Gestionnaire de dépendances utilisé par la communauté PHP
• Installation : https://getcomposer.org/download/
• composer.json
• "composer require" / "composer install"
• Dossier /vendor
• composer.lock
• Contient un autoloader

• Pour les performances : https://github.com/hirak/prestissimo

• D8 Composer definitive introduction

• Composer install vs. composer update

• xAMP (Apache, MySQL, PHP) conseillé
• D'autres possibilités : Nginx / IIS, PostgreSQL
• Liste des languages utilisés :
  • SQL
  • PHP
  • Javascript
  • HTML
  • CSS

• Le meilleur est celui que vous maitrisez
• Différence IDE/Editeur simple :
  • Autocomplétion
  • XDebug
  • Refactoring
  • Erreurs de syntaxe
• Possibilité de télécharger des configurations
• Exemples : PHPStorm / Eclipse / Netbeans / Atom / Vim

• Indentation, espaces : lisibilité du code
• Nommage, toujours commencer par le nom système : éviter les conflits
  • fonctions
  • constantes
  • variables persistantes
  • classes
  • fichiers
• Tags <?php non fermés : éviter l'envoi du buffer

À connaître pour comprendre et être compris

* basés sur le standard PEAR

• Drupal Console : générateur de code
• Drush : administration (DRUpal SHell) & téléchargement de modules et librairies
• Devel : debug et informations sur les données
• Coder : revue de code
• Masquerade : changer d'utilisateur sans se déconnecter
• Examples for developpers : démonstrations de l'utilisation de l'API
• Ne pas utiliser les caches durant le développement (https://www.drupal.org/node/2598914 / http://www.tothenew.com/blog/is-your-drupal-8-ready-for-writing-codes/)

• drush cr (cache-rebuild)
• drush uli (user-login)
• drush sql-dump
• drush site-install
• drush archive-dump / drush archive-restore
• drush cim / drush cex

• drupal site:mode dev (désactivée depuis la rc12)
• drupal generate:module
• drupal generate:plugin:block
• drupal generate:routesubscriber
• drupal generate:form:config
• drupal generate:entity

• composer create-project drupal-composer/drupal-project:8.x-dev some-dir --stability dev --no-interaction

• composer create-project drupal/drupal my_site_name installe un nouveau site

• composer require drupal/core:8.8.1 --update-with-dependencies met à jour le cœur

• Attention, encore quelques problèmes avec Composer

• Utilisé par beaucoup de développeurs dans le milieu du web

• Très utile pour patcher des modules car utilisé par la communauté Drupal et sur drupal.org

• Une connaissance basique de quelques commandes suffit

  • git clone
  • git add
  • git commit
  • git diff

• Possibilité d'avoir une interface graphique : SourceTree, Gitg, GitLab, GitHub

• .info.yml (https://www.drupal.org/node/2000204)
  • name
  • type: module /!\
• Avant 8.7.7
  • core: 8.x
• Après 8.7.7
  • core_version_requirement: ^8.8 || ^9
• .module (souvent vide en D8)
• .install facultatif (configuration désormais indépendante)
• répertoire "config/install" pour la configuration
• répertoire "src" pour les Plugins, Controller, Form, ...

Votre bible : api.drupal.org

Recense toutes les fonctions de Drupal, et leur documentation. Un IDE aura cette même documentation dans le code.

Aborde certains topics en profondeur : form API, schema API, hooks, etc

https://api.drupal.org/api/drupal/core%21core.api.php/group/extending/8.6.x

Votre guide : modules examples

Pour chaque concept de Drupal, des exemples concrets d'utilisation (ajax, form, blocks, cache, render, cron, dbtng, email, menu, node_access, theming, ...).

Ils sont fonctionnels : on peut les activer et voir leur impact en terme d'interface.

Très bien documentés, ne pas hésiter à lire, comprendre et reprendre le code de ces modules.

• Plugins : https://www.drupal.org/node/2087839
• Annotations très utilisées dans le cœur : pour tous les plugins (block, entre autres) : https://www.drupal.org/node/1882526
• https://api.drupal.org/api/drupal/core%21core.api.php/group/annotation/8.6.x

Quelques définitions :

• routage : faire pointer une route (node/{node}) à une action (afficher un noeud)
• chemin (ou path) : route dont les arguments sont définis (ex: node/123 est un chemin, pointant vers la route node/{node} où l'argument est 123)
• lien de menu : Texte (ou titre) pointant vers un chemin
• alias : associe un chemin système (node/123) vers un chemin arbitraire renseigné par le contributeur (mon-noeud)

Les propriétés d'une route

• _Permissions
• Les arguments sont nommés ({node}) et peuvent être chargés dans le Controller (en les typant avec une classe)
• Vous pouvez passer des paramètres fixes au controller en les indiquant dans la route

• Type d'élément de menu

  • *.routing.yml -> définit une URL
  • *.links.menu.yml -> lien de menu dans l'arborescence
  • *.links.task.yml -> onglet
  • *.links.action.yml -> "action" (back-office)

• Paramètres de routage : https://www.drupal.org/node/2092643

• <front>
• <nolink>

Pour voir les routes, utilisez la console : drupal debug:router

Utiliser des ParamConverter

Quelques fonctions de l'API à connaitre :

• \Drupal::currentUser() : utilisateur actuellement connecté
• Node::load() et Node::loadMultiple() pour charger des nœuds
• User::load() et User::loadMultiple() pour charger des utilisateurs
• \Drupal::entityTypeManager()->getStorage('node')->loadMultiple($nids);
• $entity->save() pour enregistrer un nœud, un utilisateur, ...
• $user->getDisplayName() pour afficher un nom d'utilisateur
• Node::create(['type' => article])->save();
• $node->set('body' => ['value' => 'My body']); $node->save();

• Concept historique Drupal
• Implémenter hook_form_alter() donnera mon_module_form_alter()
• Poids des modules et altération
• Répondent à des déclencheurs
• Des hooks peuvent être déclarés par des modules contrib
• Rappel: on ne « hack » JAMAIS le core (sauf en cas de module bogué)
• Tend à disparaître avec Drupal 8 (Plugins, yml, events), mais existe encore...
• Les implémentations sont mise en cache
• Liste des hooks https://api.drupal.org/api/drupal/core!core.api.php/group/hooks/8

Solution "historique" : les hooks

• hook_XXXXXXX_alter() : permettent de modifier des données créés par d'autres modules
• Liste des hooks

"Nouveauté" Drupal 8 : les Events symfony

• On "s'inscrit" à un événement (via un service) pour que le système nous appelle automatiquement et qu'on puisse réagir
• Liste des Events

• kernel.request : Au début de la gestion de la requête
• kernel.response : Une fois que la réponse est créée
• routing.route_dynamic : Permet aux modules d'enregistrer d'autres routes
• routing.route_alter : Permet de modifier les routes existantes

• AuthenticationSubscriber : Charge la session et initialize currentUser().
• LanguageRequestSubscriber : Détecte la langue courante
• PathSubscriber : Convertit l'URL en chemin système
• LegacyRequestSubscriber : Permet de définir un thème par défaut
• MaintenanceModeSubscriber : Affiche la page de maintenance si besoin
• RouteListener : Récupère le router chargé entièrement
• AccessSubscriber : Vérifie que le visiteur a accès à la route

Les données soumises et validées sont contenues dans $form_state->getValue('key').

Après exécution du _submit(), l'utilisateur est redirigé vers le formulaire vidé de ses valeurs, ou bien vers une route définie par $form_state->setRedirectUrl($url)

Chaque formulaire a un identifiant unique qui permet de l'altérer facilement par les autres modules.

• Validation par élément (#element_validate)
• #ajax (https://api.drupal.org/api/drupal/core!core.api.php/group/ajax/8) permet de faire de l'Ajax sans ecrire de JS (https://www.sitepoint.com/using-ajax-forms-drupal-8/)

• https://www.drupal.org/node/1905070
• $config = \Drupal::service('config.factory')->getEditable('monmodule.settings');
• $config->set('name', value)->save(); pour définir
• $config = \Drupal::config('monmodule.settings');
• $config->get('name'); pour récupérer
• $config = \Drupal::service('config.factory')->getEditable('monmodule.settings');
• $config->clear('name')->save(); pour supprimer une valeur
• $config = \Drupal::service('config.factory')->getEditable('monmodule.settings')->delete();

Documentation de l'API

• Utiliser ConfigFormBase

http://www.foreach.be/blog/how-manipulate-forms-drupal-8

http://drupal.stackexchange.com/questions/146434/send-a-form-to-twig-template

• Ancienne méthode (D7) : on créé ses propres tables manuellement
• Méthode Drupal 8 : on créé une entité (2 types : configuration ou contenu)
• Liste des possibilités de stockage D8 : https://www.palantir.net/blog/d8ftw-storing-data-drupal-8

• Gère la base de données
• Se situe dans le fichier .install
• hook_schema() -> crée une ou plusieurs tables
• hook_schema_alter() déclare une modification (mais ne la réalise pas)
• API de la structure
• Fonctions de l'API
• Les hook_update_N() servent à réaliser des actions sur la structure ou les données
• Très utile pour les mises à jour en production, et le test de celles-ci

• Recommandation : utiliser la console pour générer l'entité
• drupal generate:entity:content (ou drupal generate:entity:config)
• /!\ Attention /!\ : drush entity-updates / drupal update:entities à passer après la génération d'une entité pour mettre à jour le schéma de base de données

Le module fournit toujours le markup par défaut.

Le hook_theme() définit des hooks/clés qui pourront ensuite être utilisés via la propriété #theme des render arrays. Ces theme hooks généreront ensuite le markup HTML via un template.

On peut fournir des variables à ces theme hooks. Des fonctions preprocess peuvent ajouter ou modifier des variables, et également ajouter des suggestions de templates.

• Fonction template_preprocess_forums()
• fichier "templates/forums.html.twig"

• Un template engine pour PHP
• Créé par Fabien Potencier (Symfony)
• Documentation
• Très sécurisé
• Extensible

• {{ afficher }}
• {# commenter #}
• {% "programmer" %}

• {% if expr %} {% else %} {% endif %}
• {% for item in items %} ({% else %}) {% endfor %}

• {{ messages | join(', ') }}
• {{ "now" | date('d/m/Y H:i') }}
• {{ 'Home' | t }} (ajouté par Drupal)
• {{ content.field_date | format_date('short') }} (ajouté par Drupal)
• Voir core/lib/Drupal/Core/Template/TwigExtension.php pour la liste des rajouts Drupal

• Sur toute une section : {% filter upper %} Texte {% endfilter %}

• abs, batch, capitalize, convert_encoding, date, date_modify, default, escape, first, format, join, json_encode, keys, last, length, lower, merge, nl2br, number_format, raw, replace, reverse, round, slice, sort, split, striptags, title, trim, upper, url_encode

• dump(node)
• {{ max(1, 3, 2) }}
• {{ random(['pomme', 'orange', 'citron']) }}
• + celles fournies par Drupal :
  • link()
  • path()
  • url()
  • attach_library()

• {% include 'page.html.twig' with {'foo': 'bar', 'baz': 'bat'} %}

• https://www.drupal.org/node/2354645
• Pour Views : http://redcrackle.com/blog/drupal-8/theme-views-templates

• Level Up Your Twiggery

• Bonnes pratiques 
• Jquery (inclus dans Drupal) 
• Le « Drupal way » 

Bonnes pratiques JS

• « Unobtrusive javascript » 
  • Surcouche 
  • Comportements dégradés 
  • Accessibilité 

Voir les modules example

• jQuery
• jQuery UI
• Backbone
• Underscore

• https://api.drupal.org/api/drupal/services/8.6.x
• Les services à connaître :
  • router.admin_context (->isAdminRoute())
  • path.matcher (->isFrontPage() / ->match())
  • plugin.manager.mail (->mail())
  • title_resolver (->getTitle())
  • entity_type.manager (->getStorage())
  • ...

• Différence entre fichiers gérés et non gérés
• Différence entre fichiers privés et fichiers publics
• API complète https://api.drupal.org/api/drupal/core!includes!file.inc/group/file/8

Les streams wrappers

Un stream est un chemin, une URI, vers un fichier interne ou externe :

• public://
• private://

• "Valider les entrées, filtrer les sorties"

Concrètement

• URL : Html::escape(UrlHelper::stripDangerousProtocols($uri));
• Texte brut : Html::escape($string);
• Texte riche : check_markup($text, $format_id = NULL, $langcode = '', $filter_types_to_skip = array());
• HTML : Xss::filter($string, array $html_tags = NULL);
• Sinon, on considère que le texte est validé

Un bon article de blog sur le sujet

• https://thinkshout.com/blog/2019/05/recognizing-insecure-drupal-code/

En bonus, déplacez les fichiers

• https://www.drupal.org/node/2767907

Des entités

• C'est (presque) natif !
• Drupal console le génère pour vous.

Des tables "legacy"

• Utiliser le hook_views_data()
• documentation

Les données elles-mêmes

• hook_views_data_alter()

Leur affichage

• Views utilise des Plugins :
  • Field
  • Sort
  • Filter
  • ...

Depuis Drupal

• Drupal fait le plus gros du boulot
• Voir la conférence d'Aurelien Navarre

Depuis autre chose

• CSV, XML, JSON supportés par des plugins
• Une migration est un fichier YAML
• On ne code que si on a besoin de faire des traitements spécifiques
• Exemple détaillé
• Exemple SQL
• /!\ Support des traductions dans la 8.2.x /!\

• Migrate Plus : quelques fonctionnalités additionnelles pour Migrate
• Migrate Tools : commandes Drush supplémentaires (pour lancer des migrations)
• Migrate Source CSV : pour lire des fichiers CSV

• get() : plugin par défaut
• default_value : mettre une valeur
• callback : appeler une fonction
• concat, flatten, extract : quelques traitements simples de données
• skip_on_empty : permet de sauter une ligne de l'import si la valeur est vide
• skip_row_if_not_set : permet de sauter une ligne si la valeur n'est pas définie
• entity_lookup : rechercher une entité (par Migrate Plus)
• entity_generate : créer une entité (par Migrate Plus)
• Écrivez le vôtre, c'est un plugin (MigrateProcessPlugin)

• Les profils d'installation et les distributions
• Le packaging du site
  • Drush make
  • composer
• La gestion de la configuration
  • CMI
  • Features

Qu'est ce que c'est

• Simplement une pré-configuration de Drupal.
• Peut contenir vos propres modules, et votre propre configuration !

Quelques exemples de distribution Drupal 8

• Lightning (avec Roadmap) ~ sert de démo pour les capacités de Drupal 8
• Commerce 2.x : refonte complète par rapport à la version Drupal 7
• OpenSocial
• ContentaCMS

Utilisation de Composer

• Et notamment de Drupal Project
• composer create-project drupal-composer/drupal-project
• composer require drupal/devel:8.*
• Solution désormais à privilégier pour Drupal 8
• /!\ Attention aux composer update /!\

Configuration Management Initiative (CMI)

• Nouveauté Drupal 8 : tout ce qui n'est pas du contenu est exportable indépendamment du reste du site

Problème

• Actuellement, on ne peut le réimporter que sur une même "version" du site (un site dont l'installation s'est faite à partir d'une copie de la base de données du site)
• En cours de résolution

• Installer un site (peu importe le moyen, profil, dump, ...)
• Exporter toute la configuration du site (drush cex)
• Ensuite, chaque nouveau développeur devra faire :
  • Installer le site en utilisant l'installation depuis une config. existante
  • Utiliser un workflow classique d'export / import (drush cex / cim)
• Il reste des problèmes :
  • Export d'une configuration non souhaitée (devel, ...)
  • Utiliser "Configuration Split"
  • Voir le blog de la société Nuvole

• Les profils d'installation pourront directement importer une configuration
  • Déjà opérationnel grâce à un patch
• Voir https://www.chapterthree.com/blog/installing-drupal-8-from-configuration

• Suppression du code déprécié
• composer require mglaman/drupal-check --dev
• ./vendor/bin/drupal-check [directory]

• Outils d'analyse statique
  • composer require mglaman/phpstan-drupal --dev
  • composer require vimeo/psalm --dev