如何優(yōu)雅的寫代碼，我想是每位程序員的心聲。自從15年初第一次接觸 Laravel 4.2 開始，我就迷上使用 Laravel 框架了。我一直都想找個(gè)時(shí)間好好寫寫有關(guān) Laravel 的使用文章，由淺入深的介紹 Laravel 框架。

今天通過使用 laravel-admin 插件，來簡單說說怎么優(yōu)雅的寫 Laravel 代碼。

創(chuàng)建 Laravel 項(xiàng)目

只要跟著官方文檔走，創(chuàng)建一個(gè) Laravel 項(xiàng)目還是很簡單的：

// 使用 Composer 下載 Laravel 安裝程序
composer global require "laravel/installer"

// 創(chuàng)建 web 項(xiàng)目
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è)可以快速幫你構(gòu)建后臺(tái)管理的工具，它提供的頁面組件和表單元素等功能，能幫助你使用很少的代碼就實(shí)現(xiàn)功能完善的后臺(tái)管理功能。

注：當(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 實(shí)現(xiàn)
• 支持自定義圖表
• 多種常用 web 組件
• 支持本地和 oss 文件上傳

有了這些功能，開發(fā)一個(gè)后臺(tái)管理系統(tǒng)就變得相對(duì)簡單了。

安裝插件：

composer require encore/laravel-admin "1.5.*"

// 發(fā)布資源：
php artisan vendor:publish --provider="Encore\Admin\AdminServiceProvider"

// 安裝
php artisan admin:install

簡單的三條命令，即可配置好一個(gè)簡單的后臺(tái)管理系統(tǒng)，賬號(hào)和密碼都是 admin

代碼主要集中在\APP\Admin中

默認(rèn)系統(tǒng)提供一個(gè) 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é)合界面和代碼，可以看出界面主要分成這么幾個(gè)部分：header、description、兩個(gè) row，后一個(gè) row 包含三個(gè) 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/

寫一個(gè) demo

有了這個(gè) laravel-admin 插件，要寫一個(gè) movies 列表，只需要幾個(gè)命令行就可以完成了，非常簡單：

1.建立模型，并創(chuàng)建 Migrations：

php artisan make:model Movie -m 

2.在 Migrations，增加一個(gè)字段：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.運(yùn)行 Migrations，創(chuàng)建對(duì)應(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
            ]);
        }
    }
}

運(yùn)行：

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 資源的后臺(tái)管理了，在瀏覽器輸入鏈接：
http://web.app/admin/movies

就能看到一個(gè)較為完整的 movie 列表：

具體有新增、導(dǎo)出、篩選、操作 (刪除)、撤銷、分頁、修改、刪除等常規(guī)功能，如下幾個(gè)截圖：

總結(jié)

有了 Laravel 和 laravel-admin，基本不用寫什么代碼，敲敲幾個(gè)命令就可以完成一個(gè)「功能比較齊全」的資源操作后臺(tái)。極大的方便了我們的開發(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);

框架和開源插件，有時(shí)候確實(shí)是能方便我們開發(fā)，所以尋找優(yōu)質(zhì)的框架和開源庫也是促進(jìn)我們生產(chǎn)力的。

laravel-admin 代碼是如何組織的，可以具體參考網(wǎng)站開發(fā)。先根據(jù)官網(wǎng)的介紹，利用好 laravel-admin，然后學(xué)習(xí)它的源碼和代碼設(shè)計(jì)，最后取其精華，為你所用。

「完」

coding01 期待您繼續(xù)關(guān)注

qrcode

也很感謝您能看到這了

qrcode