ApiGen是自动生成PHP项目的阅读文档工具。 用于从PHP源代码创建专业的API文档,类似于phpDocumentor/phpDoc。
ApiGen4.1需要PHP 5.4+的版本支持
(1).OSCHINA地址www.oschina.net/p/apigen
(2).官网地址www.apigen.org
(3).github地址https://github.com/apigen/apigen#options
官方推荐有默认和Twitter ApiGen4.1 windows installation tutorial, apigen4.1 tutorial_PHP tutorial两套风格样式。
官网地址http://www.apigen.org/
官网下载地址http://apigen.org/apigen.phar
打开记事本写入以下相关信息,并另存为apigen.bat文件。
> @(PHP.exe执行文件地址) <span>"</span><span>%~dp0apigen.phar</span><span>"</span> %*
例如
@D:\xampp\php\php.exe <span>"</span><span>%~dp0apigen.phar</span><span>"</span> %*
另存为apigen.bat
windows7 对应目录为 C:\Windows\System32
c:\><span>apigen ApiGen version </span><span>4.1</span>.<span>0</span><span> Usage: command [options] [arguments] Options: </span>--help (-<span>h) Display this help message. </span>--quiet (-<span>q) Do not output any message. </span>--version (-<span>V) Display this application version. Available commands: generate Generate API documentation help Displays help </span><span>for</span><span> a command list Lists commands self</span>-<span>update Updates apigen.phar to the latest available version selfupdate Updates apigen.phar to the latest available version</span>
apigen generate --source <span>"</span><span>php项目地址</span><span>"</span> --destination <span>"</span><span>文档导出地址</span><span>"</span>
完整示例
apigen generate --source <span>"</span><span>D:\web\ruionline</span><span>"</span> --destination <span>"</span><span>D:\web\ruionline\doc</span><span>"</span>
<p>导出生成过程</p>
<p>最终生成目录结构 </p>
<p>web展示效果</p>
--source <path>需要编译成文档的 Project 目录, --source <path><span> 同时可以指定多个 </span>--destination <path><span> 编译后存放的目录路径 </span>--title <Name><span> 文档首页的标题 </span>--exclude <path> 排除的目录(如 <span>'</span><span>views/*</span><span>'</span><span> 表示视图目录下的不生成文档) Options: </span>--source (-s) Dirs or files documentation is generated <span>for</span><span>. (multiple va lues allowed) </span>--destination (-d) Target <span>dir</span> <span>for</span><span> documentation. </span>--access-<span>levels Access levels of included method and properties. (default: [</span><span>"</span><span>public</span><span>"</span>,<span>"</span><span>protected</span><span>"</span><span>]) (multiple values allowed) </span>--annotation-<span>groups</span><span> Generate page with elements with specific annotation. </span>--base-url Base url used <span>for</span> sitemap (useful <span>for</span><span> public doc). </span>--config Custom path to apigen.neon config <span>file</span>. (default: <span>"</span><span>E:\\ide</span> /apigen.neon<span>"</span><span>)</span> --google-cse-<span>id</span> Custom google search engine <span>id</span> (<span>for</span><span> search box). </span>--google-<span>analytics Google Analytics tracking code. </span>--<span>debug Turn on debug mode. </span>--deprecated Generate documentation <span>for</span><span> elements marked as @deprecated </span>--<span>download Add link to ZIP archive of documentation. </span>--extensions Scanned <span>file</span> extensions. (default: [<span>"</span><span>php</span><span>"</span><span>]) (multiple valu es allowed) </span>--<span>exclude Directories and files matching this mask will not be parse d (e.g. </span>*/tests<span>/*</span><span>). (multiple values allowed) --groups The way elements are grouped in menu. (default: "auto") --charset Charset of scanned files. (multiple values allowed) --main Elements with this name prefix will be first in tree. --internal Include elements marked as @internal. --php Generate documentation for PHP internal classes. --skip-doc-path Files matching this mask will be included in class tree, b ut will not create a link to their documentation. (multiple values allowed) --no-source-code Do not generate highlighted source code for elements. --template-theme ApiGen template theme name. (default: "default") --template-config Your own template config, has higher priority templateThem e. --title Title of generated documentation. --todo Generate documentation for elements marked as @todo. --tree Generate tree view of classes, interfaces, traits and exce ptions. --help (-h) Display this help message. --quiet (-q) Do not output any message. --version (-V) Display this application version.</span>
<p>支持官方PSR-5标准</p>
<span>@deprecated package subpackage copyright license author version since see uses internal todo Standard</span>
<span>return</span><span> throws {@inheritdoc} Magic methods and properties</span>
property-<span>read property</span>-<span>write method</span>