最近在用Laravel寫一個cms,還沒有完成,但是也遇到了許多難點,比如cms後臺每個視圖都要展示相同的導航菜單數據。
環境:
PHP 7.1
Apache 2.4
MySQL 5.7
Laravel 5.4
- 傳統方法
假設使用傳統的方法,應該是在每個控制器中都調用數據,然後把數據都塞給視圖。
$menu = DB::table('menu')->get();
return view('xx',['menu'=>$menu]);
- 稍微優化
新建一個BaseController,然後讓BaseController去獲取數據,然後在每個控制器都繼承BaseController,最後將數據塞到視圖中。
基類
class BaseController{
protected $menu = null;//菜單數據
public function __construct(){
$this->getMenu();//獲取導航菜單
}
public function getMenu(){
$this->menu = DB::table('menu')->get();
}
}
A控制器
class AController extends BaseController{
public function index(){
return view('admin.index',['menu'=>$this->menu,'user'=>$user]);
}
}
缺點:在每個控制器中都需要重新設置相同的模板的數據(menu)
- 最好優化方案
使用Laravel中的View Composers來解決這個問題
1、在App\Providers下創建一個ComposerServiceProvider類
<?php
namespace App\Providers;
use Illuminate\Support\Facades\View;
use Illuminate\Support\ServiceProvider;
class ComposerServiceProvider extends ServiceProvider {
/**
* Register bindings in the container.
*
* @return void
*/
public function boot() {
// 基於類的view composer
View::composer(
'admin.common.*', 'App\Http\ViewComposers\AdminComposer'
);
}
/**
* Register the service provider.
*
* @return void
*/
public function register() {
//
}
}
在boot方法中定義要監聽的視圖,還可以使用通配符,這裏我寫的是admin.common.*
,如果admin.common.*
下的視圖被渲染的話將會調用App\Http\ViewComposers\AdminComposer@composer
方法
2、註冊ComposerServiceProvider
在config/app.php
文件下的providers
數組中進行註冊
App\Providers\ComposerServiceProvider::class,
3、創建AdminComposer類
Laravel推薦把view composer類放在app\Http\ViewComposers
目錄下,這個目錄一開始是沒有的,需要新建
<?php
namespace App\Http\ViewComposers;
use App\Libs\CommonUtils;
use Illuminate\Http\Request;
use Illuminate\View\View;
class AdminComposer {
private $data = null;//CommonUtils對象
public function __construct(Request $request) {
$this->data = new CommonUtils($request);//新建一個CommonUtils對象
}
public function compose(View $view) {
$view->with([
'admin' => $this->data->admin,
'mbx' => $this->data->mbx,
'menu' => $this->data->menu,
'msg' => $this->data->msg
]);//填充數據
}
}
在這裏我在構造方法中創建了一個對象,這個對象中包含着數據
5、CommonUtils文件
<?php
/**
* Created by PhpStorm.
* User: Administrator
* Date: 2017/4/20 0020
* Time: 19:49
*/
namespace App\Libs;
use App\Admin;
use App\Perm;
use Illuminate\Http\Request;
use Illuminate\Support\Facades\DB;
class CommonUtils {
public $admin = null;//管理員對象
public $menu = null;//菜單對象
public $mbx = null;//麪包屑對象
public $msg = null;//消息對象
/**
* 構造函數
*/
public function __construct(Request $request) {
$this->init($request);
}
/**
* 初始化函數
*/
private function init(Request $request) {
$this->getAdmin($request);
$this->getMsg();
$this->getMenu($request);
$this->getMbx($request);
}
/**
* 獲取管理員數據
*/
private function getAdmin() {
$this->admin = session('admin');
}
/**
* 獲取後臺菜單數據
*/
private function getMenu(Request $request) {
$menu = DB::table('menu')->where('parentid', 0)->orderBy('sort')->get();
$router = $request->getPathInfo();
$perm = new Perm();
$mbx = $perm->getMbx($router);
foreach ($menu as $k => $m) {
$m->active = '';
//讀取子菜單
$childMenu = DB::table('menu')->where('parentid', $m->id)->orderBy('sort')->get();
if (count($childMenu) > 0) {
foreach($childMenu as $v){
$v->active = '';
if($mbx[0]->router == $v->router){
$v->active = 'active';
$m->active = 'active';
}
}
$m->childMenu = $childMenu;
} else {
$m->childMenu = null;
}
}
$this->menu = $menu;
}
/**
* 獲取麪包屑
*/
private function getMbx(Request $request) {
$router = $request->getPathInfo();
$perm = new Perm();
$mbx = $perm->getMbx($router);
$this->mbx = $mbx;
}
/**
* 獲取未讀消息
*/
private function getMsg() {
$adminModel = new Admin();
$toId = $this->admin->id;
$this->msg = $adminModel->getUnReadMsg($toId);
}
}
在這裏面分別獲取了管理員、菜單、麪包屑、消息數據,這些數據都是每個後臺頁面都要使用到的。
注意:這裏我將類定義成了CommonUtils,感覺名字取得不好,CommonUtils是存放在App\Libs下的,這個Libs文件夾是我新建的,用於存放工具類的。如果需要給App\Libs文件夾添加自動加載,需要在composer.json文件裏做如下修改。