一些实用的 Laravel 小技巧

Posted 2021-05-02 程序源

来源：lufficc （@lufficc）

网址：lufficc.com/blog/some-tiny-but-useful-laravel-tricks

Laravel 中一些常用的小技巧，额，说不定你就用上了。。。

1.侧栏

网站一般都有侧栏，用来显示分类，标签，热门文章，热门评论啥的，但是这些侧栏都是相对独立的模块，如果在每一个引入侧栏的视图中都单独导入与视图有关的数据的话，未免太冗余了。。。所以最佳的做法是：新建一个widgets视图文件夹，再利用Laravel 的ViewComposers单独为侧栏绑定数据，这样侧栏就可以随便引入而不用关心数据是否绑定啦~~~

举个栗子？拿最常用的分类侧栏来说，在resources/views/widgets下新建你的分类侧栏视图文件categories.blade.php：

<div class="widget widget-default">

    <div class="widget-header"><h6><i class="fa fa-folder fa-fw"></i>分类</h6></div>

    <ul class="widget-body list-group">

        @forelse($categories as $category)

            @if(str_contains(urldecode(request()->getPathInfo()),'category/'.$category->name))

                <li href="{{ route('category.show',$category->name) }}"

                    class="list-group-item active">

                    {{ $category->name }}

                    <span class="badge">{{ $category->posts_count }}</span>

                </li>

            <a href='http://www.jobbole.com/members/wx2715401697'>@else</a>

                <a href="{{ route('category.show',$category->name) }}"

                   class="list-group-item">

                    {{ $category->name }}

                    <span class="badge">{{ $category->posts_count }}</span>

                </a>

            <a href='http://www.jobbole.com/members/endif1983'>@endif</a>

        <a href='http://www.jobbole.com/members/mxbeijing2007'>@empty</a>

            <p class="meta-item center-block">No categories.</p>

        @endforelse

    </ul>

</div>

新建app/Http/ViewComposers文件夹，然后创建CategoriesComposer.php：

<?php

namespace App\Http\ViewComposers;

use App\Http\Repositories\CategoryRepository;

use Illuminate\View\View;

class CategoriesComposer

{

    public function __construct(CategoryRepository $categoryRepository)

    {

        $this->categoryRepository = $categoryRepository;

    }

 

    public function compose(View $view)

    {

        $categories = $this->categoryRepository->getAll()->reject(function ($category) {

            return $category->posts_count == 0;

        });

        $view->with('categories', $categories);

    }

}

再在app/Providers文件夹下新建ComposerServiceProvider.php文件：

<?php

namespace App\Providers;

use Illuminate\Support\ServiceProvider;

use Illuminate\Support\Facades\View;

class ComposerServiceProvider extends ServiceProvider

{

 

    public function boot()

    {

        View::composer('widget.categories', 'App\Http\ViewComposers\CategoriesComposer');

    }

 

    public function register(){}

}

最后别忘了在config/app.php中的providers数组中添加AppProvidersComposerServiceProvider::class啊。好了，现在你可以随时随地@include('widget.categories')了。对了，要善于在ViewComposer中利用Collection的强大方法进行数据处理幺~~

2.善用路由别名

Laravel 最让人喜欢的地方之一是可以给路由起一个别名，比如：

Route::get('user/profile', 'UserController@showProfile')->name('user.profile');

// 等价于：

Route::get('user/profile', ['uses' => 'UserController@showProfile' , 'as' => 'user.profile']);;

然后，就可以在试图中就可以使用route()方法引用了：

// 例如：

<a href="{{ route('user.profile') }}">lufficc</a>

因为一个普通的项目路由至少也得有几十个，如果使用url()方法的话，你不但要记住具体的路由，更麻烦的是如果你将来想要改变某个路由（比如把'user/profile'改为'u/profile'，或者加个前缀啥的），必须改变所有相关的视图文件，这。。。这。。。不敢相信，而使用命名路由的话，只要命名不变，毫不受影响。

所以视图文件中尽量避免使用url()方法，为每一个路由命名，一个默认的命名规则为：资源名称.或者，如post.show，image.upload。

3.全局动态设置

仅仅是.env的配置还无法满足我们的需求，有时我们需要可以在后台动态的进行一些设置，比如网站的标题，网站的背景图片或者是否允许评论等等。那么实现这个的最佳实践是什么？

熟悉wordpress的同学知道，wordpress可以进行很多自定义，因为wordpress有一张键值对数据库表，它就是靠这个实现个性化的。因此我们也可以参考这种思路，增加一个键值对表，以Xblog为例子，新建一个maps表：

Schema::create('maps', function (Blueprint $table) {

       $table->increments('id');

       $table->string('key')->unique();

       $table->string('tag')->index();

       $table->text('value')->nullable(true);

});

maps表的作用就是实现键值对key-value存储，tag的是为了可以有一个分类。然后后台进行存储的话，不要写死，这样就可以随时在变单中添加设置而无需更改代码：

$inputs = $request->except('_token');

foreach ($inputs as $key => $value) {

            $map = Map::firstOrNew([

                'key' => $key,

            ]);

            $map->tag = 'settings';

            $map->value = $value;

            $map->save();

}

