DolphinPHP(海豚PHP)实战教程

DolphinPHP海豚PHP实战教程

  • DolphinPHP(海豚PHP)实战教程
    • 数据表准备
    • 新建员工模块
    • 为`员工`添加控制器
    • 修改界面展示
    • 设置新增功能
    • 为员工列表添加操作

DolphinPHP(海豚PHP)实战教程

DolphinPHP实战,开发一个简单的员工管理系统.

数据表准备

主要有emp_employee员工表,emp_status_info员工状态表,emp_dept员工部门表,emp_position员工职位表,员工地址表:


create table emp_employee(
    id int(10) primary key auto_increment,
    name varchar(10) comment '姓名',
    age int(2) comment '年龄',
    phone varchar(30) not null comment '电话',
    salary decimal not null comment '工资',
    p_id int(10) not null comment '领导id',
    position_id int(10) not null comment '职位id',
    addr_id int(10) not null comment '地址id',
    status_id int(10) not null comment '员工当前状态id',
    join_in_time datetime not null comment '入职时间',
    leave_out_time datetime comment '离职时间',
    create_time datetime,
    update_time datetime
);

create table emp_status_info(
    id int(10) primary key auto_increment,
    status int(1) not null comment '员工当前状态 -1离职 0正常 1请假 2调休',
    reason text comment '事由',
    begin_time datetime comment '开始时间',
    end_time datetime comment '结束时间',
    create_time datetime,
    update_time datetime
);

create table emp_dept (
    id int(10) primary key auto_increment,
    name varchar(30) not null comment '部门名称',
    manger_id int(10) comment '部门主管id',
    create_time datetime,
    update_time datetime
);

create table emp_position(
    id int(10) primary key auto_increment,
    name varchar(30) not null comment '职位名称',
    dept_id int(10) not null comment '所属部门',
    create_time datetime,
    update_time datetime
);

create table emp_addr(
    id int(10) primary key auto_increment,
    street varchar(50) comment '街道',
    number int(6) comment '门牌编号',
    province varchar(50) comment '省',
    city varchar(50) comment '市',
    create_time datetime,
    update_time datetime
);

向数据库中插入数据:

-- emp_employee
INSERT INTO dolphin.emp_employee (id, name, age, phone, salary, p_id, position_id, addr_id, status_id, join_in_time, leave_out_time, create_time, update_time) VALUES (1, '张三', 18, '13232323232', 8000, 0, 1, 1, 0, '2019-07-18 06:39:28', null, '2019-07-18 06:39:40', '2019-07-18 06:39:45');
INSERT INTO dolphin.emp_employee (id, name, age, phone, salary, p_id, position_id, addr_id, status_id, join_in_time, leave_out_time, create_time, update_time) VALUES (2, '李四', 20, '13443433333', 9000, 0, 2, 2, 0, '2019-07-18 06:41:22', null, '2019-07-18 06:41:25', '2019-07-18 06:41:26');
INSERT INTO dolphin.emp_employee (id, name, age, phone, salary, p_id, position_id, addr_id, status_id, join_in_time, leave_out_time, create_time, update_time) VALUES (3, '王五', 18, '13232323232', 8000, 0, 3, 3, 0, '2019-07-18 06:39:28', null, '2019-07-18 06:39:40', '2019-07-18 06:39:45');

-- emp_dept
INSERT INTO dolphin.emp_dept (id, name, manger_id, create_time, update_time) VALUES (1, '技术部', 0, '2019-07-18 06:50:13', '2019-07-18 06:50:16');
INSERT INTO dolphin.emp_dept (id, name, manger_id, create_time, update_time) VALUES (2, '财物部', 0, '2019-07-18 06:50:41', '2019-07-18 06:50:43');
INSERT INTO dolphin.emp_dept (id, name, manger_id, create_time, update_time) VALUES (3, '市场部', 0, '2019-07-18 06:51:09', '2019-07-18 06:51:15');
INSERT INTO dolphin.emp_dept (id, name, manger_id, create_time, update_time) VALUES (4, '运营部', 0, '2019-07-18 06:51:28', '2019-07-18 06:51:30');

