阅读 252

Laravel 技巧锦集

一、验证

1、验证唯一部分解析(更新时除用户本身)
unique:table,column,except,idColumn
唯一:表明,列,除什么值,默认id列
验证字段在给定数据表上必须是唯一的,如果不指定column(如下例:name)选项,字段名将作为默认column(如下例:name)。
指定自定义列名:
'name' => 'unique:users, name,' . Auth::id(), 'id',

2、自定义验证错误信息,未下载中文包时
在resources/lang/en/validation.php中以下字段

    'custom' => [
        'email' => [
            'required' => '邮箱地址不能为空!',
        ]
    ],
复制代码

3、表单请求验证类
例如在以下控制器中调用表单请求验证类,user然后在引入UserRequest app/Http/Controllers/UsersController.php

<?php
.
.
.
use App\Http\Requests\UserRequest;

class UsersController extends Controller
{
    .
    .
    .

    public function update(UserRequest $request, User $user)
    {
        $user->update($request->all());
        return redirect()->route('users.show', $user->id)->with('success', '个人资料更新成功!');
    }
}
复制代码

表单请求验证(FormRequest) 是 Laravel 框架提供的用户表单数据验证方案,此方案相比手工调用 validator 来说,能处理更为复杂的验证逻辑,更加适用于大型程序。在本课程中,我们将统一使用 表单请求验证来处理表单验证逻辑。
接下来我们创建 UserRequest ,使用以下命令: $ php artisan make:request UserRequest
执行成功后会生成以下文件:
app/Http/Requests/UserRequest.php,同时在rules中添加验证

<?php

namespace App\Http\Requests;

use Illuminate\Foundation\Http\FormRequest;
use Auth;

class UserRequest extends FormRequest
{
    public function authorize()
    {
        return true;
    }

    public function rules()
    {
        return [
            'name' => 'required|between:3,25|regex:/^[A-Za-z0-9\-\_]+$/|unique:users,name,' . Auth::id(),
            'email' => 'required|email',
            'introduction' => 'max:80',
        ];
    }
}
复制代码

验证中文包下载:$ composer require "overtrue/laravel-lang:~3.0"
进入app/Http/Requests/UserRequest.php自定义错误提示

.
.
.
    public function messages()
    {
        return [
            'name.unique' => '用户名已被占用,请重新填写',
            'name.regex' => '用户名只支持英文、数字、横杆和下划线。',
            'name.between' => '用户名必须介于 3 - 25 个字符之间。',
            'name.required' => '用户名不能为空。',
        ];
    }
}
复制代码

ps:验证错误提示,官方有文档介绍怎么添加错误提示

二、通过迁移针对users表添加一个或多个字段(示例添加了一个头像和一个简介字段)

命名规范add_column_to_table,使用--tables选项:用于指定对应的数据库表,迁移命令如下 $ php artisan make:migration add_avatar_and_introduction_to_users_table --table=users
迁移出的文件如下,同时添加字段avatar和introduction

<?php

use Illuminate\Support\Facades\Schema;
use Illuminate\Database\Schema\Blueprint;
use Illuminate\Database\Migrations\Migration;

class AddAvatarAndIntroductionToUsersTable extends Migration
{
    /**
     * 执行迁移
     *
     * @return void
     */
    public function up()
    {
        Schema::table('users', function (Blueprint $table) {
            $table->string('avatar')->nullable();
            $table->string('introduction')->nullable();
        });
    }

    /**
     * 回滚迁移
     *
     * @return void
     */
    public function down()
    {
        Schema::table('users', function (Blueprint $table) {
            $table->dropColumn('avatar');
            $table->dropColumn('introduction');
        });
    }
}
复制代码

三、友好的时间显示diffForHumans()

<p>{{ $user->created_at->diffForHumans() }}</p>
复制代码

友好的时间显示默认是英文
调整成为中文是Carbon的操作拓展来实现,laravel集成到了框架中,diffForHumansCarbon对象提供的方法,AppServiceProvider是框架的核心,在 Laravel 启动时,会最先加载该文件。
app/Providers/AppServiceProvider.php

    public function boot()
    {
        \Carbon\Carbon::setLocale('zh');
    }
复制代码

四、工具类的使用,手动创建工具类

app/Handlers/ImageUploadHandler.php

<?php

namespace App\Handlers;

class ImageUploadHandler
{
    // 只允许以下后缀名的图片文件上传
    protected $allowed_ext = ["png", "jpg", "gif", 'jpeg'];

    public function save($file, $folder, $file_prefix)
    {
        // 构建存储的文件夹规则,值如:uploads/images/avatars/201709/21/
        // 文件夹切割能让查找效率更高。
        $folder_name = "uploads/images/$folder/" . date("Ym/d", time());

        // 文件具体存储的物理路径,`public_path()` 获取的是 `public` 文件夹的物理路径。
        // 值如:/home/vagrant/Code/larabbs/public/uploads/images/avatars/201709/21/
        $upload_path = public_path() . '/' . $folder_name;

        // 获取文件的后缀名,因图片从剪贴板里黏贴时后缀名为空,所以此处确保后缀一直存在
        $extension = strtolower($file->getClientOriginalExtension()) ?: 'png';

        // 拼接文件名,加前缀是为了增加辨析度,前缀可以是相关数据模型的 ID 
        // 值如:1_1493521050_7BVc9v9ujP.png
        $filename = $file_prefix . '_' . time() . '_' . str_random(10) . '.' . $extension;

        // 如果上传的不是图片将终止操作
        if ( ! in_array($extension, $this->allowed_ext)) {
            return false;
        }

        // 将图片移动到我们的目标存储路径中
        $file->move($upload_path, $filename);

        return [
            'path' => config('app.url') . "/$folder_name/$filename"
        ];
    }
}
复制代码

