php マニュアル(chm版) 文字化け解消方法

皆様は、phpオフィシャルサイトから、Windowsヘルプ形式のchm版のマニュアルをダウンロードしたことはありますでしょうか？
多分一度でも使ったことのある方は、非常に便利だ！って思っている方が多いと思います。

ただ、それでも実は 1 点大きな欠点があります。もちろん使用されたことのある方は知っているかと思いますが、ダウンロードしたままだと、マニュアル内のキーワード(マニュアルに含まれるキーワードをインクリメンタルサーチが出来る部分)が、文字化けしているんです。

実は結構悩んでいて、ただそのために随分古い文字化けの無いバージョンを使用していたのですが、解消する方法がわかったのでメモ残しておきます。

【方法】

ダウンロードした chm ファイルを、自分の PC 上で再コンパイルする。

【必要なツール】

• KeyTools – デコンパイルツール
• Microsoft HTML Workshop – コンパイルツール

【手順】

1. KeyTool を起動
2. メニューバー [Tools] → [Decompile] から、chm ファイルを自分の好きなフォルダに decompile (元のファイルに解凍?ってイメージに近い) する。
3. そうすると、php_manual_ja.hhc、php_manual_ja.hhk、php_manual_ja.hhp、ja というフォルダ(中に数千の、.html) が作成されます。
4. 今度は、HTML Help Workshop を起動。
5. メニューバー [File] → [Compile] → [さきほどの php_manual_ja.hhp] を選択。
6. Compile(数千の html ファイルをまとめ、chm ファイルを生成) が始まるので、しばらく待つ。
7. 完了! キーワードの文字化けが解消した chm マニュアルが完成します。

オフィシャルの方は、何故うまくいってないかは想像でしか判断出来ませんが、自分で再コンパイルしてでも、キーワード検索は利用出来たほうが良いです(キッパリ)。

(おまけ)
でも、chm ファイルも便利ですが、つい先日のはてな勉強会で知った、
http://api.rails2u.com/
のインターフェイスのほうがさらに今風でかっこいいよなーと思います。

いまさらながら、YAML。簡単かつわかりやすくて良いですねぇ。
日本 ruby の会によるるびまでも YAML についての記事がありましたが、php でも spyc というライブラリで簡単に扱うことができます。

spyc
http://spyc.sourceforge.net/

もし、schema.yml というファイルを読み込む場合、

$dat = Spyc::YAMLLoad(‘schema.yml’);

とやるだけで、$dat に 配列として、schema.yml を読み込むことが出来てしまいます。
これはもう簡単というかなんというか、便利すぎです。

実は最近、symfony という PHP5 のフレームワークをいじっているのですが、このフレームワークも、YAML を最大限利用して作られているんですよね。

その中で出てきた propel という O/R マッパー(?)なんかも含めもうちょっと理解できたらまとめたいと思います。

普段自分は情報を追っかけているつもりでしたが、全然追えていないし、自分が知らないだけで便利な技術っていっぱいあるんだなーと改めて思いました。

なんだかたまに詰まる pear コマンドの使用方法。
まれに、依存性の関係やらなにやらで、beta が必要になる時があります。

以下コマンドで普通にインストールすると、stable 版がインストールされてしまいます。
(例として、パッケージを phpdocumentor とします)

> pear install phpdocumentor

それを回避したい場合は、以下の様にコマンドを打つことで回避できます。

beta バージョン

> pear install phpdocumentor-beta

alpha バージョン

> pear install phpdocumentor-alpha

わかっちゃえば簡単なんですが、ついつい引っかかったりしちゃうんですよねぇ…

<<追記>>
ホント無知であれなのですが、予め以下のコマンドを打っておくと、-beta 無しで行けるようです。
(stable ではなく、開発途上バージョン[beta等] を優先する)

>pear config-set preferred_state beta

こんどは、PHP5.1.2 の fgetcsv() ではまった…

fgetcsv() で読み込もうとする csv ファイルの文字コードと、PHP の内部文字エンコーディングが違う場合、fgetcsv() で読み込むと、どうしても文字が腐る …
(PHP4 時代[少なくとも 4.3 系統は]は、問題なかった)

【以下みたいな場合】

• CSV: Shift_JIS (Windows の Excel で作成されることを想定するとこれ)
• PHP内部コード: UTF-8 (最近は自分プロジェクトはこれで統一している)

で、試しに、CSV のエンコードを UTF-8 にして試すと、うまくいんだよなぁ。

色々調べると、PHP5 からどうやらロケール? に左右されるらしい… (参照URL: PHP-devML)

ただ、上記 ML のスレッドでも解決方法(いや解決してないようだが)を試しても、やっぱりダメ。
なら、PHP を ShiftJIS にすればいいじゃん！と思ったが、さすがにそれはプログラマとしてするわけにはいかない。

なので、そもそもバグなのかはわからないけど、いずれ修正されることを期待しつつ、今回も力業で取り急ぎの対処。以下、ソースコードと手順。

$buf = mb_convert_encoding(file_get_contents(“$CSV FilePath”), “utf-8”, “sjis”);
$fp = tmpfile();
fwrite($fp, $buf);
rewind($fp);

手順としては、

1. CSV ファイルを一度読み込む
2. 文字コードをコンバート
3. テンポラリファイルを作成
4. コンバートした内容を書き込む
5. 書き込んだファイルの、ファイルポインタを先頭に戻す
6. で、fgetcsv で読み込みを行う

これでうまくいった。
コード+4行で動作するのならば、まーいいかな…とは思うけど、相変わらず泥臭い対処方法だと思う。

PHPでファイルを読み込む際、改行コードが、[CR]の場合、どうしてもうまくいかん…前はうまくいっていたのに。と悩むこと少々。

ちょっと検索かけたところ、マニュアルに記述発見。
どうやら、PHP自体の設定で、区分けしているようだ。

PHPマニュアル::ファイルシステム関数

最近(それとも昔から?)は、わざわざ別設定として、読み込む際に、明確に区別していたんですね。

パフォーマンスの問題でしょうか？
ヘンなコード書いちゃう前に設定探せて良かった。

やはり、PHP はマニュアルがいい。

※ ちょっとテストも兼ねて以前別 blog に投稿していたのを再掲。