[Laravel] 07 - Project: functions in Controller

故事背景

一、项目预览

表单操作

一、新增信息

既然是操作，自然会想到：控制器。

控制器

[1] 路由 ----> 函数 create( )

Route::group(['middleware' => ['web']], function () {

    Route::get('student/index',       ['uses' => 'StudentController@index']);

    Route::any('student/create',      ['uses' => 'StudentController@create']);

    Route::any('student/save',        ['uses' => 'StudentController@save']);

    Route::any('student/update/{id}', ['uses' => 'StudentController@update']);

    Route::any('student/detail/{id}', ['uses' => 'StudentController@detail']);

    Route::any('student/delete/{id}', ['uses' => 'StudentController@delete']);

});

[app/Http/StudentController.php]

    // 添加页面

    public function create(Request $request)

    {

        $student = new Student();

        if ($request->isMethod('POST')) {


            -----------------------------------------------------------------------

            // 1. 控制器验证

            // 2. Validator类验证
            ------------------------------------------------------------------------

            $data = $request->input('Student');

            if (Student::create($data) ) {

                return redirect('student/index')->with('success', '添加成功!');

            } else {

                return redirect()->back();

            }

        }

        return view('student.create', [

            'student' => $student

        ]);

    }

[2] 函数 create( ) return --> 视图

表单提交

以上只是打开create页面，这里才是submit。

   // 保存添加

    public function save(Request $request)

    {

        $data = $request->input('Student');

        $student = new Student();

        $student->name = $data['name'];

        $student->age  = $data['age'];

        $student->sex  = $data['sex'];

        if ($student->save()) {

            return redirect('student/index');　　// 路由重定向

        } else {

            return redirect()->back();　　　　　　// 返回上一个请求页面

        }

    }

[1] Submit 表单内容提交的过程是怎样的？

Goto: [PHP] 03 - Form & Input

[2] 也可以默认将逻辑写在save中，也即是action中采用默认形式（设置为空字符串）

提交结果

[1] 表单空内容提交，可采用“中间件”方法解决，便不会直接报系统错误。

[2] tokenMIsMatchException错误的解决方案：

<form class="form-horizontal" method="post" action="">

    {{ csrf_field() }}　　该字段：生成了隐藏的input表单，自带token字段

    <div class="form-group">

        <label for="name" class="col-sm-2 control-label">姓名</label>

        <div class="col-sm-5">

            <input type="text" name="Student[name]"

                   value="{{ old('Student')['name'] ? old('Student')['name'] : $student->name }}"

                   class="form-control" id="name" placeholder="请输入学生姓名">

        </div>

        <div class="col-sm-5">

            <p class="form-control-static text-danger">{{ $errors->first('Student.name') }}</p>

        </div>

    </div>

    <div class="form-group">

        <label for="age" class="col-sm-2 control-label">年龄</label>

        <div class="col-sm-5">

            <input type="text" name="Student[age]"

                   value="{{ old('Student')['age'] ?  old('Student')['age'] : $student->age }}"

                   class="form-control" id="age" placeholder="请输入学生年龄">

        </div>

        <div class="col-sm-5">

            <p class="form-control-static text-danger">{{ $errors->first('Student.age') }}</p>

        </div>

    </div>

    <div class="form-group">

        <label class="col-sm-2 control-label">性别</label>

        <div class="col-sm-5">

            @foreach($student->sex() as $ind=>$val)

                <label class="radio-inline">

                    <input type="radio" name="Student[sex]"

                           {{ isset($student->sex) && $student->sex == $ind ? 'checked' : ''  }}

                           value="{{ $ind }}"> {{ $val }}

                </label>

            @endforeach

        </div>

        <div class="col-sm-5">

            <p class="form-control-static text-danger">{{ $errors->first('Student.sex') }}</p>

        </div>

    </div>

    <div class="form-group">

        <div class="col-sm-offset-2 col-sm-10">

            <button type="submit" class="btn btn-primary">提交</button>

        </div>

    </div>

