phpdocumenterでpackages下にdefault.html, Default.htmlが出力される問題

phpdocumenterでソースコードからドキュメント自動生成をしたときに起きた問題。

https://github.com/phpDocumentor/phpDocumentor2

# ドキュメント生成コマンド
$ phpdoc run -d <SOURCE_DIRECTORY> -t <TARGET_DIRECTORY> --template=responsive-twig

すると、TARGET_DIRECTORY/packages配下にdefault.html と Default.htmlが出力される。

$ ls TARGET_DIRECTORY/packages
default.html  Default.html

これをwindows環境で展開すると問題となる。 windows環境だと、どうやら大文字・小文字をファイル名としては区別しないようだ。なんてポンコツなんだ…

helpを読む。

$ phpdoc run -h
...
  --defaultpackagename[=DEFAULTPACKAGENAME] Name to use for the default package. [default: "Default"]
...

–defaultpackagename=XX オプションを指定するとDefault.htmlのファイル名を変更できる様子。

$ phpdoc run -d <SOURCE_DIRECTORY> -t <TARGET_DIRECTORY> --template=responsive-twig --defaultpackagename=foo
$ ls TARGET_DIRECTORY/packages
default.html  foo.html

うむ。