3.2 DoitPHP Tools使用说明

DoitPHP Tools 是DoitPHP脚手架(文件布局结构生成器),通过页面操作可以快速生成DoitPHP项目的控制器(Controller)文件、模型(Model)文件、挂件(Widget)文件、扩展模块(Extension)文件等。

DoitPHP Tools安装

DoitPHP Tools只适用于开发环境,所以自DoitPHP V3.1之后,DoitPHP Tools已集成在DoitPHP源码包里,无需进行安装, 访问DoitPHP Tools入口文件,登陆即可。 只是在生产环境(线上服务器)部署项目代码时,需要将DoitPHP Tools目录删除掉

1、配置数据库连接参数

打开配置文件:/tools/application/config/application.php(第71行)

//设置当前项目的数据库连接参数
/*$config['database'] = array(
'dsn' => 'mysql:host=localhost;dbname=yourDbname',
'username' => 'yourUsername',
'password' => 'yourPassword',
'prefix' => '',
'charset' => 'utf8',
);*/

将注释符去掉,参数设置为开发环境DoitPHP当前项目的数据库连接参数。因为创建DoitPHP项目的Model文件时,涉及到数据表的字段信息。若所要生成的Model文件根本就没有数据库操作(或数据库根本就不是MySql这样的关系数据库,而是MongoDb之类的nosql数据库),则无需对数据库连接参数进行配置。

2、管理员登陆密码设置

默认管理员登陆用户名:doitphp, 默认密码:123456。若想更改操作如下:

//设置登陆用户及密码
$config['adminLogin'] = array(
'username'=>'doitphp',
'password'=>123456,
);

接下来的操作,你懂得。

注:最后再次重申一下,DoitPHP Tools仅只是在开发环境下运行的。切不可将tools目录里的代码传到线上服务器上啊!整不好后果很严重的。

使用操作

1、登陆

默认用户名:doitphp, 默认密码:123456。

2、查看开发环境信息

登陆后,首页显示开发环境信息,若开发环境有不符DoitPHP运行的,则会以红色字显示错误信息。

3、文件管理

DoitPHP项目文件及目录,一览无余。点application,看下应用目录里面的文件。通过页面操作则可以对项目目录及文件进行增加,删除。看下里面的controllers, models,这些目录。这两个目录其文件列表上,有“上传文件”,“创建Controller文件”,"创建Model文件"等。

4、创建Controller文件

点击主菜单“Controller管理”,进入创建Controller文件页面,也可以在“文件管理”中的controllers目录列表页,点击“创建Controller文件”进入创建Controller文件页面。

如上图所示:附加信息则是controller文件头的代码注释信息。

Controller名称表单中输入所要创建的controller文件名。如:demo,则生成文件DemoController.php。如:输入admin_demo则在控制器目录(controllers)子目录admin里生成DemoController.php,类名为:Admin_demoController。通过上一篇讲述DoitPHP开发规则的内容,可以知道控制器文件名中出现下划线,是使用controllers子目录。Controller 名称表单中无论输入大写字母(不符合开发规则),在生成文件时,程序会自动转换为小写字母。

视图目录、视图文件,关于这两个选项,如果所要生成的控制器文件,需要使用视图文件,则勾选视图目录,视图文件(视图目录必须勾选,视图文件如果须要则勾选,反之则不勾选)。

添加Action:就是生成带Action行为标签的类方法。描述则为这个Action类方法的代码注释说明.操作完毕后,可以对添加的信息进行编辑和删除。

添加Method:就是生成没有Action行为标签的类方法。

Method名称,则不难理解。描述和。返回数据类型则注类方法的注释说明,访问权限即:public function methodName(){}中的public这样的权限修饰符。当添加method后,可以对其进行编辑,删除操作。此类方法是支持参数调用的。点击“添加参数”进行参数添加。如下图:

当所要生成的控制器(Controller)文件的结构信息都设置好后,则可以点击下方的“创建Controller文件”,来生成文件了。生成后,打开controllers目录,使用编辑器打开生成的文件。开发过程中只需对其进行“填空”就可以了。

5、创建Model文件

通过Model管理或models目录文件列表的“创建Model文件”进入创建Model文件操作页面。同上面创建Controller文件操作相似。

如果doitphp tools配置文件中设置了当前项目的数据库连接参数时,则可以勾选“绑定数据表”,则可以通过右侧下拉菜单选择所要绑定的数据表。

对于添加method操作,参考上面的内容。

6、创建Widget文件

通过widgets目录上面“创建Widget文件”如上图,进行创建Widget文件操作页面。

与上面创建Cotroller文件操作相同,视图文件同上面创建Controller文件的视图目录操作相同。

对于创建library目录中的类文件,以及extensions目录的扩展模块文件,操作原理同上面内容相同。具体操作请参考上文内容。