esperecyan/dictionary-php

従来の辞書形式と「主に単語で答えるゲームにおける汎用的な辞書形式」の構文解析、直列化を行う API を提供します。

主に単語で答えるゲームにおける辞書の構文解析・直列化を行うPHPライブラリ

次のゲームの辞書を構文解析し、相互に変換できるようにする API を提供します。, _(*1)

• 主に単語で答えるゲームにおける汎用的な辞書形式 以下、汎用辞書形式)以下、汎用辞書形式)
• キャッチフィーリング、Drawing Catch .cfq).cfq)
• きゃっちま .dat) ※暗号化後のファイルは扱えません.dat) ※暗号化後のファイルは扱えません
• Inteligenceω .txt, *.zip) ※暗号化後のファイルは扱えません.txt, *.zip) ※暗号化後のファイルは扱えません
• ピクトセンス

Inteligenceωの辞書で画像・音声ファイルへのパスが含まれる場合、 そのファイルが含まれるフォルダをdatファイルと一緒にアーカイブする必要があります。 同名のファイルが含まれる辞書 (同名のファイルを別々のフォルダに分けて格納したアーカイブ) は取り扱えません。, _(*2)

例

<?php
require_once 'vendor/autoload.php';

use esperecyan\dictionary_php as dictionary;

$file = new \SplTempFileObject();
$file->fwrite(mb_convert_encoding(<<<'EOD'
% 選択問題
Q,2,,../images/sun.mp4
A,1,地球,カロン,太陽,\seikai

Q,0,仲間外れはどれでしょう
A,1,リンゴ,\seikai,ゴリラ,ラクダ,ダチョウ,\explain=選択肢を表示しなければ問題が成立しない場合。

% 答えが複数あり、どれか1つを選択すれば正解になる場合
Q,0,食べ物はどれでしょう (答えが複数ある場合はどれが1つだけ選択)
A,1,リンゴ,\seikai,ゴリラ,ラッパ,パン,\seikai

% 答えが複数あり、すべて選択する必要がある場合
Q,0,同じ種類のものを選びましょう
A,3,リンゴ,\seikai,ゴリラ,ラッパ,パン,\seikai

% 並べ替え問題
q,0,しりとりが成立するように並べ替えてください
% 問題行と解答行の間のコメント行と空行

a,2,リンゴ,1,パン,4,ゴリラ,2,ラッパ,3
EOD
, 'Windows-31J', 'UTF-8'));

$parser = new dictionary\Parser(null, '選択・並べ替え問題.txt');
$dictionary = $parser->parse($file);

$serializer = new dictionary\serializer\GenericDictionarySerializer();
$serializer->response($dictionary);

上の例の出力は以下となります。, _(*3)

text,image,answer,answer,description,specifics,question,option,option,option,option,type,@title
太陽,local/sun.png,太陽,,,,,地球,カロン,太陽,,selection,選択・並べ替え問題
リンゴ,,リンゴ,,選択肢を表示しなければ問題が成立しない場合。,,仲間外れはどれでしょう,リンゴ,ゴリラ,ラクダ,ダチョウ,selection,
「リンゴ」か「パン」,,リンゴ,パン,,,"食べ物はどれでしょう (答えが複数ある場合はどれが1つだけ選択)",リンゴ,ゴリラ,ラッパ,パン,selection,
「リンゴ」と「パン」,,リンゴ,パン,,require-all-right=,同じ種類のものを選びましょう,リンゴ,ゴリラ,ラッパ,パン,selection,
"リンゴ → ゴリラ → ラッパ → パン",,,,,,しりとりが成立するように並べ替えてください,リンゴ,ゴリラ,ラッパ,パン,selection,

インストール

composer require esperecyan/dictionary-php

Composer のインストール方法については、Composer のグローバルインストール - Qiitaなどをご覧ください。, _(*4)

要件

• PHP 7.1 以上
• php-mbstring (mbstring拡張モジュール)
• exif拡張モジュール
• php-intl (Intl拡張モジュール)
• php-gd (GD拡張モジュール)
• php-pecl-zip (Zip拡張モジュール)

パブリックAPI

class esperecyan\dictionary_php\Parser(string $from = null, string $filename = null, string $title = null)

構文解析器。, _(*5)

string $from = null

変換元の辞書形式。キャッチフィーリング きゃっちま Inteligenceω クイズ Inteligenceω しりとり ピクトセンス 汎用辞書 のいずれか。, _(*6)

指定されていないか間違った値が指定されていれば、$filename から判断します。 その場合のInteligenceωについては、コメント行、空行を除く最初の行が Q, で始まるか否かで、クイズとしりとりを判別します。, _(*7)

string $filename = null

変換元のファイル名。, _(*8)

string $title = null

辞書のタイトル。, _(*9)

指定されていなければ、$filename から判断します。, _(*10)

汎用辞書形式で @title フィールドが存在する場合、この指定は無視されます。, _(*11)

Dictionary esperecyan\dictionary_php\Parser#parse(SplFileInfo $file, bool $header = null, string[] $filenames = [])

SplFileInfo $file

変換元のファイルをSplFileInfo、またはその派生クラスで与えます。, _(*12)

変換元のファイルが 汎用辞書 の場合、ヘッダ行が存在すれば true、存在しなければ false、不明なら null を指定します。, _(*13)

