DoitPHP Tools使用说明

DoitPHP Tools使用说明

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

DoitPHP Tools安装

DoitPHP Tools只适用于开发环境，所以自DoitPHP V2.0之后，DoitPHP Tools不在集成在DoitPHP压缩包里，还是单独发行。所以需要单独下载DoitPHP Tools代码进行安装。

安装方法极为简单：下载DoitPHP Tools，将代码放置于DoitPHP项目根目录下。访问DoitPHP Tools入口文件，登陆即可。有以下几种特殊情况下使用DoitPHP Tools需要更改下配置文件。(1)、DoitPHP Tools的目录不在DoitPHP项目目录的根目录中。(2)、开发环境的web服务器软件为Nginx。

配置

若你的开发环境web服务器软件为Nginx，这时使用前面讲的安装方法不太奏效。需要将DoitPHP Tools作为一个独立程序(配置Nginx虚拟主机)。通过虚拟主机访问操作DoitPHP Tools。若你不想这么麻烦，若你的开发环境为Windows操作系统，建议web服务器使用Apache。更简单一点直接本地安装Apache+PHP+Mysql集成环境软件(本站推荐VertrigoSer)。

1、设置文件路径

打开DoitPHP Tools的入口文件index.php，你会看到如下代码(第21行开始)

/**
 * 自定义DoitPHP框架目录文件所在路径。注：结尾无需"/"。
 */
define('DOITPHP_PATH', APP_ROOT . '/../doitphp');
 
/**
 * 自定义所要创建及管理项目(project)的目录路径。注：结尾无需"/"。
 */
define('WEB_APP_PATH', substr(APP_ROOT, 0, -6));

将DOITPHP_PATH、WEB_APP_PATH更改为实际的目录路径。通过自定义这两个常量的设置，DoitPHP Tools的目录可以放置在任何一个web服务器可以访问的路径下。

2、配置数据库连接参数

打开配置文件：application/config/application.php（第30行)

//设置数据库连接参数
/*$config['db'] = array(
    'dsn'      => 'mysql:host=localhost;dbname=yourDbname',
    'username' => 'yourUserName',
    'password' => 'yourPassword',
    'charset'  => 'utf8',
    'prefix'   => '',
);*/

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

3、管理员登陆密码设置

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

打开配置文件：application/config/application.php (第18行)

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

接下来的操作，你懂得。

注：最后再重申一下，DoitPHP Tools仅只是在开发环境下运行的。切不可将代码传到线上服务器上啊！后果很严重。原因自己想去吧。

使用操作

1、登陆

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

2、查看开发环境信息

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

3、文件管理

略过Controller管理和Model管理，先来看下文件管理。如下图

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

DoitPHP Tools自V2.0以来，则将创建文件的按钮放在了各目录列表页上。主菜单的“Controller管理”，“Model管理”则都是间接调用的。

4、创建Controller文件

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

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

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

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