PHP 程式碼文件產生器：掃描註解標記輸出 API 文件

設計目標

掃描 PHP 檔案中的特定註解標記，自動產生函數/類別說明文件。

註解格式規範

/*
@@function_name($arg1, $arg2)
%%This function does something useful.
!!
*/
function function_name($arg1, $arg2) { ... }

• @@：函數簽名 (標題)
• %%：功能描述
• !!：水平分隔線
• ;：宣告結束

核心解析邏輯

";
        $i += 2;
        while ($buf[$i] !== ';' && $i < strlen($buf)) {
            if ($buf[$i] === ';') break;
            echo $buf[$i];
            $i++;
        }
        echo "";
    }
    // 描述 %%
    if ($buf[$i] === '%' && $buf[$i+1] === '%') {
        echo "
說明：";
        $i += 2;
        while ($buf[$i] !== ';' && $i < strlen($buf)) {
            if ($buf[$i] === ';') break;
            echo $buf[$i];
            $i++;
        }
        echo "
";
    }
    // 分隔線 !!
    if ($buf[$i] === '!' && $buf[$i+1] === '!') {
        echo "
";
        $i++;
    }
}
?>

改進與擴充建議

1. 支援類別/屬性/方法：擴充標記如 @@class ClassName, @@property $var, @@method methodName。
2. 輸出格式多樣化：HTML、Markdown、JSON、Sami/PhpDocumentor 相容格式。
3. 使用 tokenizer：token_get_all() 正式解析 PHP 結構，比字串掃描健壯。
4. 整合現代工具：直接採用 phpDocumentor、phpdoc-md 等成熟方案。