</form>

[3] 判断Session中的参数来控制UI片段的显示。

<!-- 成功提示框 -->

@if (Session::has('success'))

<div class="alert alert-success alert-dismissible" role="alert">

    <button type="button" class="close" data-dismiss="alert" aria-label="Close">

        <span aria-hidden="true">&times;</span>

    </button>

    <strong>成功!</strong> {{ Session::get('success') }}

</div>

@endif

<!-- 失败提示框 -->

@if (Session::has('error'))

<div class="alert alert-danger alert-dismissible" role="alert">

    <button type="button" class="close" data-dismiss="alert" aria-label="Close">

        <span aria-hidden="true">&times;</span>

    </button>

    <strong>失败!</strong> {{ Session::get('error') }}

</div>

@endif

二、数据验证

出错提示视图

[1] 获取$error变量后，循环打印出。

@if (count($errors))

    <div class="alert alert-danger">

        <ul>

            <li>{{ $errors->first() }}</li>

        </ul>

    </div>

    <div class="alert alert-danger">

        <ul>

            @foreach($errors->all() as $error)

            <li>{{ $error }}</li>

            @endforeach

        </ul>

    </div>

@endif

[2] 视图效果如下。

[3] 那么，$error 从哪里来？

通过中间件将出错信息绑定到所有的视图中，视图中可直接获取。

控制器验证法

Ref: https://www.imooc.com/video/12522

            // 1. 控制器验证

            $this->validate($request, [

                'Student.name' => 'required|min:2|max:20',

                'Student.age'  => 'required|integer',

                'Student.sex'  => 'required|integer',

            ], [

                'required'     => ':attribute 为必填项',

                'min'          => ':attribute 长度不符合要求',

                'integer'      => ':attribute 必须为整数',

            ], [

                'Student.name' => '姓名',

                'Student.age'  => '年龄',

                'Student.sex'  => '性别',

            ]);

[1] $this：当前控制器；validate验证方法；

[2] 如下提示不够友好，需要替换下内容；

[3] 中间件的效果

如果没有验证通过，中间件ShareErrorsFromSession开始发挥作用：

(1) 框架会抛出一个异常；

(2) 异常被自动捕获，重定向到上一个页面；

(3) 错误信息被存在session中，且绑定到视图上；

所以，返回的“上一个页面"就可以直接在视图中获得出错信息 by $error变量。

    /**

     * The application's route middleware groups.

     *

     * @var array

     */

    protected $middlewareGroups = [

        'web' => [

            \App\Http\Middleware\EncryptCookies::class,

            \Illuminate\Cookie\Middleware\AddQueuedCookiesToResponse::class,

            \Illuminate\Session\Middleware\StartSession::class,\Illuminate\View\Middleware\ShareErrorsFromSession::class,

            \App\Http\Middleware\VerifyCsrfToken::class,

        ],

        'api' => [

            'throttle:60,1',

        ],

    ];

Validator类验证法

\Validator全局的。

            // 2. Validator类验证

            $validator = \Validator::make($request->input(), [

                'Student.name' => 'required|min:2|max:20',

                'Student.age'  => 'required|integer',

                'Student.sex'  => 'required|integer',

            ], [

                'required'     => ':attribute 为必填项',

                'min'          => ':attribute 长度不符合要求',

                'integer'      => ':attribute 必须为整数',

            ], [

                'Student.name' => '姓名',

                'Student.age'  => '年龄',

                'Student.sex'  => '性别',

            ]);

            if ($validator->fails()) {

                return redirect()->back()->withErrors($validator)->withInput();

            }

数据保持

[1] 点击提交后，如果执行失败，注册的信息保留住，方便查看到底错在了哪里。

在返回上一个页面的同时并填充原始的信息（$request）。

if ($validator->fails()) {

　　return redirect()->back()->withErrors($validator)->withInput();

}

[2] 对应地，使用如下old方法来提取withInput()中保存的数据。

