WP-CLI | テーブルプレフィックスの変更を拡張パッケージ(WP-CLI Rename Database Prefix)を使って行う方法

運用中など既存WordPressサイトのデータベースのテーブルプレフィックスをWP-CLIの拡張パッケージ「WP-CLI Rename Database Prefix」を使って行う方法を書いていきます。

パッケージインストール

WP-CLI Rename Database Prefix をインストールしていない場合は以下のコマンドでインストールします。

wp package install iandunn/wp-cli-rename-db-prefix

$ wp package install iandunn/wp-cli-rename-db-prefix
Installing package iandunn/wp-cli-rename-db-prefix (dev-master)
Updating /home/xxx/.wp-cli/packages/composer.json to require the package...
Using Composer to install the package...
---
Loading composer repositories with package information
Updating dependencies
Generating rules
Resolving dependencies through SAT
Looking at all rules.

Dependency resolution completed in 0.000 seconds
Analyzed 98 packages to resolve dependencies
Analyzed 98 rules to resolve dependencies
Lock file operations: 1 install, 0 updates, 0 removals
Installs: iandunn/wp-cli-rename-db-prefix:dev-master 4ca7d10
- Locking iandunn/wp-cli-rename-db-prefix (dev-master 4ca7d10)
Writing lock file
Installing dependencies from lock file
Package operations: 1 install, 0 updates, 0 removals
Installs: iandunn/wp-cli-rename-db-prefix:dev-master 4ca7d10
 - Installing <info>iandunn/wp-cli-rename-db-prefix</info> (<comment>dev-master 4ca7d10</comment>)
Generating autoload files
---
Success: Package installed.

上記のように「Success: Package installed.」まで表示されれば完了です。

インストールしたパッケージは .wp-cli 内のディレクトリに入っています。

$ pwd
/home/xxx/.wp-cli/packages/vendor/iandunn

$ ll
合計 0
drwxr-xr-x 3 xxx members 111  9月 24 09:47 wp-cli-rename-db-prefix

テーブルプレフィックス変更

以下のコマンドで変更後のテーブルプレフィックスを指定して実行します。

wp rename-db-prefix test_ --path=/home/xxx/example.com/public_html/wp

$ wp rename-db-prefix test_ --path=/home/xxx/example.com/public_html/wp

Warning: Use this at your own risk. If something goes wrong, it could break your site. Before running this, make sure to back up your `wp-config.php` file and run `wp db export`.

Are you sure you want to rename example.com's database prefix from `wp_` to `test_`? [y/n] y

Success: Successfully renamed database prefix.

コマンドを実行すると途中でテーブルプレフィックスを変更していいか聞かれますので「y」を入力して進むと完了します。

完了後、wp-config.php 内のテーブルプレフィックスや実際にテーブルのプレフィックスを確認すると変更後のものに変わっていることが確認できます。

$table_prefix = 'test_';

動作環境情報

"エックスサーバー" x10
"PHP" 7.4.13
"MySQL" 5.7
"WordPress" 5.8.1
"WP-CLI" 2.5.0