# WordPress

## Ce que c'est

WordPress est un système de gestion de contenu à code source ouvert : un
logiciel PHP qui conserve les articles, les pages, les enregistrements de
médias, les utilisateurs et les paramètres d'un site dans une base MySQL ou
MariaDB et en assemble les pages à la demande. Les fichiers de médias
téléversés se trouvent normalement hors de la base de données. Son nom est
souvent abrégé en WP, préfixe que portent aussi ses propres fichiers et
dossiers (wp-config.php, wp-content, wp-admin). Il est distribué sous GPLv2
ou ultérieure : le télécharger, l'exécuter ou le modifier ne coûte donc rien.

Un site WordPress comporte trois couches. Le cœur est le code partagé que
chacun télécharge et met à jour. Un thème commande la présentation, et les
extensions ajoutent le comportement : c'est la séparation que trace le manuel
des thèmes du projet. Les deux accèdent au cœur par des hooks, points nommés
dans le code de WordPress où d'autre code peut s'exécuter. Les hooks sont des
actions ou des filtres. Une action s'exécute à un moment précis, par exemple
à l'enregistrement d'un article, et ne renvoie rien. Un filtre reçoit une
valeur, la modifie et la rend. Celui-ci réduit les extraits automatiques
d'articles de 55 mots par défaut à 30 :

```php
add_filter( 'excerpt_length', function ( $length ) {
    return 30;
} );
```

Les thèmes ont changé de forme au fil des années. Les thèmes classiques
utilisent le système de modèles PHP apparu avec WordPress 1.5 en 2005, et
restent très répandus. Les thèmes de blocs constituent l'approche actuelle :
leurs modèles sont des fichiers HTML composés de blocs, modifiables dans
l'éditeur de site, avec les couleurs, les polices et les espacements dans un
fichier theme.json. Les thèmes hybrides sont des thèmes classiques qui ont
adopté certaines fonctionnalités des blocs.

Le contenu quitte aussi le site en JSON par l'API REST, sur laquelle repose
l'éditeur de blocs lui-même. Une requête vers l'adresse /wp-json/ du site
renvoie la liste structurée de toutes les routes proposées. Le contenu public
est lisible sans se connecter à un compte, et toute donnée privée exige une authentification.
N'importe quel programme peut récupérer les trois derniers articles ainsi :

```sh
curl -s 'https://example.com/wp-json/wp/v2/posts?per_page=3'
```

Pour le faire fonctionner, le projet recommande PHP 8.3 ou une version ultérieure,
MySQL 8.0 ou MariaDB 10.11 ou une version ultérieure, ainsi que HTTPS, de préférence sur
Apache ou Nginx. Joomla et Drupal sont des systèmes de gestion de contenu du
même genre. Les deux autres voies auxquelles le comparer sont une application
sur mesure reposant sur un framework tel que Django et un générateur de sites
statiques.

## Pourquoi c'est important

La vraie décision derrière WordPress est de savoir qui modifiera le site
après son lancement et qui assurera sa sécurité pendant ce temps. WordPress
donne aux équipes non techniques un éditeur complet : elles peuvent publier
une page, remplacer une image, ajouter un utilisateur ou remanier un menu
sans ouvrir de ticket. Sur un site qui change chaque semaine, la modification
la moins chère est celle qui ne demande pas de développeur.

La licence est gratuite, mais le site ne l'est pas. La GPL couvre le logiciel,
et wordpress.org considère les extensions et les thèmes comme des œuvres
dérivées qui héritent de la même licence. Les dépenses se déplacent ailleurs :
l'hébergement capable d'exécuter PHP et une base de données, les heures nécessaires pour
choisir, configurer et tester un thème, et le travail continu de mise
à jour du cœur, des extensions, des thèmes et de la version de PHP. Ce dernier
coût dure toute la vie du site, et un devis devrait préciser qui le prend en
charge.

Cette maintenance découle du fait que WordPress est une application vivante.
Pour générer une page non mise en cache, PHP interroge une base de
données ; un cache de pages complètes peut servir une page enregistrée.
Le code des extensions s'exécute avec les mêmes accès que le cœur, et l'écran
de connexion est exposé à Internet, sauf si quelqu'un ajoute un second verrou
devant lui. Les mises à jour du cœur en arrière-plan sont apparues dans la
version 3.7. Les nouvelles installations à partir de 5.6 activent par défaut
les mises à jour mineures et majeures du cœur, sous réserve de la configuration
et des conditions d'éligibilité aux mises à jour ; les installations plus
anciennes conservent leurs réglages antérieurs, sauf modification. PHP suit
son propre calendrier de mises à jour.

Une réalisation sur mesure convient aux données et aux processus qui ne
ressemblent en rien à des pages et à des articles, et ses outils d'édition
doivent être construits et entretenus. Une génération statique retire
l'application PHP et la base de données du trajet des requêtes, tandis que
le serveur et les outils de génération restent à entretenir. Ses rédacteurs
travaillent généralement au moyen de fichiers et d'une étape de génération.
WordPress convient au vaste entre-deux : un site assez standard que ses
propriétaires exploiteront eux-mêmes, où les écrans d'édition valent la
maintenance qu'ils entraînent. La dépendance à la plateforme reste modeste,
car le code est sous GPL, le contenu réside dans une base SQL ordinaire, et
l'API REST sert les articles, les pages et les taxonomies en JSON.

## À quoi cela ressemble en pratique

Dans les travaux de cette entreprise, WordPress est une réponse parmi
d'autres, choisie délibérément.
[Le compte rendu de cent applications web](/fr/portfolio/developed-100-web-applications-using-html-html5/)
couvre la période 2003–2014 et expose la règle de choix. Lorsqu'un client avait
besoin de sur-mesure, la réalisation reposait sur HTML/HTML5, CSS/SCSS et
Django. Lorsqu'il lui fallait un site plus standard qu'il puisse aussi
entretenir lui-même, WordPress ou Joomla permettait d'y arriver plus vite
et était plus pertinent.

