Installation manuelle

Module 2: Installer et configurer · Temps de lecture : 9 minutes

Objectif d'apprentissage : à l'issue de cette leçon, vous saurez installer WordPress sans installeur et vous comprendrez ce qu'un installeur fait pour vous.

Notions clés : téléchargement depuis wordpress.org, somme de contrôle, SFTP, base de données, utilisateur de base de données, droits minimaux, wp-config-sample.php, clés et sels (salts), préfixe de table, script d'installation, WP-CLI

Pourquoi le faire une fois à la main

Même si vous utilisez toujours un installeur, il est instructif d'installer WordPress une fois à la main. Vous voyez alors quels éléments existent et comment ils s'articulent. Cela vous aidera plus tard lors d'une migration, face à une base de données qui ne se connecte pas, ou pour un site que vous reprenez sans installeur. Et tous les hébergeurs n'ont pas d'installeur.

Les étapes : télécharger WordPress, l'envoyer sur le serveur, créer une base de données, renseigner wp-config.php et exécuter le script d'installation.

Étape 1 : téléchargement, et uniquement depuis wordpress.org

Téléchargez toujours WordPress depuis https://wordpress.org/download/ (ou la version française de https://fr.wordpress.org/). Jamais depuis un autre site : une version modifiée peut contenir une porte dérobée.

Sur la page de téléchargement de wordpress.org figure, pour chaque version, une somme de contrôle (SHA-1 ou MD5). Elle permet de vérifier que votre téléchargement n'a pas été modifié en chemin. Sur votre propre ordinateur par exemple :

sha1sum wordpress-7.1.4.zip            (Linux)
shasum -a 1 wordpress-7.1.4.zip        (macOS)
certutil -hashfile wordpress-7.1.4.zip SHA1   (Windows)

Le résultat doit être exactement identique à la valeur indiquée sur wordpress.org.

Étape 2 : envoi sur le serveur

Décompressez le fichier zip. Vous obtenez un dossier wordpress contenant wp-admin, wp-includes, wp-content et les fichiers isolés. Placez le contenu de ce dossier dans votre répertoire web (public_html), pas le dossier lui-même ; sinon votre site se retrouve sur example.com/wordpress/.

L'envoi peut se faire de deux façons :

• Avec un programme FTP comme FileZilla. Utilisez SFTP ou FTPS, pas le FTP classique : avec le FTP classique, votre mot de passe circule sur internet sans chiffrement.
• Sous forme de zip via le Gestionnaire de fichiers de votre panneau, puis décompressez-le là. C'est souvent bien plus rapide que d'envoyer des milliers de fichiers séparés.

Étape 3 : base de données et utilisateur de base de données

Créez dans votre panneau une nouvelle base de données et un utilisateur de base de données. Veillez à deux choses :

• Un utilisateur dédié par site. N'utilisez pas un seul utilisateur de base de données pour tous vos sites, et surtout pas le compte principal de votre hébergement. Si un site est piraté, l'intrus ne pourra accéder, avec ces identifiants, qu'à cette seule base de données.
• Droits : pour un usage courant, WordPress a besoin de lire, écrire, modifier et supprimer des données (SELECT, INSERT, UPDATE, DELETE). Pour l'installation et les mises à jour qui modifient la structure des tables, CREATE, ALTER, INDEX et DROP sont également nécessaires. En pratique, la plupart des panneaux accordent à l'utilisateur tous les droits sur cette seule base de données. C'est acceptable, tant que cela reste cette seule base de données.

Notez le nom de la base de données, le nom d'utilisateur, le mot de passe et l'hôte. Chez la plupart des hébergeurs, l'hôte est localhost. Sous DirectAdmin, la base de données et l'utilisateur reçoivent le nom de votre compte comme préfixe, par exemple utilisateur_wp1.

Étape 4 : wp-config.php

Dans le dossier se trouve wp-config-sample.php. Copiez ce fichier en wp-config.php et renseignez :

define( 'DB_NAME', 'utilisateur_wp1' );
define( 'DB_USER', 'utilisateur_wp1' );
define( 'DB_PASSWORD', 'le-mot-de-passe-de-l-etape-3' );
define( 'DB_HOST', 'localhost' );

Remplacez ensuite les huit lignes contenant put your unique phrase here par de nouvelles clés et sels (salts). Vous les obtenez sur https://api.wordpress.org/secret-key/1.1/salt/ : chaque fois que vous ouvrez cette page, vous obtenez de nouvelles valeurs aléatoires. Collez-les à la place des lignes d'exemple.

