首页 > 学院 > 开发设计 > 正文

ApiGen4.1windows安装教程

2019-11-14 14:44:56
字体:
来源:转载
供稿:网友

 

一. ApiGen4.1版本介绍

1.ApiGen介绍

ApiGen是自动生成php项目的阅读文档工具。 用于从PHP源代码创建专业的API文档,类似于phpDocumentor/phpDoc。

ApiGen4.1需要PHP 5.4+的版本支持

2.ApiGen官网地址

(1).OSCHINA地址www.oschina.net/p/apigen

(2).官网地址www.apigen.org

(3).github地址https://github.com/apigen/apigen#options

3.知名案例:

  1. Amazaon Web Services
  2. Doctrine
  3. Nette
  4. CakePHP

4.ApiGen风格样式

官方推荐有默认和Twitter Bootstrap两套风格样式。

  • ApiGen官方默认风格
  •  ApiGen官方默认风格
  • ApiGen官方Bootstrap风格
  •  Bootstrap

二.ApiGen windows安装步骤

1. 下载ApiGen。

官网地址http://www.apigen.org/

官网下载地址http://apigen.org/apigen.phar

2.编写windows可执行bat文件

打开记事本写入以下相关信息,并另存为apigen.bat文件。

> @(PHP.exe执行文件地址) "%~dp0apigen.phar" %*

 

例如

@D:/xampp/php/php.exe "%~dp0apigen.phar" %*

 

另存为apigen.bat

3.将apigen.phar及apigen.bat文件复制或移动到环境变量PATH任一目录中。

windows7 对应目录为 C:/Windows/System32

4.在命令行中执行apigen出现版本及相关命令信息则证明安装成功。

c:/>apigenApiGen version 4.1.0Usage: command [options] [arguments]Options: --help (-h)    Display this help message. --quiet (-q)   Do not output any message. --version (-V) Display this application version.Available commands: generate      Generate API documentation help          Displays help for a command list          Lists commands self-update   Updates apigen.phar to the latest available version selfupdate    Updates apigen.phar to the latest available version

 

5.执行生成apigen文档命令。

apigen generate --source "php项目地址" --destination "文档导出地址"

 

完整示例

apigen generate --source "D:/web/ruionline" --destination "D:/web/ruionline/doc"

 

导出生成过程

 

最终生成目录结构 

apigen目录结构

web展示效果

apigen web展示效果

三.apigen命令参数详细说明

--source <path>需要编译成文档的 PRoject 目录, --source <path> 同时可以指定多个--destination <path>  编译后存放的目录路径--title <Name>  文档首页的标题--exclude <path> 排除的目录(如 'views/*' 表示视图目录下的不生成文档)Options: --source (-s)        Dirs or files documentation is generated for. (multiple values allowed) --destination (-d)   Target dir for documentation. --access-levels      Access levels of included method and properties. (default: ["public","protected"]) (multiple values allowed) --annotation-groups  Generate page with elements with specific annotation. --base-url           Base url used for sitemap (useful for public doc). --config             Custom path to apigen.neon config file. (default: "E://ide/apigen.neon") --google-cse-id      Custom google search engine id (for search box). --google-analytics   Google Analytics tracking code. --debug              Turn on debug mode. --deprecated         Generate documentation for elements marked as @deprecated --download           Add link to ZIP archive of documentation. --extensions         Scanned file extensions. (default: ["php"]) (multiple values allowed) --exclude            Directories and files matching this mask will not be parsed (e.g. */tests/*). (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, but 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 templateTheme. --title              Title of generated documentation. --todo               Generate documentation for elements marked as @todo. --tree               Generate tree view of classes, interfaces, traits and exceptions. --help (-h)          Display this help message. --quiet (-q)         Do not output any message. --version (-V)       Display this application version.

 

四.apigen支持php注释详解

支持官方PSR-5标准

1.Custom

@deprecatedpackagesubpackagecopyrightlicenseauthorversionsinceseeusesinternaltodoStandard

 

2.param

returnthrows{@inheritdoc}Magic methods and properties

 

3.property

property-readproperty-writemethod

 


发表评论 共有条评论
用户名: 密码:
验证码: 匿名发表