-- emp_position
INSERT INTO dolphin.emp_position (id, name, dept_id, create_time, update_time) VALUES (1, 'Java开发工程师', 1, '2019-07-18 06:53:16', '2019-07-18 06:53:17');
INSERT INTO dolphin.emp_position (id, name, dept_id, create_time, update_time) VALUES (2, '前端开发工程师', 1, '2019-07-18 06:53:47', '2019-07-18 06:53:50');
INSERT INTO dolphin.emp_position (id, name, dept_id, create_time, update_time) VALUES (3, 'PHP开发工程师', 1, '2019-07-18 06:54:18', '2019-07-18 06:54:20');
INSERT INTO dolphin.emp_position (id, name, dept_id, create_time, update_time) VALUES (4, 'Golang开发工程师', 1, '2019-07-18 06:54:55', '2019-07-18 06:54:56');

-- emp_addr
INSERT INTO dolphin.emp_addr (id, street, number, province, city, create_time, update_time) VALUES (1, '西乡街道', 1002, '广东', '深圳', '2019-07-18 06:56:47', '2019-07-18 06:56:49');
INSERT INTO dolphin.emp_addr (id, street, number, province, city, create_time, update_time) VALUES (2, '宝安大道', 2004, '广东', '深圳', '2019-07-18 06:57:36', '2019-07-18 06:57:37');
INSERT INTO dolphin.emp_addr (id, street, number, province, city, create_time, update_time) VALUES (3, '南山大道', 2012, '广东', '深圳', '2019-07-18 06:59:38', '2019-07-18 06:59:40');

新建员工模块

application目录下新建一个employee目录,并在employee目录下新建一个info.php文件:



/**
 * 员工表模块信息
 */

return [
    // 模块名[必填]
    'name'        => 'employee',
    // 模块标题[必填]
    'title'       => '员工',
    // 模块唯一标识[必填],格式:模块名.开发者标识.module
    'identifier'  => 'emp.xx.module',
    // 开发者[必填]
    'author'      => 'xxx',
    // 版本[必填],格式采用三段式:主版本号.次版本号.修订版本号
    'version'     => '1.0.0',
    // 模块描述[必填] 
	'description' => '员工模块',
];

我们进入系统->扩展中心->模块管理中可以查看到当前的模块信息:DolphinPHP(海豚PHP)实战教程_第1张图片
我样可以通过点击安装来安装当前模块.
安装完模块后,我们要让模块展示出来,类似其他模块一样:
在这里插入图片描述
我们要通过系统->系统功能->节点管理->新增来添加节点:
DolphinPHP(海豚PHP)实战教程_第2张图片
然后在新增界面添加如下信息,并提交:
DolphinPHP(海豚PHP)实战教程_第3张图片
待页面刷新后我们就可以看到刚才添加的节点信息了:
在这里插入图片描述
如果此时点击它会提示无任何节权限
接下来我们要做的就是为当前节点添加子节点,以同样的方式来到新增节点的页面,并填写这样如下的节点信息,并提交:
DolphinPHP(海豚PHP)实战教程_第4张图片
添加完成后我们再点击员工,会看到如下信息:
DolphinPHP(海豚PHP)实战教程_第5张图片

员工添加控制器

employee目录下新建一个admin目录,并在admin目录下新建一个Index.php,注意这里I是大写的.并在Index.php下面输入以下内容:



namespace app\employee\admin;

use app\admin\controller\Admin;

class Index extends Admin {
    public function index() {
        dump('员工列表');
    }
}

此时,我们再点员工就会看到如下页面:
在这里插入图片描述

修改界面展示

我们根据需要,修改员工界面的展示信息,首先我们要知道框架用的是use app\common\builder\ZBuilder;来构建页面信息的.所以我们在构建页面的时候要使用它.



