darake Update: 2025-10-09

令和から始めるPukiWiki入門|基本的な使い方と設定などのまとめ

自分だけのちょっとしたメモ帳的なwebアプリが欲しくなってきたので、PukiWikiを導入していく。

この手のものは、自作しようとすると意外と時間がかかったりするので、PukiWikiが既に存在しているのは非常にありがたい。

開発環境

PukiWikiの動作環境は8.1までなので、8.1を使うことにする。

では、PukiWikiの導入方法を説明していく。今回は、本家PukiWikiとMarkdown形式対応版の２つを紹介していく。

本家PukiWikiを導入したい場合は、公式サイトからzipファイルをダウンロードして解凍すること。

EUC-JP版とUTF-8版があるが、UTF-8版を選ぶこと。2025年10月現在だと、pukiwiki-1.5.4_utf8.zipを選べばよい。

プログラマ等であれば、PukiWikiの独自記法ではなく、Markdown形式で記事を書きたいはずだ。

m0370さんがPukiWikiの1.5.4をベースにして、Markdown形式に対応したバージョンを公開してくれている。

上記URLのzipファイルをダウンロードすることで、Markdownに対応したPukiWikiを使うことができる。

設定方法は本家もMarkdown対応版も同じなので、まとめて説明していく。

pukiwiki.ini.phpを以下のように編集していく。

# 管理者ユーザーのID。anonymousを変更する、
$modifier = 'anonymous';

次にサイトURLを変更する。ローカルで開発中であればhttp://localhost:8000に変更し、本番環境は実際のURLに変更するのが良い。

# ローカルだと、$modifierlink = 'http://localhost:8000'; に変更するのがよい。
$modifierlink = 'http://pukiwiki.example.com/';

管理者パスワードはmd5でハッシュ化したものを設定する必要がある。

$adminpass = '{x-php-md5}!';

md5ハッシュ化パスワードを作る仕組みはPukiWikiにはないので、自前でスクリプトを作る必要がある。例えば、my_md5.phpというファイルを作成して、以下のようにする。

# my_md5.phpのファイルで作成して、 php my_md5.php で実行
<?php

# your_passwordに好きなパスワードを入れる
$input = 'your_password';
echo md5($input) . "\n";

出力したハッシュ値をpukiwiki.ini.phpの$adminpassに設定する。

$adminpass = '{x-php-md5}出力したハッシュ値';

ここまでくると、ローカルでPukiWikiを試すことができる。

php -S 127.0.0.1:8000

ブラウザでhttp://localhost:8000にアクセスしてみよう。正常に動いたはず。