PukiWiki/Install/アップグレード時の注意

PukiWiki/Install

アップグレード時の注意点†

不足している部分の追記・補足、間違いの修正をお願いします。

アップグレード時の注意点

↑

ミスを防ぐためにできること†

構成ファイル全体をバックアップ
安易に上書きしない
保存領域に余裕があるのならば、まずは別のディレクトリに新しいバージョンを構築する
導入しようとするバージョンと今利用しているバージョンの違いを、パッケージ付属のUPDATING.txt や、ダウンロードの各ページに記載の過去との変更点、PukiWiki/Install などで、あらかじめ確認しておく

↑

設定などが書き込まれたファイルでも、同名であれば上書きされてしまう†

どのファイルが更新されるのか良く確認をしてください。
アップグレードする前に、サーバー上の重要なファイル（可能なら全てのファイル）を別の場所に保存（バックアップ）しておきましょう。

↑

各種設定ファイル（ルートディレクトリの .ini.php ファイルと .lng.php ファイルと index.php などの入り口）†

新しいバージョンでは、設定項目が増減している場合がほとんどです。

古いバージョンの設定ファイルをそのまま使うと、新しい機能を使えなかったり、特定の場面で不具合が出る場合があります。（エラーが表示されたり、必要なメッセージが表示されない、など）
かといって、設定ファイルを新しいものでそのまま上書きすると、管理者のパスワード・サイトアドレス等、各種設定がすべて初期状態に戻されてしまいます。
そのため、古いバージョンの設定ファイルを手元に用意し、その内容を新しいバージョンのファイルに書き写したのち、新しいものをアップロードして下さい。

例えば、古いファイルで

// 編集者の名前(修正してください)
$modifier = '管理者';

// 編集者のホームページ(修正してください)
$modifierlink = './';

と設定を変更している場合、新しいファイルから$modifier と$modifierlink を探し出し、

// Site admin's name (CHANGE THIS)
$modifier = 'anonymous';

// Site admin's Web page (CHANGE THIS)
$modifierlink = 'http://pukiwiki.example.com/';

該当部分を旧環境の設定に書き変えてください。

// Site admin's name (CHANGE THIS)
$modifier = '管理者';

// Site admin's Web page (CHANGE THIS)
$modifierlink = './';

引き継ぎたい旧環境の設定を、同様に書き換えてください。

※1.4.6 以降では、管理者のパスワードとユーザ認証のパスワードの書式が変更になっています。詳しくは、dev:BugTrack/709 をご覧ください。
※かなり古いバージョンからアップグレードする場合、設定箇所やその名前が変更になっている場合があります。PukiWiki/Download に記載の各バージョンで以前のバージョンからの変更点を確認したり、パッケージ付属のREADME.txt やUPDATING.txt を確認して下さい。

↑

./lib 以下に含まれるファイル（システムファイル）†

1.4.3 まではルートディレクトリに含まれていた、PukiWiki のシステム系のファイルです。
特別な理由がない限り、以降のアップグレードをしやすくするために、ルートディレクトリから移動させてください。（そのおまけ効果として、入り口の名前をbackup.php などにする事が可能になります）

基本的には、上書きして下さい。
改造して使っているものに関しては、その内容を新しいものに反映させてから上書きする必要があります。（新環境でもその改造を使いたい場合）

↑

./plugin 以下に含まれるファイル（プラグインファイル）†

基本的には、上書きして下さい。
プラグインマニュアルの凡例のプラグイン内設定を変更していたり、改修して使っているものに関しては、その内容を新しいものに反映させてから上書きする必要があります。（新環境でもその設定や改造を使いたい場合）

自作プラグインを使っている場合、新しく入れるPukiWiki のバージョンに対応しているのか、修正版が出ていないかなども確認してください。

↑

./skin 以下に含まれるファイル（スキンファイル）†

基本的には、過去のものをそのまま使えるようになっています。
ただし、一部の関数名や設定を記録している変数の名前が変更された事により、改造スキンなどで問題になる場合があります。