namespace app\employee\admin;

use app\admin\controller\Admin;
use app\common\builder\ZBuilder; // 引入ZBuilder

class Index extends Admin {
    public function index() {
        dump('员工列表');
    }
}

由于当前页面要展示员工信息,所示我们要构建一个表格:



namespace app\employee\admin;

use app\admin\controller\Admin;
use app\common\builder\ZBuilder; // 引入ZBuilder

class Index extends Admin {
    public function index() {
    	// 构建表格展示
        return ZBuilder::make('table')->fetch();
    }
}

我们再次访问可以看到当前页面类似如下(由于没有配置表格信息,所以没有展示出表格来):
DolphinPHP(海豚PHP)实战教程_第6张图片
现在为我们的表格添加表头,我们要展示内容有"数字编号/员工名字/年龄/电话/职位/工资/状态",由于这里只是修改index()方法中的内容,这里只展示index()中的代码:

  public function index() {
        return ZBuilder::make('table')
             ->addColumns([
                 ['__INDEX__', '#'],
                 ['name', '姓名'],
                 ['age', '年龄'],
                 ['phone', '电话'],
                 ['position', '职位'],
                 ['salary', '工资'],
                 ['status', '状态']
             ])
            ->fetch();
    }

['name', '姓名'],其中name就是要传入数据(数组)的key,我们看一下现在的页面:
DolphinPHP(海豚PHP)实战教程_第7张图片
查询数据并展示到表格中,注意这里引用了use think\Db命名空间用于查询数据:

public function index() {
       $join = [
            [['emp_position' => 'p'],'e.position_id = p.id', 'LEFT'],
            [['emp_status_info' =>  's'], 's.id = e.status_id', 'LEFT'],
        ];
        $dataList = Db::field('e.name, e.age, e.phone, p.name position, e.salary, s.status status')
                                -> table('emp_employee')->alias('e')
                                -> join($join)
                                ->select();
       for ($i = 0 ; $i < count($dataList); $i++) {
            foreach($dataList[$i] as $k => $v) {
                if ($k == 'status' && $v== NULL) {
                    $dataList[$i][$k] = '在职';
                }
            }
       }
        return ZBuilder::make('table')
             ->addColumns([
                 ['__INDEX__', '#'],
                 ['name', '姓名'],
                 ['age', '年龄'],
                 ['phone', '电话'],
                 ['position', '职位'],
                 ['salary', '工资'],
                 ['status', '状态']
             ])
             -> setRowList($dataList)
            ->fetch();
    }

修改后的效果:
DolphinPHP(海豚PHP)实战教程_第8张图片
我们看到每一列前都有一个多选框,现在我们将它隐藏:

 public function index() {
       $join = [
            [['emp_position' => 'p'],'e.position_id = p.id', 'LEFT'],
            [['emp_status_info' =>  's'], 's.id = e.status_id', 'LEFT'],
        ];
        $dataList = Db::field('e.name, e.age, e.phone, p.name position, e.salary, s.status status')
                                -> table('emp_employee')->alias('e')
                                -> join($join)
                                ->select();
       for ($i = 0 ; $i < count($dataList); $i++) {
            foreach($dataList[$i] as $k => $v) {
                if ($k == 'status' && $v== NULL) {
                    $dataList[$i][$k] = '在职';
                }
            }
       }
        return ZBuilder::make('table')
             ->addColumns([
                 ['__INDEX__', '#'],
                 ['name', '姓名'],
                 ['age', '年龄'],
                 ['phone', '电话'],
                 ['position', '职位'],
                 ['salary', '工资'],
                 ['status', '状态']
             ])
             -> setRowList($dataList)
             // 隐藏多选框
             ->hideCheckbox()
            ->fetch();
    }

