README

PHP Wrapper for MeCab

About

mecab コマンドのラッパー用スクリプトです。

php-mecab extension を使うと設定ミスなどでSegmentation Faultが発生して困る場合などに使ってください。

複数回連続して呼び出す場合のために、バックグラウンドでプロセスを起動させて再利用しています。

インストール

composer require karakani/mecha-mocha

使い方

基本的な使い方

$tagger = Tagger::create();
$nodeGroups = $tagger->parse("すもももももももものうち");

foreach ($nodeGroups as $nodeGroup) {
    foreach ($nodeGroup as $node) {
        printf("%s(%s)\n", $node->surface, $node->feature->pos);
    }
}

// 次のように出力されます:
//
// すもも(名詞)
// も(助詞)
// もも(名詞)
// も(助詞)
// もも(名詞)
// の(助詞)
// うち(名詞)

コマンドラインオプションを指定する

デフォルトのコマンドラインオプションを指定する場合。

$command = (new CommandBuilder())
    ->setBinPath('/usr/local/bin/mecab')
    ->setUserDic('/usr/local/lib/mecab/dic/mecab-ipadic-neologd')
    ->build();
$runner = CommandRunner::create($command);

Tagger::setDefaultRunner($runner);

$tagger = Tagger::create();

複数のインスタンスで異なるコマンドラインオプションを使用する場合。

$runnerWithDefaultOption = CommandRunner::create();
$taggerA = Tagger::create($runnerWithDefaultOption);

$runnerWithCustomOption = CommandRunner::create(
    (new CommandBuilder())
        ->setBinPath('/usr/local/bin/mecab')
        ->setUserDic('/usr/local/lib/mecab/dic/mecab-ipadic-neologd')
        ->build()
);
$taggerB = Tagger::create($runnerWithCustomOption);

コマンドラインの作成に CommandBuilder を使用しない場合。

$runner = CommandRunner::create([
    '/usr/local/bin/mecab',
    '--dicdir=/usr/local/lib/mecab/dic/mecab-ipadic-neologd',
]);

Tagger::setDefaultRunner($runner);

mecab プロセスを終了する

バックグラウンドで動作するプロセスを明示的に終了する場合。

Tagger::getDefaultRunner()->close();

但し、通常はスクリプト終了時に自動的に終了するため、必要がない限りこのメソッドを呼び出す必要はありません。

karakani / mecha-mocha

Maintainers

Details