注意firstOrNew的用法：如果不存在这个选项我们就新增一个并保存，否则就更新它。然后我们就可以在视图中随便增加任意多个表单了（或者也可以用js动态生成表单）。有了数据，怎么在视图中利用呢？利用ViewComposer，新建一个SettingsComposer.php，然后将查询的数据以数组的形式传递给视图：

//在SettingsComposer.php的compose方法中绑定数据

public function compose(View $view)

{

    $settings = Map::where('tag', 'settings')->get();

    $arr = [];

    foreach ($settings as $setting) {

      $arr[$setting->key] = $setting->value;

    }

   $view->with($arr);

}

然后就可以在视图中随便引用了，如你表单新增加了一个description

<input type="text" name="description" value="{{ $description or ''}}">

然后就可以在任何视图引用了:{{ $description or ''}}。另外还可以绑定一个单例Facades到容器，这样就可以在代码中随时获取配置信息啦~~~

比如：

//1.注册

public function register()

{

    $this->app->singleton('XblogConfig', function ($app) {

       return new MapRepository();

   });

}

//2.注册Facade

class XblogConfig extends Facade

{

    public static function getFacadeAccessor()

    {

        return 'XblogConfig';

    }

}

//3.添加到aliases数组

 

'aliases' => [

 

        *****************  省略  *************************

        'XblogConfig' => App\Facades\XblogConfig::class,

    ],

 

//4.愉快的使用，可爽

$page_size = XblogConfig::getValue('page_size', 7);

4.数据库查询

怎么统计一篇文章有多少评论？最快的方法是：

$post = Post::where('id',1)->withCount('comments')->first();

这样$post变量就有一个属性comments_count了：

$post->comments_count;

如果想获取点赞数大于的100的评论个数怎么办？这样：

$post = Post::where('id',1)->withCount('comments',function($query){

       $query->where('like', '>', 100);

   })->first();

简单吧~~

5.多态关联

文章可以有评论，页面可以有评论，评论也可以有评论，但是总不能建三张评论表吧？如果自己写条件判断也太麻烦了吧。。。Laravel的多态关联上场了！！

//1.第一步在Comment模型中说明我是可以多态的

public function commentable()

{

    return $this->morphTo();

}

 

//2.在想要评论的模型中增加comments方法，

public function comments()

{

    return $this->morphMany(Comment::class, 'commentable');

}

 

//3.使用，就像普通的一对多关系一样：

$model->comments;

原理很简单，comments表中增加两个列就行：

Schema::create('comments', function (Blueprint $table) {

     ***************省略*******************

     $table->morphs('commentable');

     //等价于

     $table->integer('commentable_id')->index();

     $table->string('commentable_type')->index();

    ****************省略******************

});

然后 laravel 会自动维持这些关系。注意，保存的评论的时候是有小技巧的，你的表单中至少要传两个参数：commentable_id和commentable_type：

$comment = new Comment();

 

$commentable_id = $request->get('commentable_id');

//commentable_type取值例如：AppPost，AppPage等等

$commentable = app($request->get('commentable_type'))->where('id', $commentable_id)->firstOrFail();

 

****************省略******************

 

$commentable->comments()->save($comment);

保存评论的时候并不知道是谁的评论，而是使用容器根据commentable_type生成一个模型实例，这样也就和具体的模型解耦了，你可以让任何东西可以评论，而不需要修改代码。

6.缓存优化相关

如果你想要在.env文件中添加自己的配置，记住一定要在config文件夹下某个配置文件的数组中添加对应的。记住，除了config文件夹下的配置文件，永远不要在其它地方使用env函数，因为部署到线上时，配置文件缓存（php artisan config:cache）后，env函数无法获得正确的值。

另外注意的是，路由文件中尽量不使用闭包函数，统一使用控制器，因为缓存路由的时候php artisan route:cache，无法缓存闭包函数。

7.Redis

如果你缓存使用Redis，session也使用了Redis，队列已使用了Redis，这样没问题，速度很快，但是！！当你运行php artisan cache:clear清除缓存时，会把你的登录信息清除，也会把队列清除。。。这就不优雅了。解决办法很简单，为它们分配不同的连接即可。

首先在configdatabase.php中增加连接，注意database序号：

'redis' => [

 

        'cluster' => false,

 

        'default' => [

            'host' => env('REDIS_HOST', 'localhost'),

            'password' => env('REDIS_PASSWORD', null),

            'port' => env('REDIS_PORT', 6379),

            'database' => 0,

        ],

        'session' => [

            'host' => env('REDIS_HOST', 'localhost'),

            'password' => env('REDIS_PASSWORD', null),

            'port' => env('REDIS_PORT', 6379),

            'database' => 1,

        ],

        'queue' => [

            'host' => env('REDIS_HOST', 'localhost'),

            'password' => env('REDIS_PASSWORD', null),

            'port' => env('REDIS_PORT', 6379),

            'database' => 2,

        ],

 

    ],

然后分别为session和queue更换连接：

//queue.php中的connections数组中：

'redis' => [

            'driver' => 'redis',

            'connection' => 'queue',

            'queue' => 'default',

            'retry_after' => 90,

        ],

 

//session.php中的connection选项：

'connection' => 'session',

这样他们就互不相干了~~

近期热文

1. 
   

2. 
   

3. 
   

4. 
   

5. 
   

添加小编微信：szweican(备注岗位)