为表头添加排序:

 public function index() {
 	// 获取排序方式
        $order = $this->getOrder();
       $join = [
            [['emp_position' => 'p'],'e.position_id = p.id', 'LEFT'],
            [['emp_status_info' =>  's'], 's.id = e.status_id', 'LEFT'],
        ];
        $dataList = Db::field('e.name, e.age, e.phone, p.name position, e.salary, s.status status')
                                -> table('emp_employee')->alias('e')
                                -> join($join)
                                // 查询时,设置排序方式
                                ->order($order)
                                ->select();
       for ($i = 0 ; $i < count($dataList); $i++) {
            foreach($dataList[$i] as $k => $v) {
                if ($k == 'status' && $v== NULL) {
                    $dataList[$i][$k] = '在职';
                }
            }
       }
        return ZBuilder::make('table')
             ->addColumns([
                 ['__INDEX__', '#'],
                 ['name', '姓名'],
                 ['age', '年龄'],
                 ['phone', '电话'],
                 ['position', '职位'],
                 ['salary', '工资'],
                 ['status', '状态']
             ])
             // 设置要排序的字段
             ->addOrder('name,salary')
             -> setRowList($dataList)
             // 隐藏多选框
             ->hideCheckbox()
            ->fetch();
    }

DolphinPHP(海豚PHP)实战教程_第9张图片

记录:关于添加筛选,表名始终会被加上前缀,未解决!

设置新增功能

为新增页面添加一个节点:
DolphinPHP(海豚PHP)实战教程_第10张图片
在顶部增加一个新增按钮:

public function index() {
        $order = $this->getOrder();
       $join = [
            [['emp_position' => 'p'],'e.position_id = p.id', 'LEFT'],
            [['emp_status_info' =>  's'], 's.id = e.status_id', 'LEFT'],
        ];
        $dataList = Db::field('e.name, e.age, e.phone, p.name position, e.salary, s.status status')
                                -> table('emp_employee')->alias('e')
                                -> join($join)
                                ->order($order)
                                ->select();
       for ($i = 0 ; $i < count($dataList); $i++) {
            foreach($dataList[$i] as $k => $v) {
                if ($k == 'status' && $v== NULL) {
                    $dataList[$i][$k] = '在职';
                }
            }
       }

        return ZBuilder::make('table')
             ->addColumns([
                 ['__INDEX__', '#'],
                 ['name', '姓名'],
                 ['age', '年龄'],
                 ['phone', '电话'],
                 ['position', '职位'],
                 ['salary', '工资'],
                 ['status', '状态']
             ])
             ->addOrder('name,salary')
             -> setRowList($dataList)
             // 隐藏多选框
             ->hideCheckbox()
             // 添加新增按钮,并以弹窗形式打开(第三个参数存在),且设定title
             ->addTopButton('add', [],['title'=>'添加员工'])
            ->fetch();
    }

添加后的效果:
DolphinPHP(海豚PHP)实战教程_第11张图片
添加add方法,构建页面信息:

 public function add() {
        return ZBuilder::make('form')
        ->fetch();
    }

点击添加后会跳到新增页面,效果:
DolphinPHP(海豚PHP)实战教程_第12张图片
为新增界面构建表单:

public function add() {
        $dept = Db::table('emp_dept')->field('id,name')->select();
        $list = [];
        for ($i = 0; $i < count($dept); $i++) {
            $list[$dept[$i]['id']] = $dept[$i]['name'];
      }
        return ZBuilder::make('form')
        // 添加单行文本框,输入姓名,并设置 placeHolder 请输入员工的姓名
        ->addText('name', '姓名[:请输入员工的姓名]', '', '', [''])
        ->addText('age', '年龄[:请输入员工的年龄]', '', '', [''])
        ->addText('phone', '电话[:请输入员工的电话]', '', '', [''])
        ->addLinkage('dept ', '选择部门', '请选择部门', $list, '', url('getPosition'), 'position', 'dept')
        ->addSelect('position', '选择职位')
        ->addText('salary', '工资[:请输入员工的工资]', '', '', [''])
        ->addDatetime('join_in_time', '入职时间','', '', 'YYYY-MM-DD')
        ->fetch();
    }

    public function getPosition($dept = '') {
         $res = Db::query('select p.id, p.name from emp_position p left join emp_dept d on p.dept_id = d.id where d.name = ? ', [$dept]);
         $list = [];
         for ($i = 0; $i < count($res); $i++) {
               array_push($list, ['key' => $res[$i]['id'], 'value' => $res[$i]['name']]);
         }
        $arr['code'] = '1'; //判断状态
        $arr['msg'] = '请求成功'; //回传信息
        $arr['list'] = $list;
        return json($arr);
    }

