qaharmdz/doctracer

DocTracer 帮助您创建有意义的 API 文档报告。反映 PHP 类信息,并在一页上显示 Markdown 格式的文档。

v1.0.2 2021-08-01 10:03 UTC

This package is auto-updated.

Last update: 2024-09-04 19:02:45 UTC


README

DocTracer 帮助您创建有意义的 API 文档报告。反映 PHP 类信息,并在一页上显示 Markdown 格式的文档。

访问 DocTracer API 文档 查看结果。

DocTracer preview

安装

composer require qaharmdz/doctracer --dev

用法

创建 DocTracer 实例。

$tracer = new \Mdz\DocTracer($baseDirectory = './');

检查目标目录(相对于 $baseDir)内的所有 PHP 代码。

$tracer->inspect('./../src');
$tracer->inspect('./Library/');

检查结果

获取检查结果数据。

$reports = $tracer->getResults();
var_dump($reports);

HTML 报告

输出 HTML 报告。

echo $output = $tracer->render([
    'title'   => 'DocTracer Test',
    'tagline' => 'PHP ReflectionClass and API documentation',
    'theme'   => 'darkmoon',
]);

保存输出到文件。

file_put_contents('example-api.html', $output);

渲染选项

  • title 页面标题(h1)和元标题
  • tagline 页面标题标语
  • footer 页脚信息。 默认: {title} - {tagline}
  • theme 报告主题。 选项: default, darkmoon
  • css 自定义报告样式
  • template 自定义模板路径

许可证 (MIT)

版权 (c) 2021 Mudzakkir。

特此授予任何获得本软件及其相关文档文件(“软件”)副本的任何人免费使用软件的权利,不受任何限制,包括但不限于使用、复制、修改、合并、发布、分发、再许可和/或出售软件副本的权利,并允许将软件提供给其他人,以便他们可以这样做,前提是受以下条件约束

上述版权声明和本许可声明应包含在软件的所有副本或实质性部分中。

软件按“现状”提供,不提供任何明示或暗示的保证,包括但不限于适销性、针对特定目的的适用性和非侵权性保证。在任何情况下,作者或版权所有者均不对任何索赔、损害或其他责任负责,无论是基于合同、侵权或其他原因,是否因软件或软件的使用或其他方式而产生、产生于或与软件或软件的使用或其他方式有关。