Home > php教程 > php手册 > ApiGen4.1 windows安装教程,apigen4.1教程

ApiGen4.1 windows安装教程,apigen4.1教程

WBOY
Release: 2016-06-13 08:53:28
Original
1210 people have browsed it

ApiGen4.1 windows安装教程,apigen4.1教程

 

一. 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.知名案例:

4.ApiGen风格样式

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

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

二.ApiGen windows安装步骤

1. 下载ApiGen。

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

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

2.编写windows可执行bat文件

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

> @(PHP.exe执行文件地址) <span>"</span><span>%~dp0apigen.phar</span><span>"</span> %*
Copy after login

例如

@D:\xampp\php\php.exe <span>"</span><span>%~dp0apigen.phar</span><span>"</span> %*
Copy after login

另存为apigen.bat

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

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

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

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>
Copy after login

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

apigen generate --source <span>"</span><span>php项目地址</span><span>"</span> --destination <span>"</span><span>文档导出地址</span><span>"</span>
Copy after login

完整示例

apigen generate --source <span>"</span><span>D:\web\ruionline</span><span>"</span> --destination <span>"</span><span>D:\web\ruionline\doc</span><span>"</span>
Copy after login

<p>导出生成过程</p>
Copy after login

<p>最终生成目录结构 </p>
Copy after login

<p>web展示效果</p>
Copy after login

三.apigen命令参数详细说明

--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>
Copy after login

四.apigen支持php注释详解

<p>支持官方PSR-5标准</p>
Copy after login

1.Custom

<span>@deprecated
package
subpackage
copyright
license
author
version
since
see
uses
internal
todo
Standard</span>
Copy after login

2.param

<span>return</span><span>
throws
{@inheritdoc}
Magic methods and properties</span>
Copy after login

3.property

property-<span>read
property</span>-<span>write
method</span>
Copy after login

 

Related labels:
source:php.cn
Statement of this Website
The content of this article is voluntarily contributed by netizens, and the copyright belongs to the original author. This site does not assume corresponding legal responsibility. If you find any content suspected of plagiarism or infringement, please contact admin@php.cn
Popular Recommendations
Popular Tutorials
More>
Latest Downloads
More>
Web Effects
Website Source Code
Website Materials
Front End Template