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' => '员工模块',

];

我们进入系统->扩展中心->模块管理中可以查看到当前的模块信息： 我样可以通过点击安装来安装当前模块． 安装完模块后，我们要让模块展示出来，类似其他模块一样： 我们要通过系统->系统功能->节点管理->新增来添加节点： 然后在新增界面添加如下信息，并提交： 待页面刷新后我们就可以看到刚才添加的节点信息了： 如果此时点击它会提示无任何节权限． 接下来我们要做的就是为当前节点添加子节点，以同样的方式来到新增节点的页面，并填写这样如下的节点信息，并提交： 添加完成后我们再点击员工，会看到如下信息：

为员工添加控制器

在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();

}

}

我们再次访问可以看到当前页面类似如下（由于没有配置表格信息，所以没有展示出表格来）： 现在为我们的表格添加表头，我们要展示内容有＂数字编号／员工名字／年龄／电话／职位／工资／状态＂，由于这里只是修改index()方法中的内容，这里只展示index()中的代码：

public function index() {

return ZBuilder::make('table')

->addColumns([

['__INDEX__', '#'],

['name', '姓名'],

['age', '年龄'],

['phone', '电话'],

['position', '职位'],

['salary', '工资'],

['status', '状态']

])

->fetch();

}

['name', '姓名'],其中name就是要传入数据(数组)的key，我们看一下现在的页面： 查询数据并展示到表格中，注意这里引用了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();

}

修改后的效果： 我们看到每一列前都有一个多选框，现在我们将它隐藏：

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();

}

记录：关于添加筛选，表名始终会被加上前缀，未解决！

设置新增功能

为新增页面添加一个节点： 在顶部增加一个新增按钮：

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();

}

添加后的效果： 添加add方法，构建页面信息：

public function add() {

return ZBuilder::make('form')

->fetch();

}

点击添加后会跳到新增页面，效果： 为新增界面构建表单：

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);

}

页面效果： 为新增员工添加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);

}

为员工列表添加操作

现在我们要为员工数据每一栏添加操作按钮，先看看没添加时的样子： 添加操作代码（由于代码较长，只在新加代码处加了注释）,请注意注释处代码：

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 为数据指定ｉｄ，否则报错

$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();

}

添加操作按钮后，我们的页面长这样子： 注意->addRightButton('edit', ['href' => url('edit', ['id' => '__id__', 'group' => 'normal'])])我们在指定编辑按钮时已经设置了跳转的url：**/模块名/edit/id/1/group/normal.html．所以，我们应该添加一个edit方法和配置一个修改员工的节点！ 配置节点： 添加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();

}

}

添加后的样式如下：