Badoo PHP Code Formatter。 オープンソースになりました！

クラスPhpcf \ Impl \ Fsmの説明-トークンを解析するためのステートマシン

 <?php $fsm_context_rules = array( 'CTX_SOMETHING' => array( //  ,    = CTX_SOMETHING 'T_1' => 'CTX_OTHER_THING', //   T_1     CTX_OTHER_THING 'T_2' => array('CTX_OTHER_THING'), //   T_2  push(CTX_OTHER_THING) 'T_3' => -2, //   T_3  pop()   2  //   N     M     // ,        'T_4' => array(PHPCF_CTX_NOW => N, PHPCF_CTX_NEXT => M), // c        'T_5' => array('REPLACE' => array(-2, array('CTX_OTHER_THING')), //      ,     ,    ), ); 

 <?php $fsm_context_rules = array( '<context_name>[ ... <context_name>]' => array( '<token_code>[ ... <token_code>]' => <context_rule>, ), ); $context_rule = '<context_name>'; //    <context_name>     $context_rule = array('<context_name>'); //    <context_name>,  <context_name>   $context_rule = -N; //   N  , N —   //  ,    PHPCF_CTX_NOW,       , //   PHPCF_CTX_NEXT ( debug        "delayed rule") $context_rule = array(PHPCF_CTX_NOW => <context_rule>, PHPCF_CTX_NEXT => <context_rule>); 

フォーマット規則の配列：$コントロール

 <?php $controls = array( '<token_code>[ ... <token_code>]' => array( //    ,       ['<context>' => <formatting_rule>,] //  <formatting_rule>    PHPCF_KEY_ALL => <formatting_rule>, //  <formatting_rule>,         ), ); $formatting_rule = array( PHPCF_KEY_DESCR_LEFT => '<description>', //  ,        PHPCF_KEY_LEFT => PHPCF_EX_<action>, // ,         PHPCF_KEY_DESCR_RIGHT => '<description>', //      PHPCF_KEY_RIGHT => PHPCF_EX_<action>, // ,     ); // : 'T_AS T_ELSEIF T_ELSE T_CATCH' => array( //   "as", "elseif", "else"  "catch" PHPCF_KEY_ALL => array( //    PHPCF_KEY_DESCR_LEFT => 'One space before as, elseif, else, catch', PHPCF_KEY_LEFT => PHPCF_EX_SHRINK_SPACES_STRONG, //       ( ) PHPCF_KEY_DESCR_RIGHT => 'One space after as, elseif, else, catch', //    PHPCF_KEY_RIGHT => PHPCF_EX_SHRINK_SPACES_STRONG, //   ) ), 

トークンフック

 <?php namespace Phpcf\Impl; class Pure implements \Phpcf\IFormatter { /* *  $idx_tokens      array(T_SOMETHING => 'T_SOMETHING'), *       * *  $i_value       ,  token_get_all * *           $this->tokens   each() *   : tokenHookStr * *     ,     *        * *   ,      : */ private function tokenHookDoNothing($idx_tokens, $i_value) { if (is_array($i_value)) { $this->current_line = $i_value[2]; return array( array( PHPCF_KEY_CODE => $idx_tokens[$i_value[0]], PHPCF_KEY_TEXT => $i_value[1], PHPCF_KEY_LINE => $this->current_line, ) ); // set correct current line for next token if it does not have line number $this->current_line += substr_count($i_value[1], "\n"); } return array( array( PHPCF_KEY_CODE => $i_value, PHPCF_KEY_TEXT => $i_value, PHPCF_KEY_LINE => $this->current_line, ) ); } } 

トークンのフックの説明

• tokenHookHeredoc、tokenHookStr：デフォルトでは、PHPはHEREDOC、二重引用符、斜め引用符内のテキストを「トークン化」し、そこで変数を選択します。 フォーマッタは行に触れてはならないため、内容は1つのトークンに結合されます。
• tokenHookOpenBraceは、括弧内の式が長い（デフォルトでは120文字）か、式で改行が使用されている場合、トークン "（"を "（_LONG"に変換します。「long」配列と「short」配列を区別するために使用され、関数の呼び出しと定義;
• tokenHookCheckUnaryは、演算子が単項演算子（たとえば、「+」、「-」、＆）かどうかを判別します。 ルール内のコンテキスト間の遷移の数を減らすのに役立ちます。
• tokenHookStaticは、「static :: HELLO」のような呼び出しを「public static function」としての使用から分離します。 また、状態遷移のロジックを簡素化するのにも役立ちます。
• tokenHookClassdefは、キーワードの後に改行 （たとえば、「const \ n」）があると判断し、「const \ n var1 = 1、\ n var2 = 2;」などの構造を正しくフォーマットするために使用されることを決定します。
• tokenHookOpenTagは、開始タグが長いことを確認し、開始タグから空白も分離します（「<？php \ n」を2つのトークンに変換します：「<？php」と「\ n」）。
• tokenHookCloseTagは、ファイルの最後に終了タグがないことを確認します。
• tokenHookIncrementは、変数のどちら側が演算子「++」または「-」であるかを決定します。 コンテキスト間の遷移のロジックを簡素化するために作られました。
• tokenHookWhiteSpaceは、式がスペースで正当化されることを決定し、T_WHITESPACEをT_WHITESPACE_ALIGNEDに置き換えます。T_WHITESPACE_ALIGNEDは、フォーマット時に変更されません。
• tokenHookElseは、elseが単一行かブロックを含むかを決定します。 ロジックを簡素化するために作られました。
• tokenHookCommentは、単一行のコメントが「//」で始まることを確認し、トークンから改行を分離します（「// something \ n」は「// something」と「\ n」になります）。
• tokenHookTStringは、このT_STRINGがメソッドまたは関数の名前である場合、T_STRINGの名前をT_FUNCTION_NAMEに変更します。 コンテキスト間の遷移のロジックを簡素化するために作られました。
• tokenHookBinaryは、ステートメントを次の行に転送する状況を処理するために使用されます。
• tokenHookCommaは、長い配列の新しい行にラップできるコンマの場合、「、」を「、_LONG」に変換します。
• tokenHookFunctionは、匿名関数と非匿名関数を互いに分離します。