　　<div class="form-group">

        <label for="name" class="col-sm-2 control-label">姓名</label>

        <div class="col-sm-5">

            <input type="text" name="Student[name]"

                   value="{{ old('Student')['name'] ? old('Student')['name'] : $student->name }}"

                   class="form-control" id="name" placeholder="请输入学生姓名">

        </div>

        <div class="col-sm-5">

            <p class="form-control-static text-danger">{{ $errors->first('Student.name') }}</p>

        </div>

    </div>

三、通过模型处理性别

模型中的性别属性

问题，导致数据库中存储数据的形式是数字。其实这也并非是"大问题”。

Self 与 This

在访问PHP类中的成员变量或方法时，如果被引用的变量或者方法被声明成const（定义常量）或者static（声明静态），那么就必须使用操作符::,

反之如果被引用的变量或者方法没有被声明成const或者static，那么就必须使用操作符->。

一句话，self是引用静态类的类名，而$this是引用非静态类的实例名。

Model中增加属性

性别属性其实是枚举类属性的一个典型例子，在此作为典型案例进行分析。

希望：只修改这里，相应的部分都能自动改变。

    public function sex($ind = null)

    {

        $arr = [

            self::SEX_UN   => '未知',

            self::SEX_BOY  => '男',

            self::SEX_GRIL => '女',

        ];

        if ($ind !== null) {

            return array_key_exists($ind, $arr) ? $arr[$ind] : $arr[self::SEX_UN];

        }

        return $arr;

    }

’学生列表‘View中获取属性

学生列表中做出调整。

<tbody>

　　@foreach($students as $student)

　　<tr>

　　　　<th scope="row">{{ $student->id }}</th>

　　　　<td>{{ $student->name }}</td>

　　　　<td>{{ $student->age }}</td>

　　　　<td>{{ $student->sex($student->sex) }}</td>　　# 这里提取到的就是字符串了

　　　　<td>{{ date('Y-m-d', $student->created_at) }}</td>

　　　　<td>

　　　　　　<a href="{{ url('student/detail', ['id' => $student->id]) }}">详情</a>

　　　　　　<a href="{{ url('student/update', ['id' => $student->id]) }}">修改</a>

　　　　　　<a href="{{ url('student/delete', ['id' => $student->id]) }}"

　　　　　　　　onclick="if (confirm('确定要删除吗？') == false) return false;">删除</a>

　　　　</td>

　　</tr>

　　@endforeach

</tbody>

'创建'View中获取属性

Create界面原始写法，就是一组 radio button。

取出student中的key和value：as $ind => $val

四、修改表单

Ref: https://www.imooc.com/video/12524

我们的思路是：尽量利用“添加表单”的逻辑和页面。

添加链接

<tbody>

　　@foreach($students as $student)

　　<tr>

                    <th scope="row">{{ $student->id }}</th>

                    <td>{{ $student->name }}</td>

                    <td>{{ $student->age }}</td>

                    <td>{{ $student->sex($student->sex) }}</td>

                    <td>{{ date('Y-m-d', $student->created_at) }}</td>

                    <td>

                        <a href="{{ url('student/detail', ['id' => $student->id]) }}">详情</a>

                        <a href="{{ url('student/update', ['id' => $student->id]) }}">修改</a>

                        <a href="{{ url('student/delete', ['id' => $student->id]) }}"

                                onclick="if (confirm('确定要删除吗？') == false) return false;">删除</a>

                    </td>

　　</tr>

　　@endforeach

</tbody>

修改页面

[1] 控制器 ----> “页面”，获得了模型的数据：$student

