zend framework开发工具“ZF tool用法介绍”

ZF tool是创建zend framework框架目录结构和结构文件的工具。具体命令使用如下：

  1.创建项目(命令格式：zf create project 项目名称)

     如：在D盘workspace\PHP\下欲创建一个wwwroot项目，在终端模式下输入以下命令

cd workspace\PHPzf create project wwwroot

     如此，项目即创建完成。通过资源管理器可以看到，在D盘workspace\PHP\下生成了一个wwwroot目录，并且在目录下自动创建好了一些目录和文件。

     我们假设你已经搭建好了zend framework开发环境，并且指定了web服务器的DocumentRoot为当前的项目路径"D:/workspace/PHP/wwwroot/public"，在浏览器中输入http://localhost/地址后将会呈现出一个标准的zend framework网页。

  2.启用layout布局模版(命令格式：zf enable layout)

     layout布局功能默认是没有开启的，需要通过命令进行开启。先切换到项目目录下，然后执行开启命令

cd wwwrootzf enable layout

    我们再来观察下wwwroot目录下的application文件夹的变化

    启用layout功能后，在application目录下多了一个layouts文件夹，其下有一个layout.phtml文件，这就是网页布局文件

  3.创建模型(命令格式：zf create model 模型名称)

     如：创建一个名为User的模型

zf create model user

     该命令在application/models目录下创建了一个名为User.php的文件（在命令行中，如果输入的模型名称的首字母为小写，则系统会自动将其转换为大写）。

  4.创建控制器(命令格式：zf create controller 控制器名称 1)

     如：创建一个名为User的控制器

zf create controller User 1

     执行上述命令将会在application\controllers\下生成一个UserController.php控制器文件，且文件中自动创建了一个indexAction方法，并与application\views\scripts\user下的index.phtml视图文件相对应（命令后边的参数1可以省略）。

  5.为控制器添加方法(命令格式：zf create action 方法名称 控制器名称)

     如：给User控制器添加一个register方法

zf create action register User

     所创建的方法将与视图相对应

  

  6.创建表单(命令格式：zf create form  表单名称)
     如：欲创建一个名为User的表单

zf create form User

     执行该命令会发现，在application目录下新创建了一个forms文件夹，并在其中自动生成了一个User.php的表单文件。

  7.修改命名空间(即“类前缀名”)(命令格式：zf change application.class-name-prefix 改后名称)

     如：先切换到项目目录下，然后执行修改命令

D:\workspace\PHP\wwwroot>zf change application.class-name-prefix Ad

    本次修改将会影响到项目根目录下的.zfproject.xml文件和根目录下application文件夹下的configs中的application.ini配置文件的内容项。

    修改命名空间的作用就是给项目在开发的过程中限定好被创建的控制器、模型、表单等的名称前缀，使不同项目之间的代码具有区分可读性，对项目本身无实质性影响。

  8.让框架运行在开发模式(配置application.ini文件和index.php文件)

    框架默认运行在发布（即产品）模式。而我们在开发的过程中需要捕捉到必要的错误信息供调试排错用，所以我们需要将框架的运行状态改为开发模式。打开public/index.php,找到如下代码段

// Define application environmentdefined('APPLICATION_ENV')    || define('APPLICATION_ENV', (getenv('APPLICATION_ENV') ? getenv('APPLICATION_ENV') : 'production'));

    将第三行代码末端的“production”改为“development”。

// Define application environmentdefined('APPLICATION_ENV')    || define('APPLICATION_ENV', (getenv('APPLICATION_ENV') ? getenv('APPLICATION_ENV') : 'development'));

    另，在开发模式下，对配置文件application\configs\application.ini的内容增改需要放到[development : production]小节下，这样才会使增改的配置信息在开发模式下起作用。待项目开发完成后，再把上述增改内容移回到发布（即产品）模式，即从[development : production]小节下移回到[productio]小节下。最后还需要把index.php下的代码由development改回production即可。

  9.配置数据库信息(命令格式：zf configure db-adapter)

zf configure db-adapter "adapter=PDO_MYSQL&host=localhost&username=root&password=root&dbname=Appdes_db&charset=utf8" development;

    参数说明：

    ▲ adapter：连接数据库的 适配器

    ▲ host：数据库所在的服务器地址，如本机为localhost

    ▲ username：登录数据库的用户名

    ▲ password：登录数据库的密码

    ▲ dbname：数据库名称

    ▲ charset：数据库编码，如utf-8

    经过上述对数据库的设置之后，你会发现在application/configs/application.ini文件的development小节中，相关的数据库信息已经配置好了（如果上述命令的末尾是production，则数据库的信息会配置在production小节中）。

    当然，也可以通过直接修改application/configs/application.ini文件来直接配置数据库信息而不需使用zf configure db-adapter命令。

    需要注意的是：上图高亮的两行配置信息需要手动输入，靠 zf configure db-adapter命令无法设置。resources.db.isDefaultTableAdapter = TRUE 指定本适配器为项目的默认数据库适配器，如果在项目中使用多个数据库，则调用 DefaultTableAdapter 就能方便的使用指定的这个数据库（这里是Appdes_db数据库）；resources.db.params.driver_options.1002 = "SET NAMES UTF8;"限定了数据在页面、表单间的输入输出都以utf8编码方式进行，如果这里添加了这条设置，那么在你项目的所有页面都要设置成utf8的编码方式，否则会因为编码不一致而出现乱码。

  10.有关更多的zf命令语法请参考如下清单，也可通过在终端命令行模式下执行zf命令来获取

Zend Framework Command Line Console Tool v1.12.3Usage:    zf [--global-opts] action-name [--action-opts] provider-name [--provider-opts] [provider parameters ...]    Note: You may use "?" in any place of the above usage string to ask for more specific help information.    Example: "zf ? version" will list all available actions for the version provider.Providers and their actions:  Version    zf show version mode[=mini] name-included[=1]    Note: There are specialties, use zf show version.? to get specific help on them.  Config    zf create config    zf show config    zf enable config    Note: There are specialties, use zf enable config.? to get specific help on them.    zf disable config    Note: There are specialties, use zf disable config.? to get specific help on them.  Phpinfo    zf show phpinfo  Manifest    zf show manifest  Profile    zf show profile  Project    zf create project path name-of-profile file-of-profile    zf show project    Note: There are specialties, use zf show project.? to get specific help on them.  Application    zf change application.class-name-prefix class-name-prefix  Model    zf create model name module  View    zf create view controller-name action-name-or-simple-name module  Controller    zf create controller name index-action-included[=1] module  Action    zf create action name controller-name[=Index] view-included[=1] module  Module    zf create module name  Form    zf enable form module    zf create form name module  Layout    zf enable layout    zf disable layout  DbAdapter    zf configure db-adapter dsn section-name[=production]  DbTable    zf create db-table name actual-table-name module force-overwrite    Note: There are specialties, use zf create db-table.? to get specific help on them.  ProjectProvider    zf create project-provider name actions