php - Swagger php - 在不拆分代码的情况下过滤公共/私有 API

Question

我正在考虑使用 Zircote Swagger PHP 来记录 API。我还不完全熟悉它，因为在承诺使用它之前我一直在尝试回答这个问题。

我想要两组不同的文档。一个文档页面将包含我们所有的 API，而另一个将仅包含那些应该公开记录的 API。

我找到了这个答案，它或多或少地给了我正在寻找的结果。但是，他们建议的解决方案要求我对现有代码进行重大重构，因为我们的公共和私有 API 的实现尚未按照答案建议的方式进行拆分。

有没有办法在注释中标记单个 API，并在我生成文档时过滤这些标签？

Answer 1

它尚未实施，但我相信 PR 会受到欢迎。

目前，您可以对生成的文档进行后处理，例如通过单衬管进行管道处理：

swagger /path/to/project | php -r '$s = json_decode(file_get_contents("php://stdin"),true);array_walk($s["paths"],function(&$p){$p=array_filter($p,function($m){return count(array_intersect(["tag1","tag2"],$m["tags"]))==0;});});file_put_contents("php://stdout",json_encode($s,192));' > public.json

格式化以提高可读性：

$s = json_decode(file_get_contents("php://stdin"), true);
array_walk(
    $s["paths"],
    function (&$path) {
        $path = array_filter(
            $path,
            function ($method) {
                return count(array_intersect(["tag1", "tag2"], $method["tags"])) == 0;
            }
        );
    }
);
file_put_contents("php://stdout", json_encode($s, JSON_PRETTY_PRINT | JSON_UNESCAPED_SLASHES));

要排除的标签在哪里tag1和是。tag2