Comment faire fonctionner votre installation Drupal 8 (Ă nouveau).
Les bases
Dans Drupal 8, les URL propres sont activées par défaut et ne peuvent pas être désactivées. Cependant, le module de réécriture doit être activé sur votre serveur web.
Vérifiez la barre d’adresse de votre navigateur. Les URL de votre site ne doivent pas contenir « ?q= » dans l’URL.
Exemple d’URL propres correctes :
http://www.example.com/node/83
Exemple d’URL propres qui ne fonctionnent pas :
http://www.example.com/?q=node/83
Ce guide contient des tutoriels et d’autres informations nécessaires pour créer des modules pour Drupal 8.
Autres sources :
Drupal 8 utilise un certain nombre de fonctionnalités avancées du langage PHP et des bibliothèques tierces complexes pour fournir aux développeurs externes l'API la plus avancée de tous les CMS disponibles. Bien que les développeurs expérimentés de Drupal 7 puissent remarquer certains changements importants, la majeure partie de la structure de base restera familière.
Dans les sous-sections suivantes du guide, nous allons créer des exemples de différentes parties d’un site Drupal, telles qu’une page personnalisée, un bloc, une entité, un champ, etc. Tous les exemples commencent par le dossier du module et le fichier .info.yml, et avec seulement ces deux éléments, le module apparaîtra sur la page d’administration des extensions de Drupal 8 ou pourra être activé directement via Drush.
Avant de commencer
Si vous souhaitez que PHP vous aide à détecter vos erreurs sur un site de test, essayez les réglages décrits ici : Afficher toutes les erreurs en développement.
Nommez votre module
La première étape dans la création d’un module est de choisir un « nom machine » court. Ce nom machine sera utilisé dans plusieurs fichiers et fonctions de votre module, et le noyau Drupal l’utilisera pour identifier votre module en programmation.
Sujet principal : métadonnées du projet
Le fichier .info.yml (également appelé « fichier info yaml ») est une partie essentielle d’un module, thème ou profil d’installation Drupal 8 pour stocker les métadonnées du projet.
Ces fichiers .info.yml sont nécessaires pour :
Lors du développement de modules personnalisés, plusieurs scénarios exigent que le développeur ajoute un fichier composer.json à son module. Certains de ces scénarios dépendent du fait que le module personnalisé est destiné à être partagé avec la communauté en tant que projet sur drupal.org.
Si le développeur du module souhaite utiliser une bibliothèque PHP hébergée sur packagist.org, il doit ajouter un fichier composer.json à son projet.
Dans la section suivante, nous allons aborder la création d’un module simple. Il existe une longue tradition selon laquelle le premier programme que vous écrivez dans tout nouveau système affiche « Hello World ! » à l’écran.
Bien que Drupal soit l’un des projets open source les plus audacieux et progressistes, il est également profondément enraciné dans les traditions anciennes de la science et de la technique.
La fonction content() dans la classe HelloController retourne un texte de balisage lorsque le système de routage appelle la page.
Dans le dossier de votre module, vous devez avoir la structure standard PSR-4 /src/Controller, et dans ce dossier, un fichier contrĂ´leur HelloController.php.
Ainsi, votre fichier contrôleur sera situé ici :
/src/Controller/HelloController.php
Voici le code présent dans le fichier HelloController.php :