推薦一個 Laravel admin 後臺管理外掛

coding01發表於2017-10-21
Laravel

如何優雅的寫程式碼，我想是每位程式設計師的心聲。自從15年初第一次接觸 Laravel 4.2 開始，我就迷上使用 Laravel 框架了。我一直都想找個時間好好寫寫有關 Laravel 的使用文章，由淺入深的介紹 Laravel 框架。

今天通過使用 laravel-admin 外掛，來簡單說說怎麼優雅的寫 Laravel 程式碼。

建立 Laravel 專案

只要跟著官方文件走，建立一個 Laravel 專案還是很簡單的：

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

// 建立 web 專案
laravel new web複製程式碼

具體配置資料庫等：略

安裝 Laravel 看官網：d.laravel-china.org/docs/5.5/in…

如何安裝 Composer，可以看看我之前的文章 一步一步搭建 PHP 伺服器環境

安裝 laravel-admin

laravel-admin 是一個可以快速幫你構建後臺管理的工具，它提供的頁面元件和表單元素等功能，能幫助你使用很少的程式碼就實現功能完善的後臺管理功能。

注：當前版本(1.5)需要安裝 PHP 7+和 Laravel 5.5

看看 laravel-admin 的特性：

  • 內建使用者和許可權系統
  • model-grid 支援快速構建資料表格
  • model-form 支援快速構建資料表單
  • model-tree 支援快速構建樹狀資料
  • 內建 40+ 種 form 元素元件、以及支援擴充套件元件
  • 支援 Laravel 的多種模型關係
  • mysql、mongodb、pgsql 等多資料庫支援
  • 支援引入第三方前端庫
  • 資料庫和 artisan 命令列工具的 web 實現
  • 支援自定義圖表
  • 多種常用 web 元件
  • 支援本地和 oss 檔案上傳

有了這些功能，開發一個後臺管理系統就變得相對簡單了。

安裝外掛：

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

// 釋出資源：
php artisan vendor:publish --provider="Encore\Admin\AdminServiceProvider"

// 安裝
php artisan admin:install複製程式碼

簡單的三條命令，即可配置好一個簡單的後臺管理系統，賬號和密碼都是 admin

程式碼主要集中在\APP\Admin中

預設系統提供一個 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());
                });
            });
        });
    }
}複製程式碼

結合介面和程式碼，可以看出介面主要分成這麼幾個部分：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

其它的靜態資原始檔放在 /public/vendor/laravel-admin 目錄下

更多內容參考 laravel-admin 官網：
laravel-admin.org/docs/#/zh/

寫一個 demo

有了這個 laravel-admin 外掛，要寫一個 movies 列表，只需要幾個命令列就可以完成了，非常簡單：

1.建立模型，並建立 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，建立對應資料庫：

php artisan migrate複製程式碼

4.有了資料表，就需要往表裡插入 fake 資料，用於測試

// 使用該外掛建立 fake 資料
composer require fzaninotto/faker複製程式碼

5.建立 Seeder

php artisan make:seeder MovieTableSeeder複製程式碼

在該類中，建立1000條假資料：

<?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複製程式碼

是不是很簡單，資料表直接填充 1000 條假資料：

6.建立資源 Controller

php artisan admin:make MovieController --model=App\\Movie複製程式碼

這樣就直接有了基礎的增刪改查和 movie 列表功能的 Controller 了。

7.建立 route

$router->resource('movies', MovieController::class);複製程式碼

8.加入到 admin 的 menu 中

其中路徑處需要注意的是：

其中uri填寫不包含路由字首的的路徑部分，比如完整路徑是http://localhost:8000/admin/demo/users, 那麼就填demo/users，如果要新增外部連結，只要填寫完整的url即可，比如laravel-admin.org/.

上圖也是加了左側 movies 選單的效果。

這就完成了簡單的 movie 資源的後臺管理了，在瀏覽器輸入連結：
web.app/admin/movie…

就能看到一個較為完整的 movie 列表：

具體有新增、匯出、篩選、操作 (刪除)、撤銷、分頁、修改、刪除等常規功能，如下幾個截圖：

總結

有了 Laravel 和 laravel-admin，基本不用寫什麼程式碼，敲敲幾個命令就可以完成一個「功能比較齊全」的資源操作後臺。極大的方便了我們的開發。

總體命令列和程式碼如下

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);複製程式碼

框架和開源外掛，有時候確實是能方便我們開發，所以尋找優質的框架和開源庫也是促進我們生產力的。

laravel-admin 程式碼是如何組織的，可以具體參考網站開發。先根據官網的介紹，利用好 laravel-admin，然後學習它的原始碼和程式碼設計，最後取其精華，為你所用。

「完」

coding01 期待您繼續關注

qrcode
qrcode

也很感謝您能看到這了

qrcode
qrcode

相關文章