　　 public function update(Request $request, $id)

    {
        # 先获得表单

        $student = Student::find($id);

        if ($request->isMethod('POST')) {　　// 来自client的POST，携带了“edit”信息

            $this->validate($request, [

                'Student.name' => 'required|min:2|max:20',

                'Student.age'  => 'required|integer',

                'Student.sex'  => 'required|integer',

            ], [

                'required'     => ':attribute 为必填项',

                'min'          => ':attribute 长度不符合要求',

                'integer'      => ':attribute 必须为整数',

            ], [

                'Student.name' => '姓名',

                'Student.age'  => '年龄',

                'Student.sex'  => '性别',

            ]);


            # 这里获得了数据，有待”视图“去使用$student

            $data = $request->input('Student');

            $student->name = $data['name'];

            $student->age  = $data['age'];

            $student->sex  = $data['sex'];

            if ($student->save()) {

                return redirect('student/index')->with('success', '修改成功-' . $id);

            }

        }

        return view('student.update', [

            'student' => $student

        ]);

    }

Ref：laravel的$request->input()和$request->get()有什么区别？

Ref：Laravel 5 $request->input vs Input::get

走的流程不同
input获取数据的流程是把post过来的数据与URL里的Query合并，然后用helper里的data_get方法去取数据

/* implement */

[2] “页面”部分

old代表"最新的数据“，如果是edit，也就没有”最新数据“这么一说，old里就为空。那么就从模型student中取数据。

value="{{ old('Student')['name'] ? old('Student')['name'] : $student->name }}"

以上代码依次在age，gender等其他属性处做相应的调整。

[gender]

<div class="col-sm-5">

　　@foreach($student->sex() as $ind=>$val)

　　<label class="radio-inline">

　　　　<input type="radio" name="Student[sex]"

　　　　　　{{ isset($student->sex) && $student->sex == $ind ? 'checked' : ''  }}　　// 遍历了各个枚举，然后选中额加个checked。

　　　　　　value="{{ $ind }}"> {{ $val }}

　　</label>

　　@endforeach

</div>

五、详情查看

控制器

public function detail($id)

{

　　$student = Student::find($id);

　　return view('student.detail', [

　　　　'student' => $student

　　]);

}

控制器 ----> 视图

@extends('common.layouts')

@section('content')

    <div class="panel panel-default">

        <div class="panel-heading">学生详情</div>

        <table class="table table-bordered table-striped table-hover ">

            <tbody>

            <tr>

                <td width="50%">ID</td>

                <td>{{ $student->id }}</td>

            </tr>

            <tr>

                <td>姓名</td>

                <td>{{ $student->name }}</td>

            </tr>

            <tr>

                <td>年龄</td>

                <td>{{ $student->age }}</td>

            </tr>

            <tr>

                <td>性别</td>

                <td>{{ $student->sex($student->sex) }}</td>

            </tr>

            <tr>

                <td>添加日期</td>

                <td>{{ date('Y-m-d', $student->created_at) }}</td>

            </tr>

            <tr>

                <td>最后修改</td>

                <td>{{ date('Y-m-d', $student->updated_at) }}</td>

            </tr>

            </tbody>

        </table>

    </div>

@stop

六、删除信息

删除模型中的数据

    public function delete($id)

    {

        $student = Student::find($id);

        if ($student->delete()) {

            return redirect('student/index')->with('success', '删除成功-' . $id);

        } else {

            return redirect('student/index')->with('error', '删除失败-' . $id);

        }

    }

删除确认框

删除不需要专门的删除页面，利用onClick方法即可。

            <tbody>

                @foreach($students as $student)

                <tr>

                    <th scope="row">{{ $student->id }}</th>

                    <td>{{ $student->name }}</td>

                    <td>{{ $student->age }}</td>

                    <td>{{ $student->sex($student->sex) }}</td>

                    <td>{{ date('Y-m-d', $student->created_at) }}</td>

                    <td>

                        <a href="{{ url('student/detail', ['id' => $student->id]) }}">详情</a>

                        <a href="{{ url('student/update', ['id' => $student->id]) }}">修改</a>

                        <a href="{{ url('student/delete', ['id' => $student->id]) }}" onclick="if (confirm('确定要删除吗？') == false) return false;">删除</a>

                    </td>

                </tr>

                @endforeach

            </tbody>

本项目剖析到此结束。