进入到控制器中use一下,并调用
app/Http/Controllers/UsersController.php

<?php
.
.
.
use App\Handlers\ImageUploadHandler;

class UsersController extends Controller
{
    .
    .
    .

    public function update(UserRequest $request, ImageUploadHandler $uploader, User $user)
    {
        $data = $request->all();

        if ($request->avatar) {
            $result = $uploader->save($request->avatar, 'avatars', $user->id);
            if ($result) {
                $data['avatar'] = $result['path'];
            }
        }

        $user->update($data);
        return redirect()->route('users.show', $user->id)->with('success', '个人资料更新成功!');
    }
}
复制代码

五、图片裁剪

1.Composer 安装
$ composer require intervention/image 2.配置信息
执行以下命令获取配置信息:
$ php artisan vendor:publish --provider="Intervention\Image\ImageServiceProviderLaravel5"
开始裁剪,替换上面工具类的代码

<?php

namespace App\Handlers;

use Image;

class ImageUploadHandler
{
    protected $allowed_ext = ["png", "jpg", "gif", 'jpeg'];

    public function save($file, $folder, $file_prefix, $max_width = false)
    {
        // 构建存储的文件夹规则,值如:uploads/images/avatars/201709/21/
        // 文件夹切割能让查找效率更高。
        $folder_name = "uploads/images/$folder/" . date("Ym/d", time());

        // 文件具体存储的物理路径,`public_path()` 获取的是 `public` 文件夹的物理路径。
        // 值如:/home/vagrant/Code/larabbs/public/uploads/images/avatars/201709/21/
        $upload_path = public_path() . '/' . $folder_name;

        // 获取文件的后缀名,因图片从剪贴板里黏贴时后缀名为空,所以此处确保后缀一直存在
        $extension = strtolower($file->getClientOriginalExtension()) ?: 'png';

        // 拼接文件名,加前缀是为了增加辨析度,前缀可以是相关数据模型的 ID
        // 值如:1_1493521050_7BVc9v9ujP.png
        $filename = $file_prefix . '_' . time() . '_' . str_random(10) . '.' . $extension;

        // 如果上传的不是图片将终止操作
        if ( ! in_array($extension, $this->allowed_ext)) {
            return false;
        }

        // 将图片移动到我们的目标存储路径中
        $file->move($upload_path, $filename);

        // 如果限制了图片宽度,就进行裁剪
        if ($max_width && $extension != 'gif') {

            // 此类中封装的函数,用于裁剪图片
            $this->reduceSize($upload_path . '/' . $filename, $max_width);
        }

        return [
            'path' => config('app.url') . "/$folder_name/$filename"
        ];
    }

    public function reduceSize($file_path, $max_width)
    {
        // 先实例化,传参是文件的磁盘物理路径
        $image = Image::make($file_path);

        // 进行大小调整的操作
        $image->resize($max_width, null, function ($constraint) {

            // 设定宽度是 $max_width,高度等比例双方缩放
            $constraint->aspectRatio();

            // 防止裁图时图片尺寸变大
            $constraint->upsize();
        });

        // 对图片修改后进行保存
        $image->save();
    }
}
复制代码

控制器中调用可以定制裁剪宽度
$result = $uploader->save($request->avatar, 'avatars', $user->id, 362);

六、防止用户2修改用户1的个人资料

我们可以使用以下命令来生成一个名为 UserPolicy 的授权策略类文件,用于管理用户模型的授权。
$ php artisan make:policy UserPolicy
所有生成的授权策略文件都会被放置在 app/Policies 文件夹下
让我们为默认生成的用户授权策略添加update方法,用于用户更新时的权限验证。
app/Policies/UserPolicy.php

<?php

namespace App\Policies;

use App\Models\User;
use Illuminate\Auth\Access\HandlesAuthorization;

class UserPolicy
{
    use HandlesAuthorization;

    public function update(User $currentUser, User $user)
    {
        return $currentUser->id === $user->id;
    }
}
复制代码

接下来我们还需要在 AuthServiceProvider 类中对授权策略进行注册。AuthServiceProvider 包含了一个 policies 属性,该属性用于将各种模型对应到管理它们的授权策略上。我们需要为用户模型 User 指定授权策略 UserPolicy
app/Providers/AuthServiceProvider.php

<?php

namespace App\Providers;
.
,
.
class AuthServiceProvider extends ServiceProvider
{
    /**
     * The policy mappings for the application.
     *
     * @var array
     */
    protected $policies = [
        'App\Model' => 'App\Policies\ModelPolicy',
        \App\Models\User::class  => \App\Policies\UserPolicy::class,
    ];
    .
    .
    .
}
复制代码

之后在控制器中调用$this->authorize('update', $user);即可