自作スキンを使っている場合、新しく入れるPukiWiki のバージョンに対応しているのか、修正版が出ていないかなども確認してください。

↑

./wiki 以下に含まれるファイル（ページデータ）†

ここには各ページのデータが入っています。
同じ名前のファイルがすでにある場合、特にFrontPage, MenuBar, InterWikiName などをカスタマイズしていると、そのページの内容が上書きされる可能性があるので注意が必要です。

プラグインマニュアルに関しては、新しいバージョンのものに置き換えるか、説明を新しいものに書き換える事をお勧めします。（ヘルプの説明内容を新しいバージョンに対応させるため）
この機会にInterWikiName などの各リンクを再確認することをお勧めします。
過去の記録としてそのまま残す場合以外は、なるべく最新のリンク先に修正するようにして下さい。（例えば、PukiWiki 公式サイトのリンク先が旧サイトのままになっていませんか？）
- 古いリンク先が、ドメインを売るためのサイトになっていたり、spam の温床になっていたりすると、自サイトのSEO に影響する場合があります。

↑

./backup 以下に含まれるファイル（バックアップファイル）†

基本的に以前のものを引き継いでください。（上書きしないでください）
ただし、zlib関数を使用できる環境とできない環境をまたぐ場合、保存形式の違いから過去のデータを利用できない場合があります。

↑

./image 以下に含まれるファイル（イメージファイル）†

基本的に以前のものを引き継いでください。（上書きしないでください）

※1.4.3以前からアップグレードする場合、他ディレクトリにあるイメージファイルを移動させる作業が必要になる場合があります。（そのファイルに関連するマニュアルを、確認して下さい）
※旧PukiWiki 公式サイトのバナーイメージ（b_pukiwiki.org.png）を使っている場合は、新しいもの（b_pukiwiki.official.png）に置き換えるようにしてください。

↑

その他のデータファイル（./attach と./cache と./diff 以下のファイルなど）†

基本的に以前のものを引き継いでください。（上書きしないでください）

自作プラグインがキャッシュなどとして利用しているファイル群は、そのプラグインを引き続き利用する場合に必要となります。
プラグインも同時にアップグレードする場合、新しいバージョンが指定する場所にデータを移動させるなくてはいけない場合があります。（関連する各マニュアルを、確認して下さい）

↑

各ディレクトリの.htaccess ファイル†

基本的に以前のものを引き継いでください。（上書きしないでください）
ただし、以前と違うサーバに設置した場合や、ファイル・ディレクトリ構成を変更した場合などは、その環境に合わせた修正を行ってください。
意図したとおりに動作していることを、必ず確認してください。（アクセス禁止にしたファイルを閲覧できてしまわないかなど）

↑

ファイルの属性（パーミッション）†

インストール後に変更していても、ファイル・ディレクトリを上書きするときに、PukiWiki のデフォルトやFTPクライアントの設定で上書きされる可能性があります。
.htaccess と同様に、新環境での動作確認を忘れないでください。

初期状態ではファイルがないので、PukiWiki/Install/インストール方法やPukiWiki/Install/パーミッション設定の説明には記述がありませんが、./backup, ./diff ディレクトリにある.htaccess とindex.html を除く各ファイルは、書き換え可能な状態に設定してください。

以下は、設定例です。
- (777)./attach
  - (644/ASCII).htaccess
  - (644/ASCII)index.html
  - (666/ASCII)……_…….log
  - (644/Bin)……_…… 添付ファイル（拡張子なしに変換されています）
- (777)./backup
  - (644/ASCII).htaccess
  - (644/ASCII)index.html
  - (666/Bin)…….gz
  - (666/ASCII)…….txt
- (777)./counter
  - (644/ASCII).htaccess
  - (644/ASCII)index.html
  - (666/ASCII)…….count
- (777)./diff
  - (644/ASCII).htaccess
  - (644/ASCII)index.html
  - (666/ASCII)…….txt