--- categories: web CMS title: Howto Drupal --- * Documentation : [Drupal](https://www.drupal.org/) est un CMS libre écrit en PHP. ## Pré-requis * Un serveur web (Apache/Nginx/...) * Une base de données MySQL/Mariadb ou PostgreSQL * PHP 8.1 (Drupal 10), PHP 7.4/8.0/8.1 (Drupal 9), PHP 7.3/7.4 (Drupal 7 et 8) * Pour Drush : /home en `exec` et `mariadb-client` installé Pour plus de détails, voir [la documentation de Drupal](https://www.drupal.org/docs/user_guide/en/install-requirements.html) notamment : * [pré-requis pour Drupal 7](https://www.drupal.org/docs/7/system-requirements/) * [pré-requis pour Drupal 8 et versions suivantes](https://www.drupal.org/docs/system-requirements/) ### Apache Drupal est livré avec des fichiers `.htaccess` qui utilisent un nombre varié de directives. La configuration Apache doit donc contenir au minimum : ~~~{.apache} AllowOverride AuthConfig Limit FileInfo Indexes Options=Indexes,MultiViews,ExecCGI,Includes ~~~ Le `DocumentRoot` d'Apache doit correspondre au dossier `web` qui se trouve à la racine du dossier du projet ### Nginx Un exemple complet de vhost Nginx pour Drupal est accessible sur [dans la documentation de Nginx](https://www.nginx.com/resources/wiki/start/topics/recipes/drupal/) ### PHP Certains ajustements sont nécessaires #### Web ( FPM / libapache2-mod-php ) *TODO?* #### CLI C'est surtout pour `composer` et `drush` qui nécessitent : * (composer) Le non blocage de la fonction `putenv()` * (composer) Autoriser l'ouverture d'url (allow_url_fopen) * (drush) Aucune fonction désactivée (ie: disable_functions vide) sinon drush refuse de fonctionner.... ## Installation Il existe [plusieurs méthodes pour installer Drupal](https://www.drupal.org/docs/getting-started/installing-drupal/get-the-code). La méthode conseillée est d'utiliser [composer](HowtoPHP#composer) Ainsi, une installation par défaut va se faire avec la commande suivante va créer une nouvelle installation et récupérer toutes les dépendances avec composer. ~~~ $ mkdir www/ $ composer create-project drupal/recommended-project www $ cd www/ $ composer show | grep ^drupal drupal/core 10.2.1 Drupal is an open source content management platform powering millions of websites and applications. drupal/core-composer-scaffold 10.2.1 A flexible Composer project scaffold builder. drupal/core-project-message 10.2.1 Adds a message after Composer installation. drupal/core-recommended 10.2.1 Core and its dependencies with known-compatible minor versions. Require this project INSTEAD OF drupal/core. ~~~ On peut en suite, aller directement à l'addresse du site (DocumentRoot qui pointe vers `/home/foo/www/web/`) pour obtenir l'interface de finalisation du site. On aura notamment besoin d'avoir des identifiants pour accéder à une base de données. On peut également finaliser l'installation avec Drush (cf plus bas) : ~~~ $ cd www $ drush site:install standard Database name [drupal]: > foo Database driver [mysql]: > Database username [drupal]: > foo Database password [drupal]: > PASSWORD Database host [127.0.0.1]: > Database port [3306]: > You are about to: * DROP all tables in your 'foo' database. Do you want to continue? (yes/no) [yes]: > [notice] Starting Drupal installation. This takes a while. [notice] Performed install task: install_select_language [notice] Performed install task: install_select_profile [notice] Performed install task: install_load_profile [notice] Performed install task: install_verify_requirements [notice] Performed install task: install_settings_form [notice] Performed install task: install_verify_database_ready [notice] Performed install task: install_base_system [notice] Performed install task: install_bootstrap_full [notice] Performed install task: install_profile_modules [notice] Performed install task: install_profile_themes [notice] Performed install task: install_install_profile [notice] Performed install task: install_configure_form [notice] Performed install task: install_finished [success] Installation complete. User name: admin User password: PASSWORD $ cd web/sites/default/ $ drush sql-connect mysql --user=foo --password='PASSWORD' --database=foo --host=127.0.0.1 --port=3306 -A $ drush status Drupal version : 10.2.1 Site URI : http://default DB driver : mysql DB hostname : 127.0.0.1 […] ~~~ La configuration de Drupal qse trouve dans le fichier `web/sites/default/settings.php` : ~~~ 'drupal', 'username' => 'drupal', 'password' => 'PASSWORD', 'prefix' => '', 'host' => '127.0.0.1', 'port' => '3306', 'isolation_level' => 'READ COMMITTED', 'driver' => 'mysql', 'namespace' => 'Drupal\\mysql\\Driver\\Database\\mysql', 'autoload' => 'core/modules/mysql/src/Driver/Database/mysql/', ); $settings['config_sync_directory'] = 'sites/default/files/config_DVQYtOdt2FEtnXLrOuHYfICqXRN0mJKX7lnAe1Nyjq5kPOWwPtpgjCwmtE8XOs8soZgUbh_wjw/sync'; ~~~ ### Cron ~~~ $ crontab -l 42 * * * * php /home/foo/www/vendor/bin/drush cron --root /home/foo/www/ 2&>1 >/dev/null ~~~ ## drush [Drush](https://www.drush.org/) est un outil en ligne de commande pour installer/gérer des sites Drupal. Liste des commandes disponibles par défaut : ### Installation Pour installer la dernière version : ~~~ $ cd www/ $ composer require drush/drush $ composer require symfony/http-kernel $ composer show drush/drush | grep ^version versions : * 12.4.3 $ php ./vendor/bin/drush version Drush version : 12.4.3.0 ~~~ Pour installer une ancienne version : ~~~ $ composer global require drush/drush:8.4.8 $ php ./.composer/vendor/bin/drush version Drush Version : 8.4.8 ~~~ ou ~~~ $ composer require drush/drush:8.4.8 $ php ./vendor/bin/drush version Drush Version : 8.4.8 ~~~ ### Utilisation Au sein d'un site Drupal, on peut vérifier/collecter différentes informations : ~~~ $ cd www/ $ drush sql-connect mysql --user=drupal --password='PASSWORD' --database=drupal --host=127.0.0.1 --port=3306 -A $ drush status Drupal version : 10.2.1 Site URI : http://default PHP binary : /usr/bin/php8.2 PHP config : /etc/php/8.2/cli/php.ini PHP OS : Linux PHP version : 8.2.7 Drush script : /home/foo/www/vendor/bin/drush Drush version : 12.4.3.0 Drush temp : /tmp Drush configs : /home/foo/www/vendor/drush/drush/drush.yml Drupal root : /home/foo/www/web Site path : sites/default ~~~ ### Alias Fichiers dans le répertoire `~/.drush/` : * `local.drushrc.php` : configuration générale * `FOO.alias.drushrc.php` : contexte spécifique pour la commande `drush @FOO` * `BAR.alias.drushrc.php` : contexte spécifique pour la commande `drush @BAR` ~~~ $ cat ~/.drush/FOO.alias.drushrc.php $aliases['FOO'] = array ( 'uri' => 'foo.example.com', 'root' => '/home/foo/www/web', ... ~~~ ## Configuration ### Configuration derrière un reverse-proxy Dans la configuration de Drupal, des directives sont à activer pour la prise en compte des headers HTTP X-Forwarded-For). ~~~php $settings['reverse_proxy'] = TRUE; $settings['reverse_proxy_addresses'] = ['192.0.2.1']; ~~~ Pour le HTTPS (signalé via X-Forwarded-Proto), il y a déjà des directives de configuration pour prendre ce réglage en compte. Elles ressemblent à : ~~~php /** * If external request was HTTPS but internal request is HTTP, set $_SERVER['HTTPS'] so Drupal detects the right scheme. */ if (isset($_SERVER['HTTP_X_FORWARDED_PROTO']) && isset($_SERVER['REQUEST_SCHEME'])) { if ($_SERVER['HTTP_X_FORWARDED_PROTO'] == 'https' && $_SERVER["REQUEST_SCHEME"] == 'http') { $_SERVER['HTTPS'] = 'on'; } } ~~~ ## Multisite Il est possible de créer différents sites Drupal à partir d'une même installation. Cela permet d'avoir une seule fois le code source de Drupal et donc une gestion simplifiée. Cela peut avoir des inconvénients si besoin de gérer finement des ensembles de personnalisations différentes par site. On suppose qu'une installation de base de Drupal a été faite, et Drush également installé. > *Note* : il est nécessaire d'avoir la commande `mysql` installée, donc `mariadb-client` doit être installé là où tourne PHP Pour l'installation d'un premier site distinct du `default` créé à l'installation de Drupal : ~~~ $ cd www/ $ drush site:install standard --sites-subdir=test1 Database name [drupal]: > foo_test1 www Database driver [mysql]: > Database username [drupal]: > foo Database password [drupal]: > PASSWORD Database host [127.0.0.1]: > Database port [3306]: > You are about to: * Create a sites/test1/settings.php file * Create a sites/sites.php file * DROP all tables in your 'foo_test1' database. Do you want to continue? (yes/no) [yes]: > [notice] Starting Drupal installation. This takes a while. [notice] Performed install task: install_select_language [notice] Performed install task: install_select_profile [notice] Performed install task: install_load_profile [notice] Performed install task: install_verify_requirements [notice] Performed install task: install_settings_form [notice] Performed install task: install_verify_database_ready [notice] Performed install task: install_base_system [notice] Performed install task: install_bootstrap_full [notice] Performed install task: install_profile_modules [notice] Performed install task: install_profile_themes [notice] Performed install task: install_install_profile [notice] Performed install task: install_configure_form [notice] Performed install task: install_finished [success] Installation complete. User name: admin User password: PASSWORD ~~~ Cela crée donc un fichier `web/sites/sites.php` pour gérer plusieurs sites. Et les sites sont « crées » dans des répertoires `web/sites/SITE/` contenant principalement un fichier `settings.php` contenant notamment les paramètres de base de données du site. ~~~ $ cd web/sites/test1/ $ drush sql-connect mysql --user=foo --password='PASSWORD' --database=foo_test1 --host=127.0.0.1 --port=3306 -A $ drush status Drupal version : 10.2.1 Site URI : http://test1 DB driver : mysql DB hostname : 127.0.0.1 […] ~~~ Il suffit ensuite de créer la configuration Apache ou Nginx pour les FQDN souhaités avec un DocumentRoot dans `web/` et de bien configurer le fichier `web/sites/sites.php` par exemple : ~~~ $sites['test1.example.com'] = 'test1'; $sites['test2.example.com'] = 'test2'; ~~~ On peut utiliser la commande Drush sur un site en particulier via l'argument `-l` : ~~~ $ drush -l test1 status $ drush -l test1 updatedb ~~~ ## Optimisation * Drupal 7 : * Drupal 8 : ### watchdog Désactiver le logging non nécessaire en prod... surtout dans la base de données : À noter que l'on peut lire, supprimer, etc. avec Drush : https://www.drush.org/12.x/commands/watchdog_delete/ https://www.drush.org/12.x/commands/watchdog_list/ https://www.drush.org/12.x/commands/watchdog_show/ ### cache Dans les versions récentes, Drupal génère du cache, notamment via Twig. Cela peut générer des entrées dans les tables MySQL cache_page, cache_date, etc. On peut lire la configuration courant de Twig via : ~~~ $ drush php:eval "var_export(\Drupal::getContainer()->getParameter('twig.config'));" array ( 'debug' => true, 'auto_load' => true, 'cache' => true, ) ~~~ #### désactiver le cache Twig Dans `sites/default/` (ou le répertoire du site ciblé) on crée un fichier `service.yml` contenant notamment : ~~~ parameters: twig.config: cache: false ~~~ On crée également un fichier `settings.local.php` contenant notamment : ~~~ $settings['cache']['bins']['render'] = 'cache.backend.null'; $settings['cache']['bins']['page'] = 'cache.backend.null'; $settings['cache']['bins']['dynamic_page_cache'] = 'cache.backend.null'; ~~~ Ce fichier `settings.local.php` doit être inclus dans `settings.php` : ~~~ if (file_exists($app_root . '/' . $site_path . '/settings.local.php')) { include $app_root . '/' . $site_path . '/settings.local.php'; } ~~~ Enfin, n'oubliez pas de vider le cache via Drush après tout changement de configuration : ~~~ $ drush cache:rebuild $ drush php:eval "var_export(\Drupal::getContainer()->getParameter('twig.config'));" ~~~ À noter que dans les versions les plus récentes, on peut forcer via des variables : ~~~ $ drush state:set twig_cache_disable 1 --input-format=integer $ drush state:set disable_rendered_output_cache_bins 1 --input-format=integer $ drush cache:rebuild ~~~ ## Sécurité ### Annonces de sécurité Nous recommandons aux développeurs de garder un œil sur [les annonces de sécurité](https://www.drupal.org/security) faites par l'équipe Drupal. ### CVE-2018-7600 // SA-CORE-2018-002 Règle mod_security de protection (théorique) ~~~ SecRule ARGS_GET_NAMES|ARGS_POST_NAMES|REQUEST_COOKIES_NAMES "^#" "t:none,log,deny,msg:'CVE-2018-7600/Drupal-SA-CORE-2018-002 -- Deny # in (cookie|query|post) names',id:300000001" ~~~ ## Plomberie ### An automated attempt to create the directory ../config/sync failed, possibly due to a permissions problem. Ça arrive quand on a initialisé un projet Drupal depuis composer. Il semble que ce soit [un vieux bug non corrigé](https://github.com/drupal-composer/drupal-project/issues/274) La solution est de créer un dossier `config/sync` a la racine du projet, avec des droits d'écritures pour le serveur web. ### Gestion des utilisateurs ~~~ MariaDB> select * from users,users_field_data where users.uid=users_field_data.uid; +-----+--------------------------------------+----------+-----+----------+--------------------+--------------------------+--------+---------+-------------------+----------+--------+------------+------------+------------+------------+------------------+------------------+ | uid | uuid | langcode | uid | langcode | preferred_langcode | preferred_admin_langcode | name | pass | mail | timezone | status | created | changed | access | login | init | default_langcode | +-----+--------------------------------------+----------+-----+----------+--------------------+--------------------------+--------+---------+-------------------+----------+--------+------------+------------+------------+------------+------------------+------------------+ | 0 | 0b713940-204b-41c3-93aa-2380aa773d70 | en | 0 | en | en | NULL | | NULL | NULL | | 0 | 1708703180 | 1708703180 | 0 | 0 | NULL | 1 | | 1 | b2f79d0b-638c-4d45-927c-f196e33417e2 | en | 1 | en | en | NULL | admin | $2y$... | admin@example.com | UTC | 1 | 1708955952 | 1708956585 | 1708956573 | 1708956573 | init@example.com | 1 | +-----+--------------------------------------+----------+-----+----------+--------------------+--------------------------+--------+---------+-------------------+----------+--------+------------+------------+------------+------------+------------------+------------------+ ~~~ ## FAQ ### The website encountered an unexpected error. Please try again later Si vous obtenez cette erreur, c'est qu'il y a une erreur quelque part avec le code PHP. Deux suggestions pour accéder à l'erreur PHP : * Si vous avez activé le watchdog, l'erreur devrait se trouver dans la table `watchdog` (que vous pouvez notamment lire avec drush) * Dans le fichier `errors.inc` appliquez **temporairement** ce patch pour voir l'erreur PHP dans votre page : ~~~ < print theme('maintenance_page', array('content' => t('The website encountered an unexpected error. Please try again later.'))); --- > print theme('maintenance_page', array('content' => t('The website encountered an unexpected error. Please try again later.\n'.$fatal.' '.var_export($error,true)))); ~~~