Zend 框架工具(ZFTool)
一、概览
ZFTool(下载)是一个维护模块化 ZF2 应用程序的公用模块。它可以在命令行模式下运行也可以安装成 ZF2 模块或者 PHAR(下文有介绍)。这个工具可以让你:
- 创建 ZF2 工程,安装一个应用程序骨架(skeleton);
- 在一个已经存在的 ZF2 应用程序内创建一个新的模块;
- 获得安装在应用程序内的所有模块列表;
- 获得 ZF2 应用程序的配置文件;
- 安装指定版本的 ZF2 库。
要安装 ZFTool,你可以使用下面的任何一种方法或者你可以只下载并使用 PHAR 包。
二、使用 Composer 安装
1、打开终端(命令提示符)
2、进入你应用程序目录
3、运行 composer require zendframework/zftool:dev-master
三、手动安装
1、使用git克隆或者下载zip包
2、解压到你 ZF2 应用程序的 vendor/ZFTool 目录
3、进入 vendor/ZFTool 目录,运行 zf.php
四、不安装,使用 PHAR 文件
1、如果只想要使用 ZF2 作为 shell 命令你就不需要安装 ZFTool。你可以下载 zftool.phar 使用
五、使用
在以下的使用举例中,可以用 zftool.phar 代替 zf.php 命令。
1、基本信息
> zf.php modules [list] 显示调用的模块
modules 选项显示已经安装在 ZF2 应用程序里的所有模块列表
> zf.php version | --version 显示当前 ZF 版本
version 选项显示 ZFTool 的版本号
,如果在 ZF2 应用程序根目录执行,显示应用程序所使用的 Zend 框架库文件版本号。
2、创建项目
> zf.php create project <path>
<path> 要创建的项目路径
这个命令在指定的路径上安装 Zend 应用程序骨架(
ZendSkeletonApplication
)
3、创建模块
> zf.php create module <name> [<path>]
<name> 要创建的模块名称
<path> ZF2 应用程序的根目录(可选)
这里命令可以用于在已经有的 ZF2 应用程序中创建新的模块。如果没有提供路径 ZFTool 尝试在当前目录中创建新的模块(只在这个当前目录包含一个 ZF2 应用程序时有效)。
4、classmap产生器
> zf.php classmap generate <directory> <classmap file> [--append|-a] [--overwrite|-w]
<directory> 扫描 PHP 类的目录(使用 . 表示使用当前目录)
<classmap file> 产生的类映射文件的文件名或者 - 标准输出。如果没有提供,默认的是在此路径里的 autoload_classmap.php
--append | -a 如果 classmap 文件存在就添加到它里面
--overwrite | -w 是否要覆盖已经存在的 classmap 文件
5、安装ZF库
> zf.php install zf <path> [<version>]
<path> ZF2 库文件安装路径
<version> 安装的版本号,如果没有指定,使用最后稳定的版本
这个命令会在路径中安装指定版本的 ZF2 库文件。如果
省略
版本号,将会使用最后一个稳定的有效版本。使用这个命令你可以在 ZF2 github 仓库中
安装所有指定的标记版本(所使用的版本名称是在标签版本中移除“
release-
”的字符串;例如,标签“
release-2.0.0
”相当于版本号 2.0.0)
6、编译 PHAR 文件
你可以创建一个 .phar 文件包含 ZFTool 项目。为了在一个 .phar 文件中编译 ZFTool,你执行下面的命令
> bin/create-phar
这个命令将在 bin 目录下创建一个 zftool.phar 文件。你可以使用这个文件执行所有的 ZFTool 功能。在 zftool.phar 创建后,我们建议把 ZFTool 所在的 bin 目录添加到你的 PATH 环境变量中。这样你可以在任何地方执行 zftool.phar。