Heim > php教程 > php手册 > Hauptteil

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

WBOY
Freigeben: 2016-06-13 08:53:28
Original
1108 Leute haben es durchsucht

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> %*
Nach dem Login kopieren

例如

@D:\xampp\php\php.exe <span>"</span><span>%~dp0apigen.phar</span><span>"</span> %*
Nach dem Login kopieren

另存为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>
Nach dem Login kopieren

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

apigen generate --source <span>"</span><span>php项目地址</span><span>"</span> --destination <span>"</span><span>文档导出地址</span><span>"</span>
Nach dem Login kopieren

完整示例

apigen generate --source <span>"</span><span>D:\web\ruionline</span><span>"</span> --destination <span>"</span><span>D:\web\ruionline\doc</span><span>"</span>
Nach dem Login kopieren

<p>导出生成过程</p>
Nach dem Login kopieren

<p>最终生成目录结构 </p>
Nach dem Login kopieren

<p>web展示效果</p>
Nach dem Login kopieren

三.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>
Nach dem Login kopieren

四.apigen支持php注释详解

<p>支持官方PSR-5标准</p>
Nach dem Login kopieren

1.Custom

<span>@deprecated
package
subpackage
copyright
license
author
version
since
see
uses
internal
todo
Standard</span>
Nach dem Login kopieren

2.param

<span>return</span><span>
throws
{@inheritdoc}
Magic methods and properties</span>
Nach dem Login kopieren

3.property

property-<span>read
property</span>-<span>write
method</span>
Nach dem Login kopieren

 

Verwandte Etiketten:
Quelle:php.cn
Erklärung dieser Website
Der Inhalt dieses Artikels wird freiwillig von Internetnutzern beigesteuert und das Urheberrecht liegt beim ursprünglichen Autor. Diese Website übernimmt keine entsprechende rechtliche Verantwortung. Wenn Sie Inhalte finden, bei denen der Verdacht eines Plagiats oder einer Rechtsverletzung besteht, wenden Sie sich bitte an admin@php.cn
Beliebte Empfehlungen
Beliebte Tutorials
Mehr>
Neueste Downloads
Mehr>
Web-Effekte
Quellcode der Website
Website-Materialien
Frontend-Vorlage
Über uns Haftungsausschluss Sitemap
Chinesische PHP-Website:Online-PHP-Schulung für das Gemeinwohl,Helfen Sie PHP-Lernenden, sich schnell weiterzuentwickeln!