• 赤色のリンクは、まだ日本語Codexに存在しないページ・画像です。英語版と併せてご覧ください。(詳細

このWikiはいつでも誰でも編集できます

WordPress のアップグレード/詳細

提供: WordPress Codex 日本語版
< WordPress のアップグレード
2009年1月21日 (水) 04:48時点におけるBono (トーク | 投稿記録)による版 (2.7: 手順 13(セキュリティキー)追加、最新版反映、リンク修正/手順7まで: 説明文見直し(英語版と書き振り変更)、WP日本語版の記述追加、見出しレベル上げ)

移動先: 案内検索

2.7 以降のアップグレード方法: ドキュメントの更新内容についてご意見をお聞かせください。ノート:WordPress のアップグレードをご覧ください。

アップグレードの前に: 以下の作業に入る前に、新バージョンの動作環境などをご確認ください。

アップグレード作業の流れ

(注) バージョン 2.6 から、手順13 が加わりました。

  1. データベースをバックアップ
  2. サーバ上にある全ての WordPress ファイルをバックアップ.htaccess ファイルをお忘れなく。
  3. 取得したバックアップファイルを検証。ファイルが存在するか、使える状態であるか。
  4. 全てのプラグインを無効化
  5. 以上 4 ステップを確実に完了させる。完了するまでアップグレードしないでください。
  6. http://wordpress.org/download/ (日本語版は http://ja.wordpress.org/ )から新バージョンの WordPress パッケージをダウンロード、展開
  7. サーバ上の古い WordPress ファイルを削除。ただし、次のものは削除せずに残すこと。
    • wp-config.php ファイル
    • wp-content ディレクトリ
      • この中の wp-content/cache ディレクトリと wp-content/plugins/widgets ディレクトリは削除。
    • wp-images ディレクトリ(あれば)
    • wp-includes/languages/ ディレクトリ (言語ファイルをあえてここに置いている場合)
    • .htaccess ファイル (パーマリンク設定をしている場合)
    • robots.txt ファイル (ブログがルートにあって、このファイルを作成している場合)
  8. 上記 6 で展開した新バージョンのファイルをサーバへアップロード
  9. ブラウザで管理パネルにアクセスし、画面の指示に従ってデータベースアップグレードプログラムを実行
  10. パーマリンク設定画面でパーマリンク構造を更新。必要であれば手動で .htaccess ファイルのカスタムルールを差し替える。
  11. プラグインとテーマを新バージョン対応版に更新
  12. プラグインを有効化
  13. wp-config.php ファイルにセキュリティ・キーの定義を追加する
  14. WordPress の変更点を見直す

以上がアップグレード作業の概要です。続けてアップグレード手順の詳細をお読みください。

もしもトラブルが生じたら、下記の説明をもう一度読み直して、手順どおり正しく行ったかどうか確認してください。また、トラブルシューティング: よくあるインストールトラブルも参照してください。

バージョン 1.5.x、2.x(2.0~2.6.5)から 5.3 への詳細なアップグレード手順

以下は、上記手順のさらに詳しい説明書です。作業を始める前に、一通り目を通しておいてください。

手順 1: データベースをバックアップ

データベースのバックアップを取得してください。WordPress の設定やユーザー、投稿・固定ページ・コメント・リンク・カテゴリーなどのデータは全て MySQLデータベースに保存されています。この手順についての詳細は「データベースのバックアップ」をお読みください。

アップグレードを始める前にデータベースをバックアップすることはとても大切です。もし何らかの理由で WordPress の「旧」バージョンに戻さなくてはならなくなったときに、このバックアップからデータベースの復元が必要になるかもしれないからです。[1]

手順 2: 全ての WordPress ファイルをバックアップ

WordPressディレクトリにある「全ての」ファイルと .htaccessファイルのバックアップを取得してください。今までにアップロードした画像や、管理パネルから更新したプラグイン、編集したテーマファイルなどもここにあります。サーバからローカルコンピュータ(あなたの PC)に全ての WordPressファイルをダウンロードするには、通常 FTP クライアントを使います。詳しい説明は「WordPress サイトのバックアップ」をお読みください。

WordPress のコアファイルに何らかの変更を加えている場合や、カスタマイズしたプラグインやテーマを使用している場合は、これらのファイルを正しくバックアップしてください。アップグレードを始める前にこれらのファイルをバックアップすることはとても大切です。この後の作業でサーバ上のファイルを誤って消してしまったり、何らかの理由で WordPress の「旧」バージョンに戻さなくてはならなくなったときに、バックアップしたファイルの再アップロードが必要になるかもしれないからです。

手順 3: バックアップの検証

バックアップが正しく作成され、使用可能であるかどうか検証してください。アップグレード作業の中で一番大切な手順です!

  • バックアップファイルがローカルコンピュータ(もしくは保存した他の場所)で見られるかどうか。
  • バックアップファイルのサブフォルダも開けるかどうか。
  • ファイルが zipファイルの中にある場合は、解凍できるかどうか。
  • テキストエディタ.sql ファイルを開き、DB のテーブルとデータの中身を見られるか。

手順 4: 全てのプラグインを無効化

管理パネルプラグイン画面を開き、全てのプラグインを無効化してください。WordPress 本体が変わるので、プラグインによってはアップグレード処理と衝突する可能性があるからです。

手順 5: 上記 4 ステップを確実に完了させる

もし最初の4ステップがまだ終わっていなければ、ここでストップして、まず4ステップに従ってください。最初の4ステップが終わるまでアップグレードはしないで下さい。

アップグレード時の問題解決で頼りになるのは WordPressサポートフォーラムです。トラブルが起きてフォーラムで質問すると、フォーラムのボランティアの人達は、最初の4ステップを終わらせたかどうか尋ねてきますよ。

手順 6: WordPress パッケージをダウンロード・展開

http://wordpress.org/download/ (日本語版は http://ja.wordpress.org/ )から新バージョンの WordPressパッケージをダウンロードし、解凍します。

  • この後 FTP でリモートウェブサーバへ WordPress をアップロードするのであれば、ウェブブラウザで自分のコンピュータに WordPressパッケージをダウンロードし、解凍してください。
  • webサーバへ Shell でアクセスできて、コンソールベースのツールを使うことに抵抗がない場合は、WordPress を直接あなたの web サーバへダウンロードすることも可能です。wget、または lynx 等のコンソールベースの webブラウザが使用可能で、FTP を行ないたくない場合に利用できます。 パッケージを現在の WordPressディレクトリと同階層のディレクトリ(例えば "uploads" など)に置き、次に、gunzip -c wordpress-5.3.tar.gz | tar -xf - または tar -xzvf latest.tar.gz で解凍します。

WordPressパッケージは wordpress というフォルダの中に展開されます。

手順 7: 古い WordPress ファイルを削除

下記のファイルとディレクトリを除き、サーバ上にある旧バージョンの WordPress ファイルを削除します。(バックアップは取ってありますね?)

どうして削除するの? アップロード(または cPanel を使ったアップグレード)処理中に既存のファイルが正しく上書きされなかったり、不要な旧ファイルが残ったり、それが後で問題を生じさせたりすることがあるので、一般的に、可能なものは全て削除しておくほうが良いのです。

削除してはいけないファイルとディレクトリ:

  • wp-config.php ファイル
  • wp-content ディレクトリ
  • wp-images ディレクトリ -- バージョン 1.5.x 以前で使用
  • wp-includes/languages/ ディレクトリ -- 言語ファイルをあえてここに置いている場合は削除しないこと。(次回のアップグレードを楽にするには、wp-content/languages/ に移動するとよいでしょう [2]
  • .htaccessファイル -- パーマリンクのカスタムルールを追加してある場合は削除しないこと
  • コンテンツおよびカスタマイズしたプラグイン・テーマ -- 画像、および、その他のカスタマイズしたコンテンツやプラグイン等が wp-content ディレクトリ内にある場合は、絶対に削除しないこと。

削除するファイルとディレクトリ:

  • (上記以外の)wp-*, readme.html, wp.php, xmlrpc.php, license.txt などのファイル -- 通常はルートまたは wordpressディレクトリにあります。wp-config.php は削除しないこと!
  • wp-admin ディレクトリ
  • wp-includes ディレクトリ -- この中の wp-includes/languages/ ディレクトリに言語ファイルを置いている場合、wp-includes/languages/ ディレクトリは削除しないよう気をつけてください。
  • wp-content/cache ディレクトリ -- WordPress 2.0.x からアップグレードする場合にのみ存在します。
  • wp-content/plugins/widgets ディレクトリ -- 過去にSidebar Widgets(サイドバーウィジェット)プラグインをインストールしたことがある場合にのみ存在します。このプラグインのコードは WordPress 本体に組み込まれたウィジェット機能/en と競合して問題が起きます。
  • コアファイルのカスタマイズは、新バージョンでも必要かどうかを確認の上、必要であれば新バージョンのファイルを元に作り直してください。

どうやって削除するの? サーバからファイルを削除する方法はいくつかあります。FTP クライアントを使うこともできますし、もし使えるなら Telenet や SSH でもアクセスできます。ファイルやフォルダを削除するツールを用意しているホスティングプロバイダ(レンタルサーバ)もあります。

FTPを使って削除する場合
アップロード/en に使う FTP クライアントをファイルとフォルダの削除に使用できます。もし FTP クライアントで空でないフォルダを削除できなければ、FTP クライアントのオプション設定をチェックしてください。空でないファイルを削除する権限を与えるオプションがあるはずです。空でないファイルの削除によって、WordPressの古いインストールを手早く完全に一掃できます。ファイルの削除が完了したら、安全上の理由から FTP の設定をもとに戻すことをお勧めします(うっかりディレクトリごと削除してしまうことを防ぐため)。
Telenet や SSH を使って削除する場合
コマンドラインでログイン(telnet または SSH)できる場合は、以下のコマンドを使って、必要なファイルのバックアップコピーを作成したり、ディレクトリの中の WordPressファイル(と .htaccessファイル)「だけを」削除する事が出来ます。下記の cp コマンド以外にもカスタマイズしたファイルがある場合(例: index.php)は、そのファイルもコピーしてください。
  • mkdir backup
  • cp wp-config.php .htaccess backup
  • cp -R wp-content backup
  • rm wp*.php .htaccess license.txt readme.html xmlrpc.php
  • rm -rf wp-admin wp-includes
  • cp backup/wp-config.php .
  • アップグレードが終了した後、カスタマイズされたテンプレートやプラグインをバックアップディレクトリから復元(リストア)することができます。例えば、index.php をリストアするには cp backup/index.php . を使います。
SSH を使った別のやり方としては、
  1. まず、新たに別名で wordpressディレクトリを作り、wp-config.php および .htaccess、追加/変更したコンテンツファイルをその中にコピーします。
  2. 次に、旧ディレクトリの名前を変更(リネーム)して(退避させ)、新しいディレクトリをその場所に移動させます(=本番の wordpressディレクトリ名にリネーム)。

訳注: 最後の方法は、FTP のときにも応用すると、ファイルの削除する/しないに気を使わなくて済むので楽かと思います。

手順 8: 新ファイルをアップロード

ローカルコンピューターにあるアップグレード用の新ファイルとFTPを使って、初めてWordPressをインストールした時の要領で、新ファイルをサイトのサーバーにアップロードしてください。FTPプログラムを使ってアップロードする時の詳しいガイドラインはUsing FileZillaUploading WordPress to a remote hostをご覧下さい。

注意: wp-content フォルダーを削除しなかった場合は、アップロード中にいくつかのファイルを上書きする必要があります。

wp-contentフォルダーにはWordPressのテーマとプラグインが含まれています。これらはそのままにしてください。それ以外のものを先に全てアップロードして、その後、新しいものや変更のあったWordPressのファイルだけを新しいwp-contentフォルダーにアップロードしてください。 デフォルトのプラグインの旧バージョンは新しいもので上書きしてください。

WordPressのデフォルトのテーマにも変更がありますので、wp-content/themes/defaultフォルダーにアップロードしてください。デフォルトのテーマをカスタマイズしている場合は、アップグレードした後で変更点を見直してインストールする必要があります。

手順 9: WordPress データベース・アップグレードプログラムを実行

Webブラウザで管理パネル(wp-admin/)に行きます。WordPress がデータベースのアップグレードの要否をチェックして、必要であれば、次のリンクが表示されます。

This link will lead you to run the WordPress upgrade script by accessing wp-admin/upgrade.php. Follow the instructions presented on your screen.

Note: Make sure the database user name registered to WordPress has permission to create, modify, and delete database tables before you do this step. If you installed WordPress in the standard way, and nothing has changed since then, you are fine.

手動でアップグレードスクリプトを実行したい場合:

  • WordPressがルートディレクトリにインストールされている場合: http://example.com/wp-admin/upgrade.php
  • WordPressがblogという名前のサブディレクトリにインストールされている場合(例): http://example.com/blog/wp-admin/upgrade.php

もしもアップグレード後にログインできなくなったら、ブラウザの Cookie を削除してみてください。

管理パネル > 設定 > パーマリンク設定画面にて、パーマリンク構造を更新してください。必要であれば .htaccessファイルにカスタムルールを追加してください。パーマリンクと.htaccessファイルに関する詳細はパーマリンクの使い方をご覧下さい。

手順 11: 最新版のプラグインとテーマをインストール

WordPress の新バージョンに対応しているプラグインとテーマを確認するため、プラグイン互換性リストおよびテーマ互換性リスト、または、プラグイン・テーマの配布元サイトを参照してください。必要に応じて、使用しているプラグインやテーマの新バージョンをアップロード、インストールしましょう。

手順 12: プラグインを再び有効化

管理パネルから、使用するプラグインを有効化してください。

手順 13: wp-config.php ファイルにセキュリティ・キーの定義を追加する

最新版の WordPress では、ユーザの Cookie に格納される情報をより強固な暗号化で守るため、AUTH_KEY および SECURE_AUTH_KEY、LOGGED_IN_KEY、NONCE_KEY という 4つのセキュリティ・キーを使います。

あなたのサーバから wp-config.php ファイルをダウンロードしてテキストエディタで開き、これらの定義が入っているか確認しましょう。行が見つからないか、値が初期値のままだったら、wp-config.php の編集の説明に従って行を追加/修正し、更新した wp-config.php ファイルを再びサーバへアップロードしてください。

手順 14: WordPress の変更点を見直す

WordPressの最新情報は以下の資料を参照してください。

Fantastico によるアップグレードの特記事項

バージョン2.2以前のバージョンからのアップグレードをFantasticoで行う場合、Fantasticoは新しいwp-config.phpを作成する時に、wp-config-sample.phpを使用します。これによって、DB_CHARSETと DB_COLLATEという新しい2つの値がwp-config.phpに書き込まれます。2.0.10や2.1.3などの2.2以前のバージョンから 5.3にアップグレードする際には、この行はwp-config.phpから削除する必要があります。DB_CHARSETと DB_COLLATEについての詳しい説明はwp-config.php の編集をご覧下さい。


トラブルシューティング

レイアウトの崩れやエラー 
ブログのレイアウトが崩れていたり、エラーメッセージが表示されている場合は、新コード上では動かない古いプラグインが犯人の可能性があります。WordPressの管理パネルで、デフォルトのプラグイン以外のプラグインを全て無効化してください。その後、プラグインをひとつずつ有効化してください。
カスタマイズやハックをしましたか? 
その他のWordPressファイルを変更している場合は(WordPressを"ハックした" 場合)、自分が行った変更をきちんと把握しておくというのが前提です。編集したコードを新コードに書き写す必要があります。WordPress バージョンにリリースごとの変更ファイルの一覧があります。
旧コードを使い続けたい 
アップグレードは最新でベストなコードを提供します。どれだけたくさんカスタマイズをしていても、旧コードを使うとほとんど必ずと言っていいほど問題が生じます。変更を加えた旧コード使うという試みは悪くはないですが、エラーが生じる可能性は大きくなります。
旧バージョンに戻せますか? 
戻すことはできますが、最新バージョンから旧バージョンにロールバックする(バージョンを戻す)ことは通常お勧めできません。新バージョンはセキュリティアップデートが含まれることが多く、旧バージョンに戻すとサイトにセキュリティ上の問題を残す可能性があります。また、バージョン間のデータベース構造の変更のためにサイトのコンテンツ、記事、コメントなどを維持するのが難しくなったり、データベースに保存されている情報を利用しているプラグインに問題が生じたりします。それでも旧バージョンに戻したい場合は、自己責任で行ってください。アップグレードを試みる前にサイト全てのバックアップとデータベースのバックアップをしなければ、ロールバックはほぼ不可能だと思ってください。 wp-config.php以外の全てのWordPressファイルを削除し、バックアップしたファイルをサーバーにアップロード/enした後、バックアップファイルからデータベースを復元をしてください。ロールバックには正常に動作するバックアップが必ず必要です。WordPressのバージョンによってはロールバックできないこともあります。
もっと詳しく 
アップグレード後エラーが発生する場合は、トラブルシューティング: よくあるインストールトラブルや、トラブルシューティング/enCodex の「設置」カテゴリのページ/enをご覧下さい。探している答えが見つからない場合は、WordPress Suppport Forumsで質問の内容を詳しく投稿してください。その際、古いコードを使っていないか、使っているならそれを変更するように必ず勧められますので、質問する前に変更しておきましょう。

1.2.x 以前のバージョンからのアップグレード

WordPress 1.2 から WordPress 5.3 へのアップグレードを検討中の方は、まず、WordPress バージョン 1.2 から 1.5 へのアップグレードに書かれている1.2から1.5へのアップグレードを行ってください。1.5.xにアップグレードした後、上記のリンクの1.5から5.3へのアップグレードの説明に従ってください。

他言語版 WordPress

他言語版の最新バージョンについては 英語版Codex を参照。

最新英語版: WordPress Codex » Upgrading WordPress Extended最新版との差分

脚注

  1. バージョン一覧db_version が変更となっているバージョンでは、データベースの構造やデータの持ち方が変わるため、手順 9 で変換処理が行なわれます。旧バージョン用のデータベースに戻すにはバックアップファイルからの復元が必要です。
  2. バージョン 2.1 から、言語ファイルの標準の置き場所は wp-content/languages/ になりました。