Choisissez éventuellement un préfixe de table différent de wp_, par exemple si vous placez plusieurs installations dans une seule base de données. Uniquement des lettres, des chiffres et un tiret bas.

Enregistrez wp-config.php. Si vous sautez cette étape, WordPress ouvrira lui-même, à l'étape 5, un formulaire dans lequel vous renseignerez les informations de la base de données. Cela fonctionne, mais vous ne choisissez alors pas vous-même les clés et le préfixe.

Étape 5 : le script d'installation

Ouvrez https://example.com/wp-admin/install.php dans votre navigateur. WordPress demande la langue, le nom du site, le nom d'utilisateur et le mot de passe de l'administrateur, l'adresse e-mail, et si les moteurs de recherche peuvent indexer le site. Il crée ensuite les tables et le site est prêt.

Faites cela immédiatement après l'envoi des fichiers. Un WordPress envoyé mais pas encore installé est dangereux : celui qui ouvre install.php en premier choisit l'administrateur. Des robots recherchent précisément cela. N'envoyez donc pas les fichiers aujourd'hui pour installer la semaine prochaine.

La même chose avec WP-CLI

WP-CLI est un programme en ligne de commande qui permet d'installer et de gérer WordPress sans navigateur. De nombreux hébergeurs le proposent via SSH ou un terminal dans le panneau. L'installation complète devient alors :

wp core download --locale=fr_FR
wp config create --dbname=utilisateur_wp1 --dbuser=utilisateur_wp1 --prompt=dbpass
wp core install --url=https://example.com --title="Mon site" \
  --admin_user=admin_k7 --admin_email=admin@example.com --prompt=admin_password

wp config create crée wp-config.php et récupère lui-même de nouvelles clés et sels. Avec --prompt, vous saisissez le mot de passe au lieu de l'indiquer dans la commande (sinon il resterait dans l'historique de votre terminal).

WP-CLI est aussi utile par la suite : wp core update, wp plugin list, wp core verify-checksums (leçon 7.5) et wp search-replace (leçon 3.2). Vous n'êtes pas obligé de l'utiliser, mais il est utile de savoir qu'il existe.

Ce qu'un installeur fait en plus

Maintenant que vous l'avez fait à la main, vous voyez ce qu'un installeur ajoute : il crée la base de données et l'utilisateur avec un mot de passe fort, récupère de nouveaux sels, installe directement (pas d'install.php ouvert) et conserve l'installation en mémoire pour les mises à jour, les sauvegardes et les clonages. Si vous installez à la main, vous devez organiser vous-même ces derniers points (module 7 et 8), ou importer ensuite l'installation dans votre installeur.

Résumé

• Téléchargez WordPress uniquement depuis wordpress.org et vérifiez éventuellement la somme de contrôle.
• Envoyez les fichiers via SFTP ou FTPS, ou sous forme de zip via le Gestionnaire de fichiers.
• Attribuez à chaque site sa propre base de données et son propre utilisateur de base de données.
• Renseignez wp-config.php avec les informations de la base de données et de nouvelles clés et sels provenant de api.wordpress.org.
• Exécutez le script d'installation immédiatement après l'envoi des fichiers ; un install.php ouvert est un risque.

Quiz

Exercice

Exercice D2.3 : Une deuxième installation à la main. Installez WordPress à la main sur un sous-domaine de test, par exemple manuel.example.com (avec votre propre domaine). Téléchargez depuis wordpress.org, créez votre propre base de données et utilisateur de base de données, renseignez vous-même wp-config.php avec de nouveaux sels et exécutez le script d'installation. Cochez chaque étape et répondez : quels droits votre utilisateur de base de données a-t-il reçus, et est-ce judicieux ou non, et pourquoi ? Quelle était la différence avec l'installeur de la leçon 2.2 ? Supprimez l'installation de test (fichiers et base de données) une fois terminé, ou importez-la dans votre installeur.

Pour aller plus loin

Ces articles décrivent les étapes dans les panneaux de WebOké ; dans d'autres panneaux, le fonctionnement est comparable.

• Guide DirectAdmin 11.7: Connexion avec FileZilla (FTP, FTPS et SFTP)
• Guide DirectAdmin 11.3: Extraire et créer des fichiers zip
• Guide DirectAdmin 12.1: Créer une base de données
• Guide DirectAdmin 12.2: Utilisateurs de base de données, droits et mots de passe
• Guide DirectAdmin 15.2: Clés SSH et connexion via SSH
• Guide DirectAdmin 15.3: Terminal dans votre navigateur
• Installer WordPress (wordpress.org, Anglais) : https://developer.wordpress.org/advanced-administration/before-install/howto-install/