页面效果:
DolphinPHP(海豚PHP)实战教程_第13张图片
为新增员工添加url请求链接,并创建save方法:

public function add() {
        $dept = Db::table('emp_dept')->field('id,name')->select();
        $list = [];
        for ($i = 0; $i < count($dept); $i++) {
            $list[$dept[$i]['id']] = $dept[$i]['name'];
      }
        return ZBuilder::make('form')
        // 添加单行文本框,输入姓名,并设置 placeHolder 请输入员工的姓名
        ->addText('name', '姓名[:请输入员工的姓名]', '', '', [''])
        ->addText('age', '年龄[:请输入员工的年龄]', '', '', [''])
        ->addText('phone', '电话[:请输入员工的电话]', '', '', [''])
        ->addLinkage('dept ', '选择部门', '请选择部门', $list, '', url('getPosition'), 'position', 'dept')
        ->addSelect('position', '选择职位')
        ->addText('salary', '工资[:请输入员工的工资]', '', '', [''])
        ->addDatetime('join_in_time', '入职时间','', '', 'YYYY-MM-DD')
        // 设置提交地址
        ->setUrl(url('save'))
        ->submitConfirm()
        ->fetch();
    }

    public function save() {
        // 获取请求参数
        $arr['code'] = '1'; //判断状态
        $arr['msg'] = '添加成功'; //回传信息
        $arr['list'] = [];
        return json($arr);
    }

save()方法中获取请求数据并入库:

public function save() {
        $post = request()->post();
        $data = [
            'name' => $post['name'],
            'age' => $post['age'],
            'phone' => $post['phone'],
            'position_id' => $post['position'],
            'salary' => $post['salary'],
            'join_in_time' => $post['join_in_time'],
            // 为not null字段添加默认值
            'status_id' => 0,
            'addr_id' => 0,
            'p_id' => 0
        ];
        $id = Db::table('emp_employee')->insert($data);
        $id = Db::table('emp_employee')->getLastInsID();
        // 获取请求参数
        $arr['code'] = '1'; //判断状态
        $arr['msg'] = '添加成功'; //回传信息
        $arr['data'] = $id;
        return json($arr);
    }

为员工列表添加操作

现在我们要为员工数据每一栏添加操作按钮,先看看没添加时的样子:
DolphinPHP(海豚PHP)实战教程_第14张图片
添加操作代码(由于代码较长,只在新加代码处加了注释),请注意注释处代码:

  public function index() {
        $order = $this->getOrder();
       $join = [
            [['emp_position' => 'p'],'e.position_id = p.id', 'LEFT'],
            [['emp_status_info' =>  's'], 's.id = e.status_id', 'LEFT'],
        ];
        // 添加 e.id  为数据指定id,否则报错
        $dataList = Db::field('e.id, e.name, e.age, e.phone, p.name position, e.salary, s.status status')
                                -> table('emp_employee')->alias('e')
                                -> join($join)
                                ->order($order)
                                ->select();
       for ($i = 0 ; $i < count($dataList); $i++) {
            foreach($dataList[$i] as $k => $v) {
                if ($k == 'status' && $v== NULL) {
                    $dataList[$i][$k] = '在职';
                }
            }
       }

        return ZBuilder::make('table')
             ->addColumns([
                 ['__INDEX__', '#'],
                 ['name', '姓名'],
                 ['age', '年龄'],
                 ['phone', '电话'],
                 ['position', '职位'],
                 ['salary', '工资'],
                 ['status', '状态']
             ])
             ->addOrder('name,salary')
             -> setRowList($dataList)
             // 添加操作 表头
             ->addColumn('right_button', '操作', 'btn')
             // 添加edit操作按钮
            ->addRightButton('edit', ['href' => url('edit', ['id' => '__id__', 'group' => 'normal'])])
             // 隐藏多选框
             ->hideCheckbox()
             ->addTopButton('add', [],['title'=>'添加员工'])
            ->fetch();
    }

