皆さんはPHPでコマンドラインスクリプトを作成するとき、引数の解析はどうされてますか？

引数が単純であればargvをそのまま使うだけで十分ですが、オプションが多かったりすると結構面倒ですよね。

たまたまPHPプロ！Weekly PEAR リリース @ 08/08/05号でConsole_CommandLineという引数を解析するライブラリを見つけて使ってみたところ、なかなか便利だったのでご紹介したいと思います。

ちなみに、オプションの解析には、PHP標準のgetopt関数を使えば多少楽はできるのですが、

getopt.php

1. <?php
2. $options = getopt('d:');
3. print_r($options);
4. ?>

1. $ php getopt.php -h -d 20080807 filename

1. Array
2. (
3.     [d] => 20080101
4. )

といったように、不明なオプションが指定されているのを判断できなかったり、引数のfilenameを取得できなかったりと、あまり使い勝手が良くありません。

PEAR::Console_CommandLineはそこもきちんと対処してくれます。なお、Pythonのoptparseモジュールにインスパイアされて作られたものらしいです。

では、まずインストールします。

1. # pear install Console_CommandLine

例として、日付と複数のファイル名を引数にとるスクリプトを作成してみます。

command_line.php

1. <?php
2. require_once 'Console/CommandLine.php';
3.  
4. // パーサの作成
5. $parser = new Console_CommandLine(array(
6.   'description' => 'Console_CommandLineのサンプル',
7.   'version'     => '1.0.0'
8. ));
9.  
10. // オプションの追加
11. $parser->addOption('date', array(
12.   'short_name'  => '-d',
13.   'long_name'   => '--date',
14.   'action'      => 'StoreString',
15.   'help_name'   => 'YYYYMMDD',
16.   'description' => '対象となる日付',
17. ));
18.  
19. // 引数の追加
20. $parser->addArgument('files', array(
21.   'multiple'    => true,
22.   'description' => '処理するファイル'
23. ));
24.  
25. // パーサの実行
26. try {
27.   $result = $parser->parse();
28.   print_r($result->options);
29.   print_r($result->args);
30. } catch (Exception $e) {
31.   $parser->displayError($e->getMessage());
32. }
33. ?>

それでは、とりあえず何も指定せずに実行します。

1. $ php command_line.php

1. Error: You must provide at least 1 argument.
2. Type "command_line.php -h" to get help.

エラーメッセージにあるように「-h」をつけてみます。

1. $ php command_line.php -h

1. Console_CommandLineのサンプル
3. Usage:
4.   command_line.php [options] <files...>
6. Options:
7.   -d YYYYMMDD, --date=YYYYMMDD  対象となる日付
8.   -h, --help                    show this help message and exit
9.   -v, --version                 show the program version and exit
11. Arguments:
12.   files  処理するファイル

普通のコマンドのようなヘルプが表示されましたね。

それでは、パラメータを指定して実行してみます。

1. $ php command_line.php -d 20080807 filename1 filename2

1. Array
2. (
3.     [date] => 20080807
4.     [help] =>
5.     [version] =>
6. )
7. Array
8. (
9.     [files] => Array
10.         (
11.             [0] => filename1
12.             [1] => filename2
13.         )
15. )

連想配列に必要な情報がすべて入ってますね。あとはこれを利用して実際の処理を行うだけです。

なお、存在しないオプションを指定すると、きちんとエラーが表示されます。

1. $ php command_line.php -i

1. Error: Unknown option "-i".
2. Type "command_line.php -h" to get help.

また、「-v」や「--version」をつけて実行すると、バージョンが表示されます。

1. $ php command_line.php --version

1. command_line.php version 1.0.0.

また、面白い機能として、XMLでオプションの設定をすることもできるようです。

バッチ処理などPHPでコマンドラインスクリプトを作成する際、引数が複雑な場合はPEAR::Console_CommandLineを使ってみては如何でしょうか。