wordpress/05-cli.html at master · pjehan-teaching/wordpress · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
<section id="cli">

    <section>
        <h2>CLI</h2>
        <h3>Command Line Interface</h3>
    </section>

    <section>
        <h3>Installation</h3>
        <p>L’interface en ligne de commande vous permettra de réaliser plusieurs tâches plus rapidement ou même de façon automatique.</p>
        <pre><code class="language-shell">curl -O https://raw.githubusercontent.com/wp-cli/builds/gh-pages/phar/wp-cli.phar
chmod +x wp-cli.phar
sudo mv wp-cli.phar /usr/local/bin/wp</code></pre>
        <p>Pour Windows, ouvrez le Git Bash en Administrateur puis :</p>
        <pre><code class="language-shell">curl -O https://raw.githubusercontent.com/wp-cli/builds/gh-pages/phar/wp-cli.phar
chmod +x wp-cli.phar
mv wp-cli.phar /usr/bin/wp</code></pre>
        <footer>
            <a href="https://developer.wordpress.org/cli/commands/" class="info" target="_blank">Liste des commandes</a>
        </footer>
    </section>

    <section>
        <h3>Téléchargement et installation de WordPress</h3>
        <pre><code class="language-shell">wp core download --locale=fr_FR
wp config create --dbhost=localhost:3306 --dbname=mydb --dbuser=root --dbpass=root
wp db create
wp core install --url=localhost --title="Mon blog" --admin_user=admin --admin_password=admin --admin_email=admin@gmail.com</code></pre>
    </section>

    <section>
        <h3>Plugins et thèmes</h3>
        <p>WP-CLI permet de gérer les plugins et les thèmes sans passer par l'interface d'administration :</p>
        <pre><code class="language-shell">wp plugin list
wp plugin install contact-form-7 --activate
wp plugin deactivate contact-form-7
wp plugin update --all</code></pre>
        <pre><code class="language-shell">wp theme list
wp theme install twentytwentyfour --activate
wp theme update --all</code></pre>
        <footer>
            <a href="https://developer.wordpress.org/cli/commands/plugin/" class="info" target="_blank">Documentation wp plugin</a>
            <a href="https://developer.wordpress.org/cli/commands/theme/" class="info" target="_blank">Documentation wp theme</a>
        </footer>
    </section>

    <section>
        <h3>Mises à jour</h3>
        <p>WP-CLI permet de mettre à jour l'ensemble d'un site WordPress en quelques commandes, ce qui facilite la <strong>maintenance de plusieurs sites</strong> ou l'<strong>automatisation</strong> via un script :</p>
        <pre><code class="language-shell">wp core update
wp core update-db
wp plugin update --all
wp theme update --all</code></pre>
        <footer>
            <a href="https://developer.wordpress.org/cli/commands/core/update/" class="info" target="_blank">Documentation wp core update</a>
        </footer>
    </section>

    <section>
        <h3>Gestion des utilisateurs</h3>
        <p>Les commandes de gestion des utilisateurs sont particulièrement utiles lors d'une <strong>reprise de projet</strong> (mot de passe oublié, accès administrateur perdu...) :</p>
        <pre><code class="language-shell">wp user list
wp user create jean jean@example.com --role=administrator
wp user update 1 --user_pass=nouveaumotdepasse</code></pre>
        <footer>
            <a href="https://developer.wordpress.org/cli/commands/user/" class="info" target="_blank">Documentation wp user</a>
        </footer>
    </section>

    <section>
        <h3>Regénérer les thumbnail</h3>
        <p>Si vous ajouter un nouveau format d'image dans un thème WordPress, il est nécessaire de regénérer les images déjà existantes.</p>
        <p>Des extensions permettent d'effectuer ce traitement mais l'utilisation de la ligne de commande peut être plus simple et plus rapide :</p>
        <pre><code class="language-shell">wp media regenerate</code></pre>
    </section>

    <section>
        <h3>Sauvegarder un site</h3>
        <p>Un backup complet d'un site WordPress comprend deux éléments : la <strong>base de données</strong> et les <strong>fichiers</strong>.</p>
        <p>Sur le serveur distant :</p>
        <pre><code class="language-shell">wp db export backup.sql
tar -czf backup-files.tar.gz wp-content/</code></pre>
        <p>Copier les fichiers en local puis restaurer :</p>
        <pre><code class="language-shell">wp db import backup.sql
tar -xzf backup-files.tar.gz</code></pre>
        <footer>
            <a href="https://developer.wordpress.org/cli/commands/db/export/" class="info" target="_blank">Documentation wp db export</a>
        </footer>
    </section>

    <section>
        <h3>Adapter le site en local</h3>
        <p>Après l'import, les URLs pointent encore vers le serveur distant. La commande <code>wp search-replace</code> remplace toutes les occurrences dans la base de données, y compris dans les données sérialisées :</p>
        <pre><code class="language-shell">wp search-replace 'https://mon-site.com' 'http://localhost:8000'</code></pre>
        <p>Cette commande met également à jour les options <code>siteurl</code> et <code>home</code>. On peut les vérifier ou les modifier manuellement :</p>
        <pre><code class="language-shell">wp option get siteurl
wp option get home
wp option update siteurl 'http://localhost:8000'
wp option update home 'http://localhost:8000'</code></pre>
        <p>Enfin, vider le cache :</p>
        <pre><code class="language-shell">wp cache flush</code></pre>
        <footer>
            <a href="https://developer.wordpress.org/cli/commands/search-replace/" class="info" target="_blank">Documentation wp search-replace</a>
        </footer>
    </section>

</section>