添加操作按钮后,我们的页面长这样子:DolphinPHP(海豚PHP)实战教程_第15张图片
注意->addRightButton('edit', ['href' => url('edit', ['id' => '__id__', 'group' => 'normal'])])我们在指定编辑按钮时已经设置了跳转的url:**/模块名/edit/id/1/group/normal.html.所以,我们应该添加一个edit方法和配置一个修改员工的节点!
配置节点:
DolphinPHP(海豚PHP)实战教程_第16张图片
添加edit方法:

public function edit($id = '') {
        dump('edit');
    }

上诉操作完成后,点击编辑按钮就可以跳到如下页面:
在这里插入图片描述
此时,我们应该为编辑页面创建布局,编辑页面主要是用来更改员工状态的,比如请假/调休/高职等操作,所以我们在edit中添加如下代码:

public function edit($id = '', $group = 'normal') {

        // tab 信息 
        $tabInfo = [
            // edit 表示页面跳转的方法, group 是参数 normal是参数值 ,也就是每次点击都会跳到edit方法,并且传递group参数 
            'normal' => ['title' => '正常工作',  'url' => url('edit', ['group' => 'normal'])],
            'qj' => ['title' => '请假',  'url' => url('edit', ['group' => 'qj'])],
            'tx' => ['title' => '调休',  'url' => url('edit', ['group' => 'tx'])],
            'lz' => ['title' => '离职',  'url' => url('edit', ['group' => 'lz'])],
        ];

        // 状态单选按钮信息
        $radioInfo = [
            0 => '事假',
            1 => '病假',
            2 => '其它'
        ];
        // 是否开启开关
        $isOpen = 1;
        $canOpt = '';
        // 如果
        if ($isOpen == 1) {
            $canOpt = 'disabled';
        }
        //  根据不同的group参数 构建不同的form表单
        switch ($group) {
            case 'normal' :
                return ZBuilder::make('form')
                    // 构建tab
                    ->setTabNav($tabInfo,  $group)
                    // 添加单选按钮, 最后一个参数是默认选中值
                    ->addSwitch('status', '修改员工状态为正常', '', $isOpen, '', $canOpt)
                    ->fetch();
                // 请假表单样式
                case 'qj' :
                    return ZBuilder::make('form')
                    ->setTabNav($tabInfo,  $group)
                    ->addRadio('type', '请假类型', '', $radioInfo, '0')
                    ->addDaterange('begin,end', '请假时间', '', date("Y-m-d",time()))
                    ->fetch();
                    // 调休表单样式
                case 'tx' :
                    return ZBuilder::make('form')
                    ->setTabNav($tabInfo,  $group)
                    ->addDaterange('begin,end', '调休时间', '', date("Y-m-d",time()))
                    ->fetch();
                    // 离职表单样式
                case 'lz' :
                    return ZBuilder::make('form')
                    ->setTabNav($tabInfo,  $group)
                    ->addDatetime('leave_time', '离职时间', '', date("Y-m-d H:i",time()))
                    ->addTextarea('reason', '离职原因')
                    ->fetch();
        }
      
    }

添加后的样式如下:
DolphinPHP(海豚PHP)实战教程_第17张图片

你可能感兴趣的:(php)