如何優(yōu)雅的寫代碼，我想是每位程序員的心聲师抄。自從15年初第一次接觸 Laravel 4.2 開始漓柑，我就迷上使用 Laravel 框架了。我一直都想找個時間好好寫寫有關(guān) Laravel 的使用文章叨吮，由淺入深的介紹 Laravel 框架辆布。
今天通過使用 laravel-admin 插件，來簡單說說怎么優(yōu)雅的寫 Laravel 代碼茶鉴。
創(chuàng)建 Laravel 項目
只要跟著官方文檔走锋玲，創(chuàng)建一個 Laravel 項目還是很簡單的：
// 使用 Composer 下載 Laravel 安裝程序
composer global require "laravel/installer"
// 創(chuàng)建 web 項目
laravel new web
具體配置數(shù)據(jù)庫等：略
安裝 Laravel 看官網(wǎng)：https://d.laravel-china.org/docs/5.5/installation
如何安裝 Composer，可以看看我之前的文章 一步一步搭建 PHP 服務(wù)器環(huán)境
安裝 laravel-admin
laravel-admin 是一個可以快速幫你構(gòu)建后臺管理的工具涵叮，它提供的頁面組件和表單元素等功能惭蹂，能幫助你使用很少的代碼就實現(xiàn)功能完善的后臺管理功能伞插。
注：當(dāng)前版本(1.5)需要安裝 PHP 7+和 Laravel 5.5
看看 laravel-admin 的特性：
- 內(nèi)置用戶和權(quán)限系統(tǒng)
- model-grid 支持快速構(gòu)建數(shù)據(jù)表格
- model-form 支持快速構(gòu)建數(shù)據(jù)表單
- model-tree 支持快速構(gòu)建樹狀數(shù)據(jù)
- 內(nèi)置 40+ 種 form 元素組件、以及支持?jǐn)U展組件
- 支持 Laravel 的多種模型關(guān)系
- mysql盾碗、mongodb媚污、pgsql 等多數(shù)據(jù)庫支持
- 支持引入第三方前端庫
- 數(shù)據(jù)庫和 artisan 命令行工具的 web 實現(xiàn)
- 支持自定義圖表
- 多種常用 web 組件
- 支持本地和 oss 文件上傳
有了這些功能，開發(fā)一個后臺管理系統(tǒng)就變得相對簡單了廷雅。
安裝插件：
composer require encore/laravel-admin "1.5.*"
// 發(fā)布資源：
php artisan vendor:publish --provider="Encore\Admin\AdminServiceProvider"
// 安裝
php artisan admin:install
簡單的三條命令耗美，即可配置好一個簡單的后臺管理系統(tǒng)，賬號和密碼都是 admin
代碼主要集中在\APP\Admin中
默認(rèn)系統(tǒng)提供一個 Dashboard 界面：
<?php
namespace App\Admin\Controllers;
use App\Http\Controllers\Controller;
use Encore\Admin\Facades\Admin;
use Encore\Admin\Layout\Column;
use Encore\Admin\Layout\Content;
use Encore\Admin\Layout\Row;
class HomeController extends Controller
{
public function index()
{
return Admin::content(function (Content $content) {
$content->header('Test Dashboard');
$content->description('Description...');
$content->row(Dashboard::title());
$content->row(function (Row $row) {
$row->column(4, function (Column $column) {
$column->append(Dashboard::environment());
});
$row->column(4, function (Column $column) {
$column->append(Dashboard::extensions());
});
$row->column(4, function (Column $column) {
$column->append(Dashboard::dependencies());
});
});
});
}
}
結(jié)合界面和代碼航缀，可以看出界面主要分成這么幾個部分：header商架、description、兩個 row芥玉，后一個 row 包含三個 column 模塊甸私；具體的代碼放在 Dashboard 代碼中，如下：
<?php
namespace Encore\Admin\Controllers;
use Encore\Admin\Admin;
class Dashboard
{
/**
* @return \Illuminate\Contracts\View\Factory|\Illuminate\View\View
*/
public static function title()
{
return view('admin::dashboard.title');
}
/**
* @return \Illuminate\Contracts\View\Factory|\Illuminate\View\View
*/
public static function environment()
{
$envs = [
['name' => 'PHP version', 'value' => 'PHP/'.PHP_VERSION],
['name' => 'Laravel version', 'value' => app()->version()],
['name' => 'CGI', 'value' => php_sapi_name()],
['name' => 'Uname', 'value' => php_uname()],
['name' => 'Server', 'value' => array_get($_SERVER, 'SERVER_SOFTWARE')],
['name' => 'Cache driver', 'value' => config('cache.default')],
['name' => 'Session driver', 'value' => config('session.driver')],
['name' => 'Queue driver', 'value' => config('queue.default')],
['name' => 'Timezone', 'value' => config('app.timezone')],
['name' => 'Locale', 'value' => config('app.locale')],
['name' => 'Env', 'value' => config('app.env')],
['name' => 'URL', 'value' => config('app.url')],
];
return view('admin::dashboard.environment', compact('envs'));
}
/**
* @return \Illuminate\Contracts\View\Factory|\Illuminate\View\View
*/
public static function extensions()
{
$extensions = [
'helpers' => [
'name' => 'laravel-admin-ext/helpers',
'link' => 'https://github.com/laravel-admin-extensions/helpers',
'icon' => 'gears',
],
'log-viewer' => [
'name' => 'laravel-admin-ext/log-viewer',
'link' => 'https://github.com/laravel-admin-extensions/log-viewer',
'icon' => 'database',
],
'backup' => [
'name' => 'laravel-admin-ext/backup',
'link' => 'https://github.com/laravel-admin-extensions/backup',
'icon' => 'copy',
],
'config' => [
'name' => 'laravel-admin-ext/config',
'link' => 'https://github.com/laravel-admin-extensions/config',
'icon' => 'toggle-on',
],
'api-tester' => [
'name' => 'laravel-admin-ext/api-tester',
'link' => 'https://github.com/laravel-admin-extensions/api-tester',
'icon' => 'sliders',
],
'media-manager' => [
'name' => 'laravel-admin-ext/media-manager',
'link' => 'https://github.com/laravel-admin-extensions/media-manager',
'icon' => 'file',
],
'scheduling' => [
'name' => 'laravel-admin-ext/scheduling',
'link' => 'https://github.com/laravel-admin-extensions/scheduling',
'icon' => 'clock-o',
],
'reporter' => [
'name' => 'laravel-admin-ext/reporter',
'link' => 'https://github.com/laravel-admin-extensions/reporter',
'icon' => 'bug',
],
'translation' => [
'name' => 'laravel-admin-ext/translation',
'link' => 'https://github.com/laravel-admin-extensions/translation',
'icon' => 'language',
],
];
foreach ($extensions as &$extension) {
$name = explode('/', $extension['name']);
$extension['installed'] = array_key_exists(end($name), Admin::$extensions);
}
return view('admin::dashboard.extensions', compact('extensions'));
}
/**
* @return \Illuminate\Contracts\View\Factory|\Illuminate\View\View
*/
public static function dependencies()
{
$json = file_get_contents(base_path('composer.json'));
$dependencies = json_decode($json, true)['require'];
return view('admin::dashboard.dependencies', compact('dependencies'));
}
}
這樣我們就把代碼分塊的組織在一起飞傀。具體布局類看：class Content implements Renderable
其它的靜態(tài)資源文件放在 /public/vendor/laravel-admin 目錄下
更多內(nèi)容參考 laravel-admin 官網(wǎng)：
http://laravel-admin.org/docs/#/zh/
寫一個 demo
有了這個 laravel-admin 插件皇型，要寫一個 movies 列表，只需要幾個命令行就可以完成了砸烦，非常簡單：
1.建立模型弃鸦，并創(chuàng)建 Migrations：
php artisan make:model Movie -m
2.在 Migrations，增加一個字段：name
<?php
use Illuminate\Support\Facades\Schema;
use Illuminate\Database\Schema\Blueprint;
use Illuminate\Database\Migrations\Migration;
class CreateMoviesTable extends Migration
{
/**
* Run the migrations.
*
* @return void
*/
public function up()
{
Schema::create('movies', function (Blueprint $table) {
$table->increments('id');
$table->string('name', 50)->unique();
$table->timestamps();
});
}
/**
* Reverse the migrations.
*
* @return void
*/
public function down()
{
Schema::dropIfExists('movies');
}
}
3.運行 Migrations幢痘，創(chuàng)建對應(yīng)數(shù)據(jù)庫：
php artisan migrate
4.有了數(shù)據(jù)表唬格，就需要往表里插入 fake 數(shù)據(jù)，用于測試
// 使用該插件創(chuàng)建 fake 數(shù)據(jù)
composer require fzaninotto/faker
5.建立 Seeder
php artisan make:seeder MovieTableSeeder
在該類中颜说，建立1000條假數(shù)據(jù)：
<?php
use Illuminate\Database\Seeder;
class MovieTableSeeder extends Seeder
{
/**
* Run the database seeds.
*
* @return void
*/
public function run()
{
//
$faker = Faker\Factory::create();
for($i = 0; $i < 1000; $i++) {
App\Movie::create([
'name' => $faker->name
]);
}
}
}
運行：
php artisan db:seed --class=MovieTableSeeder
是不是很簡單购岗，數(shù)據(jù)表直接填充 1000 條假數(shù)據(jù)：
6.建立資源 Controller
php artisan admin:make MovieController --model=App\\Movie
這樣就直接有了基礎(chǔ)的增刪改查和 movie 列表功能的 Controller 了。
7.建立 route
$router->resource('movies', MovieController::class);
8.加入到 admin 的 menu 中
其中路徑處需要注意的是：
其中uri填寫不包含路由前綴的的路徑部分门粪，比如完整路徑是http://localhost:8000/admin/demo/users, 那么就填demo/users喊积，如果要添加外部鏈接，只要填寫完整的url即可玄妈，比如http://laravel-admin.org/.
上圖也是加了左側(cè) movies 菜單的效果乾吻。
這就完成了簡單的 movie 資源的后臺管理了，在瀏覽器輸入鏈接：
http://web.app/admin/movies
就能看到一個較為完整的 movie 列表：
具體有新增拟蜻、導(dǎo)出绎签、篩選、操作 (刪除)酝锅、撤銷诡必、分頁、修改搔扁、刪除等常規(guī)功能爸舒，如下幾個截圖：
總結(jié)
有了 Laravel 和 laravel-admin蟋字，基本不用寫什么代碼，敲敲幾個命令就可以完成一個「功能比較齊全」的資源操作后臺碳抄。極大的方便了我們的開發(fā)。
總體命令行和代碼如下
php artisan make:model Movie -m
php artisan migrate
composer require fzaninotto/faker
php artisan make:seeder MovieTableSeeder
php artisan db:seed --class=MovieTableSeeder
php artisan admin:make MovieController --model=App\\Movie
$router->resource('movies', MovieController::class);
框架和開源插件场绿，有時候確實是能方便我們開發(fā)剖效，所以尋找優(yōu)質(zhì)的框架和開源庫也是促進我們生產(chǎn)力的。
laravel-admin 代碼是如何組織的焰盗，可以具體參考網(wǎng)站開發(fā)璧尸。先根據(jù)官網(wǎng)的介紹，利用好 laravel-admin熬拒，然后學(xué)習(xí)它的源碼和代碼設(shè)計爷光，最后取其精華，為你所用澎粟。
「完」
coding01 期待您繼續(xù)關(guān)注
也很感謝您能看到這了
