インストール

インストール

　PukiWikiはPHPで書かれています。日本語マルチバイト対応のPHPがインストールされている環境なら基本的にどのOS上でも動作します。できれば PHP4.3.8 以上をお使いいただけるほうが無用なトラブルを避けることができますので推奨いたします。

• 設置方法

• 設定手順

• 特殊ページ

• 書き込みが反映されない

• SELinux

• RHEL 4.0ベース

• Fedra Core 5

設置方法

以下は一例です。Webサーバーへのシェルアクセスが可能であれば、 アーカイブをそのままサーバーに転送し、サーバー上で解凍 (tar pzxf pukiwiki*.tar.gz) するだけでも動作するはずです。

1. アーカイブを解きます。

2. 必要に応じて設定ファイル(*.ini.php)の内容を確認します。 *1 *2 *3 *4

• 共通設定
  • 全体: pukiwiki.ini.php
  • ユーザ定義: rules.ini.php
• エージェント別設定
  • 携帯電話およびPDA : keitai.ini.php
  • PCなどその他: default.ini.php

i18n 版では ini ファイルが細分化されています。例えば管理者パスワード、編集制限の設定は auth.ini.php で行います。

3. アーカイブの内容をサーバに転送します。

ファイルの転送モードについては次項を参照してください。

4. サーバ上のファイルおよびディレクトリのパーミッションを確認します。