Ce que ce compte rendu valorise, c'est le jugement, pas l'outil. Une partie
du travail décrit consistait à distinguer les deux cas : détourner un client
d'une réalisation sur mesure dont il n'avait pas besoin et l'y encourager
lorsque ce besoin était réel.

Sous forme de questions auxquelles un acheteur peut répondre avant de
demander un devis, ce jugement se présente ainsi :

- Des personnes modifieront-elles le site sans développeur chaque semaine,
  ou ne changera-t-il que quelques fois par an ?
- Le contenu se prête-t-il à des pages, des articles, des catégories et des
  médias, ou exige-t-il son propre modèle de données et ses propres règles ?
- Qui maintiendra le cœur, les extensions et PHP à jour pendant toute la vie
  du site ?
- Le site reposera-t-il sur quelques extensions bien entretenues ou sur des
  dizaines assemblées pour imiter une application ?

Des modifications hebdomadaires, un contenu adapté, une personne désignée pour
la maintenance et une courte liste d'extensions orientent vers WordPress ou
un CMS du même type. Des données inhabituelles, ou l'absence de personne pour
le maintenir à jour, orientent vers une réalisation sur mesure ou un site
statique.

## Où les problèmes surviennent

### Une mise à jour ordinaire casse le site

Quelqu'un met à jour une extension, puis une page affiche une erreur ou le
tableau de bord refuse de se charger. Le site avait accumulé des extensions
pendant des années, dont certaines abandonnées par leurs auteurs : chacune
était du code PHP tiers disposant d'un accès complet, et deux sont entrées
en conflit. Gardez une liste courte et supprimez toute extension que le site
n'utilise plus, comme le demande le guide de sécurisation. Faites une
sauvegarde avant chaque mise à jour, testez d'abord les mises à jour majeures
sur une copie et privilégiez les extensions dont les auteurs publient encore
des versions.

### Les modifications sur mesure disparaissent après une mise à jour ou une refonte

Une adaptation qui fonctionnait depuis des mois disparaît le jour de la mise
à jour du thème, ou une fonctionnalité essentielle à l'entreprise manque
lorsque le site change d'apparence. Dans le premier cas, quelqu'un avait
modifié les fichiers d'un thème qu'il n'avait pas écrit, et la mise à jour
les a remplacés ; le manuel des thèmes avertit qu'une fonction ajoutée
directement à functions.php disparaît à la prochaine mise à jour du thème.
Dans le second cas, un comportement essentiel au site se trouvait dans le
thème et est parti avec lui. Placez les modifications du thème d'un tiers dans
un thème enfant et les fonctionnalités dans une petite extension de votre
cru reliée au cœur par des hooks : le thème ne porte alors que la présentation.

### Un mot de passe d'administration devient du code sur le serveur

Quiconque vole le mot de passe d'un administrateur peut passer de l'édition
d'articles à l'exécution de son propre PHP, car le tableau de bord comprend
un éditeur de fichiers de thèmes et d'extensions. Une ligne dans wp-config.php
désactive cet éditeur, ce qui revient à retirer les capacités edit_themes,
edit_plugins et edit_files à tous les utilisateurs :

```php
define( 'DISALLOW_FILE_EDIT', true );
```

Cela ferme une voie parmi plusieurs, et le manuel dit clairement que cela
n'arrêtera pas un attaquant capable de téléverser des fichiers malveillants.
Associez cette mesure à des mots de passe robustes, à une authentification en deux
étapes pour chaque administrateur et à aussi peu de comptes d'administration
que le travail le permet.

### Le site prend du retard sur la version courante

Le tableau de bord affiche une bannière de nouvelle version pendant des
mois, tandis que le site utilise une version majeure ou une version de PHP
très en retard sur l'actuelle. Un site configuré pour ne recevoir que les
mises à jour mineures du cœur peut continuer à se corriger tandis que sa
version majeure et PHP prennent du retard, jusqu'à ce qu'une extension dont
il dépend exige quelque chose de plus récent. Les nouvelles installations
à partir de 5.6 activent aussi les mises à jour majeures du cœur par défaut,
mais la configuration peut changer cela. Inscrivez les mises à jour majeures
au calendrier, vérifiez en même temps la version de PHP par rapport à la page
des prérequis du projet et testez les deux sur une copie avant de les appliquer au site en
production.

## Pour aller plus loin

- [WordPress Documentation](https://wordpress.org/documentation/)
  — le manuel du projet pour exploiter un site, de la publication et des médias
  à l'installation et à la maintenance.
- [Requirements](https://wordpress.org/about/requirements/)
  — les versions de PHP, MySQL et MariaDB que le projet recommande aujourd'hui.
- [Upgrading WordPress](https://developer.wordpress.org/advanced-administration/upgrade/upgrading/)
  — les mises à jour en arrière-plan, en un clic et manuelles, avec la sauvegarde
  à effectuer d'abord.
- [Hardening WordPress](https://developer.wordpress.org/advanced-administration/security/hardening/)
  — les permissions des fichiers, les privilèges de base de données, le
  commutateur de l'éditeur de fichiers et l'entretien des extensions.
- [Plugin Handbook: Hooks](https://developer.wordpress.org/plugins/hooks/)
  — comment les actions et les filtres permettent de modifier WordPress sans
  toucher au cœur.
- [REST API Handbook](https://developer.wordpress.org/rest-api/)
  — les routes, les points d'accès et l'authentification de l'API sur laquelle
  repose l'éditeur de blocs.

<https://engineer.company/fr/glossary/wordpress/>