string[] $filenames = []

変換元のファイルが 汎用辞書 の場合、$file にZIPファイルを与える代わりに、$file にCSVファイルを与えこの引数にファイル名のリストを与えることで、 「画像・音声・動画ファイルを含む場合のファイル形式」の構文解析できます。, _(*14)

例外 esperecyan\dictionary_php\exception\SyntaxException

SyntaxException#getMessage() から、ユーザーに示すエラーメッセージを取得できます。, _(*15)

ロギング

esperecyan\dictionary_php\ParserはPSR-3: Logger InterfaceのPsr\Log\LoggerAwareInterfaceを実装しています。, _(*16)

直列化器。, _(*17)

string $to = '汎用辞書'

変換先の辞書形式。キャッチフィーリング きゃっちま Inteligenceω クイズ Inteligenceω しりとり ピクトセンス 汎用辞書 のいずれか。, _(*18)

指定されていないか間違った値が指定されていれば、汎用辞書 になります。, _(*19)

string[] esperecyan\dictionary_php\Serializer#serialize(Dictionary $dictionary, bool|string $csvOnly = false)

次のような構造の連想配列で直列化したデータを返します。, _(*20)

• [bytes] => 直列化したデータのバイナリ文字列
• [type] => MIME型 charsetパラメータなどをともなう)charsetパラメータなどをともなう)
• [name] => ファイル名

Dictionary $dictionary

辞書。, _(*21)

bool|string $csvOnly = false

汎用辞書 Inteligenceω クイズ の場合、ZIPファイルの代わりにCSVファイル、txtファイルのみを返すときに真に設定します。 真の代わりに https://example.ne.jp/dictionaries/1/files/%s のような文字列を設定することで、%s をファイル名に置き換えて辞書ファイル中に記述します。, _(*22)

例外 esperecyan\dictionary_php\exception\SerializeExceptionInterface

SerializeExceptionInterface#getMessage() から、ユーザーに示すエラーメッセージを取得できます。 以下の例外はいずれも SerializeExceptionInterface を実装しています。, _(*23)

ロギング

class esperecyan\dictionary_php\Dictionary

辞書データ。, _(*24)

(string|string[]|float)[][][] esperecyan\dictionary_php\Dictionary#getWords()

次のような構造の多次元配列で表されたお題の一覧を返します。, _(*25)

• [0] =>
  • [text] => array(文字列)
  • [image] => array(文字列)
  • [image-source] =>
    • [0] =>
      • [lml] => CommonMark (文字列)
      • [html] => HTML (文字列)
  • [audio] => array(文字列)
  • [audio-source] =>
    • [0] =>
      • [lml] => CommonMark (文字列)
      • [html] => HTML (文字列)
  • [video] => array(文字列, ……)
  • [video-source] =>
    • [0] =>
      • [lml] => CommonMark (文字列)
      • [html] => HTML (文字列)
  • [answer] => array(文字列, ……)
  • [description] => array(文字列)
  • [weight] => array(浮動小数点数)
  • [specifics] => array(文字列)
  • [question] => array(文字列)
  • [option] => array(文字列, ……)
  • [type] => array(文字列)
• [1] => ……
• [2] => ……
• ……

(string|string[])[] esperecyan\dictionary_php\Dictionary#getMetadata()

次のような構造の多次元配列で表されたメタフィールドの一覧を返します。, _(*26)

• [@title] => 文字列
• [@summary] =>
  • [lml] => CommonMark (文字列)
  • [html] => HTML (文字列)
• [@regard] => 文字列

FilesystemIterator esperecyan\dictionary_php\Dictionary#getFiles()

辞書に同梱されるファイルを返します。, _(*27)

esperecyan\dictionary_php\Dictionary#setFiles(FilesystemIterator $files)

辞書に同梱されるファイルを設定します。それぞれ同梱されるファイルとして妥当で、 かつすべてのファイル名とParser#parse()の第3引数$filenamesに与えたファイル名が一致している必要があります。, _(*28)

class esperecyan\dictionary_php\Validator()

辞書に同梱されるファイルのバリデータ。, _(*29)

string[] esperecyan\dictionary_php\Validator#correct(string|SplFileInfo $file, string $filename)

Serializer#serialize()の戻り値と同じ構造の戻り値を返します。, _(*30)

string|SplFileInfo $file

ファイルをバイナリ文字列、SplFileInfo、その派生クラスのいずれかで与えます。, _(*31)

string $filename

ファイル名。, _(*32)

例外 esperecyan\dictionary_php\exception\SyntaxException

SyntaxException#getMessage() から、ユーザーに示すエラーメッセージを取得できます。, _(*33)

ロギング

esperecyan\dictionary_php\ValidatorはPSR-3: Logger InterfaceのPsr\Log\LoggerAwareInterfaceを実装しています。, _(*34)

Contribution

Pull Request、または Issue よりお願いいたします。, _(*35)

セマンティック バージョニング

当ライブラリはセマンティック バージョニングを採用しています。 パブリックAPIは、上記のとおりです。, _(*36)

ライセンス

当スクリプトのライセンスは Mozilla Public License Version 2.0 MPL-2.0) です。MPL-2.0) です。, _(*37)