ディレクトリ   パーミッション
attach         777             添付ファイル格納ディレクトリ
backup         777             バックアップファイル格納ディレクトリ
cache          777             キャッシュファイル格納ディレクトリ
counter        777             カウンタファイル格納ディレクトリ
diff           777             差分ファイル格納ディレクトリ
image          755             画像ファイル
image/face     755             (画像ファイル)フェイスマーク  
lib            755             ライブラリ
plugin         755             プラグイン
skin           755             スキン、CSS、JavaScirptファイル
trackback      777             TrackBackファイル格納ディレクトリ
wiki           777             データの格納ディレクトリ
ファイル       パーミッション 転送モード
*.php          644             ASCII
*.lng          644             ASCII
cache/*        666             ASCII
image/*        644             BINARY
image/face/*   644             BINARY
lib/*          644             ASCII
plugin/*       644             ASCII
skin/*         644             ASCII
wiki/*         666             ASCII

4.1. 777 (rwxrwxrwx) のディレクトリが書き込み権限を必要とするディレクトリ群です。 それらのディレクトリ中にすでに存在するファイルにも書き込み権限が必要なので 666 (rw-rw-rw-) と設定します。それら以外は読み込みができれば充分なのでディレクトリは 755 (rwxr-xr-x)、ファイルは 644 (rw-r--r--) とします。 今後、ディレクトリなどが追加された場合で、これらドキュメントの更新が追随できていない場合は、同様の考え方で設定をしてください。

4.2. i18N版の最新構成は、以下の通りとなっています。

.
|-- attach
|-- backup
|-- cache
|-- counter
|-- diff
|-- doc
|   |-- en_US
|   |-- ja_JP
|   `-- zh_TW
|-- image
|   |-- face
|   |-- face.org
|   |-- icon
|   |   |-- browser
|   |   |-- cpu
|   |   |-- flags
|   |   |-- mime
|   |   `-- os
|   |-- player
|   `-- plus
|-- init
|-- lib
|   `-- ua
|-- locale
|   |-- bkup
|   |-- en_US
|   |   `-- LC_MESSAGES
|   |-- ja_JP
|   |   `-- LC_MESSAGES
|   |-- ko_KR
|   |   `-- LC_MESSAGES
|   |-- pot
|   |-- zh_CN
|   |   `-- LC_MESSAGES
|   `-- zh_TW
|       `-- LC_MESSAGES
|-- log
|   |-- browse
|   |-- download
|   `-- update
|-- plugin
|   |-- code
|   `-- qrcode
|-- skin
|   |-- ajax
|   |-- css
|   |-- greybox
|   `-- lang
|-- tools
|-- trackback
`-- wiki

5. index.php あるいは pukiwiki.php にブラウザからアクセスします。

必要に応じて、さらに設定やデザインを調整して下さい。

設定手順

インストールの段階で最低限、管理者パスワードは設定しておきましょう。 ページを凍結したり、リネームしたりする際に必要になります。

1.4.6以前

// 凍結解除用の管理者パスワード(MD5)
// pukiwiki.php?md5=pass のようにURLに入力し
// MD5にしてからどうぞ。面倒なら以下のように。
// $adminpass = md5("pass");
// 以下は pass のMD5パスワードになってます。
$adminpass = "21232f297a57a5a743894a0e4a801fc3";

上記の"21232f297a57a5a743894a0e4a801fc3"の部分を書き換えます。MD5による暗号化したパスワードを書き込む必要がありますが、とりあえずは $adminpass = md5("pass"); の形式でpassの部分を書き換えて記述しておきましょう。正式にPukiWikiを使い続けることを決めてから、MD5によって暗号化した文字列に書き換えればいいです。

1.4.6

書式が変更になっています。ご注意下さい。

$adminpass = "{x-php-md5}21232f297a57a5a743894a0e4a801fc3";

i18n版

auth.ini.php ファイルに移動しています。ご注意下さい。

 $adminpass = "{x-php-md5}21232f297a57a5a743894a0e4a801fc3";

また、auth_users.ini.php、auth_users.ini.php というファイルも新設されていますので、詳細に関しては、Digest認証の使い方および、外部認証APIもあわせてご覧下さい。

特殊ページ

以下のページはそれらをサポートしているスキンで有効になります。 例えば、PukiWiki Plus! のデフォルトスキン(skin/default.skin.php)などです。

• MenuBar
  • このページを作成することで、左サイドにメニュー項目を出せます。
• SideBar
  • このページを作成することで、右サイドにメニュー項目を出せます。
• Navigation
  • このページを作成することで、デフォルトのナビゲーションメニュー（新規、編集などのメニュー）の代わりに javascript を用いたナビゲーションメニューを作成できます。詳細は Plugin/navibar2.inc.php
• :Footer
  • このページを作成することで、フッタ領域に任意の内容を表示できます。関連：footarea.inc.php
• :Header
  • このページを作成することで、ヘッダ領域に任意の内容を表示できます。関連：headarea.inc.php

書き込みが反映されない

書き込みが反映されない場合、とりあえず pukiwiki.ini.php にて

-defined('PLUS_ALLOW_SESSION') or define('PLUS_ALLOW_SESSION', 1);
+defined('PLUS_ALLOW_SESSION') or define('PLUS_ALLOW_SESSION', 0);

と変更してみてください。参照 BugTrack/95

SELinux

• サイトが英語表示になってしまう
  SELinuxの機能が有効になっている場合で、ポリシーが適切に設定されていないと、英語混じりの表示になることがあります。

RHEL 4.0ベース

SELinux を有効にしているサイトでは、 SourceForge.jp にある、newrules というパッケージを使うと、暫定的なポリシーの作成が簡単に行えます。

ポリシーの作成

# cd /etc/selinux/targeted/src/policy/domains; newrules.pl -i /var/log/messages > tmp.te

ポリシーの反映

# cd /etc/selinux/targeted/src/policy; make reload

ポリシー設定の例(/etc/selinux/targeted/src/policy/domains/tmp.te)

以下の内容は、安全性を保障するものでもありませんし、推奨するものでもありません。あくまでも、稼動サイトしているサイトでの設定例を示したものです。無関係なポリシーも含んでいます。

allow httpd_sys_content_t cifs_t:filesystem { associate };
allow httpd_sys_script_t devpts_t:chr_file { getattr ioctl read write };
allow httpd_sys_script_t devpts_t:dir { search };
allow httpd_sys_script_t fixed_disk_device_t:blk_file { ioctl read };
allow httpd_sys_script_t httpd_config_t:dir { getattr search };
allow httpd_sys_script_t httpd_sys_script_exec_t:dir { add_name create read remove_name rmdir write };
allow httpd_sys_script_t httpd_sys_script_exec_t:file { append create rename setattr unlink write };
allow httpd_sys_script_t httpd_sys_script_t:capability { chown dac_override dac_read_search fowner fsetid net_admin sys_rawio };
allow httpd_sys_script_t httpd_sys_script_t:file { getattr read };
allow httpd_sys_script_t httpd_sys_script_t:netlink_route_socket { bind create getattr nlmsg_read read write };
allow httpd_sys_script_t httpd_tmp_t:file { getattr read write };
allow httpd_sys_script_t krb5_conf_t:file { getattr read write };
allow httpd_sys_script_t ld_so_cache_t:file { execute };
allow httpd_sys_script_t removable_device_t:blk_file { ioctl read };
allow httpd_sys_script_t security_t:dir { search };
allow httpd_sys_script_t selinux_config_t:dir { search };
allow httpd_sys_script_t selinux_config_t:file { getattr read };
allow httpd_sys_script_t user_home_dir_t:dir { add_name create write };
allow httpd_sys_script_t user_home_dir_t:file { create getattr read write };
allow httpd_sys_script_t user_home_t:dir { getattr search };
allow httpd_t httpd_tmp_t:file { execute };
allow httpd_t ld_so_cache_t:file { execute };
allow httpd_t locale_t:file { execute };
allow httpd_t user_home_t:dir { getattr read search add_name remove_name write };
allow httpd_t user_home_t:file { getattr read append create lock setattr unlink write };
allow httpd_t usr_t:dir { write };
allow httpd_t usr_t:file { write };
allow mnt_t cifs_t:filesystem { associate };
allow user_home_t cifs_t:filesystem { associate };
allow user_home_t tmpfs_t:filesystem { associate };
allow usr_t cifs_t:filesystem { associate };

Fedra Core 5

newrules は、audit2allow というコマンドにマージされました。 policycoreutils という RPM が必要となりますが、 ユーザレベルでのポリシー変更ができなくなりましたので、レベルを下げて利用下さい。