快速開始laravel項目，集成了laravel-admin，日誌， 調試， 圖片上傳等第三方包。

時間  2019-12-01
標籤 快速 開始 laravel 項目 集成 admin 日誌 調試 圖片 上傳 第三方 简体版
原文   原文鏈接

代碼已放在 github 上，歡迎參考和提出 issue：laravel-quick-start github地址php

環境+包

一共須要安裝的包mysql

// 不須要手動引入服務提供者
"arcanedev/log-viewer": "^4.3",
// 不須要手動引入服務提供者
"barryvdh/laravel-debugbar": "^2.4",
// 不須要手動引入服務提供者
"encore/laravel-admin": "1.4.*",
// 不須要手動引入服務提供者
"laracasts/flash": "^3.0",
// 不須要手動引入服務提供者
"predis/predis": "^1.1",
// 不須要手動引入服務提供者
"prettus/l5-repository": "^2.6",
// 不須要手動引入服務提供者
"zgldh/qiniu-laravel-storage": "^0.7.0"
// 不須要手動引入服務提供者
"spatie/laravel-backup": "^4.18",
// 不須要手動引入服務提供者
"intervention/image": "^2.4",
// 不須要手動引入服務提供者
"maatwebsite/excel": "^2.1",
// 直接安裝
"doctrine/dbal": "^2.5",
// 直接安裝
"spatie/eloquent-sortable": "^3.3",


/**
 * tian 引入 `axdlee/laravel-config-writer`【生成配置文件】-能夠不要
 */
Axdlee\Config\ConfigServiceProvider::class,
"axdlee/laravel-config-writer": "^1.0",
"hassankhan/config": "^0.10.0",
複製代碼

初始化項目

laravel new 項目名
複製代碼

修改時區

config/app.php 裏面修改時區laravel

'timezone' => 'UTC',

改成

'timezone' => 'RPC',
複製代碼

將 session 存在 redis 中

  • 安裝包 composer require predis/predisgit

  • 在 config\database.php 中的 redis 添加github

// tian add session saved to redis
'session' => [
    'host'     => env('REDIS_HOST', 'localhost'),
    'password' => env('REDIS_PASSWORD', null),
    'port'     => env('REDIS_PORT', 6379),
    'database' => 1,
],
複製代碼
  • 在 config\session.php 中修改
// tian add session saved to redis
// 'connection' => null,
'connection' => 'session',
複製代碼
  • 在 .env 裏面修改
# tian add session saved to redis
SESSION_DRIVER=redis
複製代碼

引入自定義類和函數

引入自定義類web

在 app 目錄下新建文件夾 Classesredis

原本是須要在 composer.json 裏面引入, 可是由於是在 app 目錄下面 psr-4 了因此不須要sql

"autoload": {
        "classmap": [
            "database",
            "app/Classes"// 這行, 引入自定義類
        ],
        "psr-4": {
            "App\\": "app/"
        },
        "files": [
            "app/helpers.php"// 這行, 引入自定義函數
        ]
    },
複製代碼

引入自定義函數數據庫

在 app 目錄下新建文件 helpers.phpjson

使用 laravel-admin

  • 安裝 composer require encore/laravel-admin

  • 而後運行下面的命令來發布資源：php artisan vendor:publish --provider="Encore\Admin\AdminServiceProvider"

  • 自定義(重載) 修改默認的 9 張表, 在 config/admin.php 裏的 database 的表名加上 laravel_ 前綴.

  • 防止執行數據遷移報錯, 先解決字符長度問題

  • 安裝 php artisan admin:install

Migration table created successfully.
Migrating: 2014_10_12_000000_create_users_table
Migrated:  2014_10_12_000000_create_users_table
Migrating: 2014_10_12_100000_create_password_resets_table
Migrated:  2014_10_12_100000_create_password_resets_table
Migrating: 2016_01_04_173148_create_admin_tables
Migrated:  2016_01_04_173148_create_admin_tables
Admin directory was created: \app\Admin
HomeController file was created: \app\Admin/Controllers/HomeController.php
ExampleController file was created: \app\Admin/Controllers/ExampleController.php

Bootstrap file was created: \app\Admin/bootstrap.php
Routes file was created: \app\Admin/routes.php
複製代碼
  • 配置圖片圖片上傳, 配置 config/filesystems.php
'admin' => [
    'driver' => 'local',
    'root' => public_path('uploads'),
    'visibility' => 'public',
    'url' => env('APP_URL').'/uploads',
],
複製代碼
  • 自定義視圖目錄

複製 vendor/encore/laravel-admin/resources/views 到項目的 resources/views/laravel-admin，而後在 app/Admin/bootstrap.php 文件中加入代碼：app('view')->prependNamespace('admin', resource_path('views/laravel-admin'));

  • 自定義語言包

複製 vendor/encore/laravel-admin/lang 到項目的 resources/lang/laravel-admin，而後在 app/Admin/bootstrap.php 文件中加入代碼：app('translator')->addNamespace('admin', resource_path('lang/laravel-admin'));

/**
 * 忽略 `map`, `editor` 控件
 */
Encore\Admin\Form::forget(['map', 'editor']);

/**
 * 修改命名空間
 */
// tian 修改 `laravel-admin` view, 便於修改, 這樣就不須要動 `laravel-admin` 的源碼。複製 `vendor/encore/laravel-admin/views` 到項目的 `resources/views/laravel-admin`
app('view')->prependNamespace('admin', resource_path('views/laravel-admin'));
// tian 修改 `laravel-admin` 的語言包, 複製 `vendor/encore/laravel-admin/lang` 到項目的 `resources/lang/admin`。若是將系統語言locale設置爲 `zh-cn`, 能夠將 `resources/lang/admin` 目錄下的 `zh_CN` 目錄重命名爲 `zh-cn` 便可
app('translator')->addNamespace('admin', resource_path('lang/laravel-admin'));
複製代碼

laravel-admin 要作的修改:

#### 自定義(重載)

##### 修改默認的 9 張表

在 config/admin.php 裏的 database 的表名加上 laravel_ 前綴

##### 關於自定義視圖

複製 vendor/encore/laravel-admin/resources/views 到項目的 resources/views/laravel-admin，而後在 app/Admin/bootstrap.php 文件中加入代碼：

app('view')->prependNamespace('admin', resource_path('views/laravel-admin'));
複製代碼

這樣就用 resources/views/admin 下的視圖覆蓋了 laravel-admin 的視圖，要注意的問題是，更新 laravel-admin 的時候，若是遇到視圖方面的問題，須要從新複製 vendor/encore/laravel-admin/views 到項目的 resources/views/admin 中，注意備份原來已經修改過的視圖。

##### 設置語言

完成安裝以後，默認語言爲英文 (en) ，若是要使用中文，打開 config/app.php，將 locale 設置爲 zh-CN便可。

##### 自定義語言

若是須要修改 laravel-admin 的語言包，能夠用下面的方式解決, 複製 vendor/encore/laravel-admin/lang 到項目的 resources/lang/admin，而後在 app/Admin/bootstrap.php 文件中加入代碼：

app('translator')->addNamespace('admin', resource_path('lang/admin'));
複製代碼

若是將系統語言 locale 設置爲 zh-CN，能夠將 resources/lang/admin 目錄下的 zh_CN 目錄重命名爲 zh-CN 便可，更新 laravel-admin 的時候，要作相應修改。

##### 更新靜態資源

若是遇到更新以後,部分組件不能正常使用,那有多是 laravel-admin 自帶的靜態資源有更新了,因此須要手動去用 vendor/encore/laravel-admin/assets 的靜態資源覆蓋掉 public/packages 目錄下的靜態資源文件,覆蓋完成以後不要忘記清理瀏覽器緩存.

##### 自定義登錄頁面和登錄邏輯

在路由文件 app/Admin/routes.php 中，覆蓋掉登錄頁面和登錄邏輯的路由，便可實現自定義的功能

Route::group([
    'prefix'        => config('admin.prefix'),
    'namespace'     => Admin::controllerNamespace(),
    'middleware'    => ['web', 'admin'],
], function (Router $router) {

    $router->get('auth/login', 'AuthController@getLogin');
    $router->post('auth/login', 'AuthController@postLogin');

});
複製代碼

在自定義的路由器 AuthController 中的 getLogin、postLogin 方法裏分別實現本身的登錄頁面和登錄邏輯。

使用日誌包 arcanedev/log-viewer

  • composer require arcanedev/log-viewer

  • 自動引入服務提供者, 因此不須要添加 providers

  • php artisan log-viewer:publish

__                   _
  / /  ___   __ _/\   /(_) _____      _____ _ __
 / /  / _ \ / _` \ \ / / |/ _ \ \ /\ / / _ \ '__| / /__| (_) | (_| |\ V /| | __/\ V V / __/ | \____/\___/ \__, | \_/ |_|\___| \_/\_/ \___|_| |___/ Version 4.5.1 - Created by ARCANEDEV� Copied File [\vendor\arcanedev\log-viewer\config\log-viewer.php] To [\config\log -viewer.php] Copied Directory [\vendor\arcanedev\log-viewer\resources\views] To [\resources\v iews\vendor\log-viewer] Copied Directory [\vendor\arcanedev\log-viewer\resources\lang] To [\resources\la ng\vendor\log-viewer] Publishing complete. 複製代碼
  • 修改日誌級別

修改 .env 中的 LOG_CHANNEL=stack 改成爲 daily

laravel5.5及以前:

'log' => env('APP_LOG', 'single'),

'log_level' => env('APP_LOG_LEVEL', 'debug'),
複製代碼
  • 修改語言

將語言修改成中文,在 config/log-viewer.php 中的 locale='auto' 修改成 locale='zh'

  • 修改路由和中間件
'route'         => [
        'enabled'    => true,

        'attributes' => [
            // 'prefix'     => 'log-viewer',
            // 修改路由前綴
            'prefix'     => 'admin/log-viewer',

            // 'middleware' => env('ARCANEDEV_LOGVIEWER_MIDDLEWARE') ? explode(',', env('ARCANEDEV_LOGVIEWER_MIDDLEWARE')) : null,
            // 修改中間件, 或者直接在 `.env` 裏面改成：
ARCANEDEV_LOGVIEWER_MIDDLEWARE=web,admin,admin.bootstrap,admin.pjax,admin.log,admin.bootstrap,admin.permission
            'middleware' => ['web', 'admin', 'admin.bootstrap', 'admin.pjax', 'admin.log', 'admin.bootstrap', 'admin.permission'],
        ],
    ],
複製代碼
  • 訪問

原連接: http://127.0.0.1:8000/log-viewer

改路由前綴後: http://127.0.0.1:8000/admin/log-viewer

使用調試包 barryvdh/laravel-debugbar

  • composer require barryvdh/laravel-debugbar

  • Barryvdh\Debugbar\ServiceProvider::class,【不須要了, 自動引入服務提供者】

  • 'Debugbar' => Barryvdh\Debugbar\Facade::class,【不須要 alias, 自動引入了】

  • php artisan vendor:publish --provider="Barryvdh\Debugbar\ServiceProvider"

Copied File [\vendor\barryvdh\laravel-debugbar\config\debugbar.php] To [\config\
debugbar.php]
Publishing complete.
複製代碼
  • 非調試環境下,關閉debug,將 .env=true 改成 .env=false ,默認debug是開啓狀態.

數據庫備份 spatie/laravel-backup

  • composer require spatie/laravel-backup

  • 自動引入服務提供者

  • php artisan vendor:publish --provider="Spatie\Backup\BackupServiceProvider"

Copied File [\vendor\spatie\laravel-backup\config\backup.php] To [\config\backup
.php]
Copied Directory [\vendor\spatie\laravel-backup\resources\lang] To [\resources\l
ang\vendor\backup]
Publishing complete.
複製代碼

  • 用這個包, 須要安裝 composer require guzzlehttp/guzzle , 由於須要用到請求

  • 若是要備份到 自定義目錄 能夠進行一下配置

app/config/filesystems.php:

'disks'   => [

    // 添加laravel-backup備份文件目錄
    'backup' => [
        'driver'     => 'local',
        'root'       => env('BACKUP_PATH'),
        'visibility' => 'public',
    ], 
],
複製代碼

app/config/laravel-backup.php:

'destination' => [

	/*
	* The disk names on which the backups will be stored. 
	*/
	'disks' => [
	    // 'local',
	    'backup',
	    //'admin',
	],
],
複製代碼
  • 命令說明

若是要備份到特定磁盤而不是全部磁盤，請運行：

php artisan backup:run --only-to-disk=name-of-your-disk
複製代碼

備份文件和數據庫:

php artisan backup:run
複製代碼

只備份db:

php artisan backup:run --only-db
複製代碼

只備份文件:

php artisan backup:run --only-files
複製代碼

清理備份:

php artisan backup:clean
複製代碼

查看全部受監視的目標文件系統的狀態:

php artisan backup:list
複製代碼
'monitorBackups' => [
        [
            'name' => config('app.name'),
            'disks' => ['local'],
            'newestBackupsShouldNotBeOlderThanDays' => 1,
            'storageUsedMayNotBeHigherThanMegabytes' => 5000,
        ],

        /*
        [
            'name' => 'name of the second app',
            'disks' => ['local', 's3'],
            'newestBackupsShouldNotBeOlderThanDays' => 1,
            'storageUsedMayNotBeHigherThanMegabytes' => 5000,
        ],
        */
    ],
複製代碼

引入自定義路由-(由於代碼是自動吐出的, 路由是分目錄的)

加載 routes/web 文件夾下的路由

在 app/Providers/RouteServiceProvider.php 中

map() 方法中,添加如下代碼:

// tian add `mapCustomRoutes`
$this->mapCustomRoutes();
複製代碼

新增如下方法:

/**
     * tian add
     * Define the "Custom" routes for the application.
     *
     * These routes all receive session state, CSRF protection, etc.
     *
     * @return void
     */
    protected function mapCustomRoutes()
    {
        /**
         * 加載 routes/web 文件夾下的路由
         */
        Route::group([
            // `laravel-admin` 有的中間件 'admin.auth', 'admin.pjax', 'admin.log', 'admin.bootstrap', 'admin.permission'
            'middleware' => ['web', 'admin', 'admin.bootstrap', 'admin.pjax', 'admin.log', 'admin.bootstrap', 'admin.permission'],
            'namespace'  => 'App\Http\Controllers',
            'prefix'     => 'admin',
        ], function ($router) {
            $routePath = dirname(dirname(dirname(__FILE__))) . DIRECTORY_SEPARATOR . 'routes' . DIRECTORY_SEPARATOR . 'web';
            $this->getFilePath($routePath);
        });
    }

    /**
     * [getFilePath 遞歸遍歷文件]
     * @param  string $path [description]
     * @return [type]       [description]
     */
    protected function getFilePath($path = '.')
    {
        // opendir()返回一個目錄句柄, 失敗返回false
        $current_dir = opendir($path);
        // readdir()返回打開目錄句柄中的一個條目
        while (($file = readdir($current_dir)) !== false) {
            // 構建子目錄路徑
            $sub_dir = $path . DIRECTORY_SEPARATOR . $file;
            if ($file == '.' || $file == '..') {
                continue;
                // 若是是目錄,進行遞歸
            } else if (is_dir($sub_dir)) {
                $this->getFilePath($sub_dir);
            } else {
                if (is_dir($sub_dir)) {
                    $this->getFilePath($sub_dir);
                }
                if (is_file($sub_dir)) {
                    require_once $sub_dir;
                }
                // 若是是文件,直接輸出
                // $path = substr($path, strrpos($path, 'routes'));
                // echo base_path($path . DIRECTORY_SEPARATOR . $file) . '<br />';
                // require base_path($path . DIRECTORY_SEPARATOR . $file);
            }
        }
    }
複製代碼

安裝數據庫抽象層 prettus/l5-repository【對模型的一層封裝】

  • composer require prettus/l5-repository

  • 自動引入服務提供者

  • php artisan vendor:publish --provider "Prettus\Repository\Providers\RepositoryServiceProvider"

Copied File [\vendor\prettus\l5-repository\src\resources\config\repository.php]
To [\config\repository.php]
Publishing complete.
複製代碼

安裝提示包 laracasts/flash【提示框】

  • composer require laracasts/flash

  • 須要引入服務提供者【如今不須要了, laravel5.5後自動引入服務提供者】

  • 須要在 config/app.php 裏的 aliases 加入 Facades【不須要 alias, 自動引入了】

將提示信息能夠顯示在 laravel-admin 框架中

在 resources\views\laravel-admin\content.blade.php 裏的 <section class="content"> 下添加以下代碼:

{{-- tian add flash --}}
@include('flash::message')
複製代碼

doctrine/dbal【使用 migration 做爲數據庫的版本控制工具，當須要對已存在的數據表做更改，須要額外引入 doctrine/dbal 擴展。】

  • composer require doctrine/dbal

安裝圖像處理包 intervention/image

  • composer require intervention/image

  • 自動引入服務提供者

  • php artisan vendor:publish --provider="Intervention\Image\ImageServiceProviderLaravel5"

Copied File [\vendor\intervention\image\src\config\config.php] To [\config\image
.php]
Publishing complete.
複製代碼

請求 guzzlehttp/guzzle【發送http請求】

  • composer require guzzlehttp/guzzle

七牛雲 zgldh/qiniu-laravel-storage【選擇性安裝】

  • composer require zgldh/qiniu-laravel-storage

  • 自動引入服務提供者

excel處理 maatwebsite/excel【選擇性安裝】

  • composer require maatwebsite/excel

  • 自動引入服務提供者

  • php artisan vendor:publish --provider="Maatwebsite\Excel\ExcelServiceProvider"

模型排序 spatie/eloquent-sortable【選擇性安裝】

  • composer require spatie/eloquent-sortable

問題

問題1: 執行 php artisan migrate 後報錯 SQLSTATE[42000]: Syntax error or access violation: 1071 Specified key was too long; max key length is 767 bytes

問題分析: MySql 支持的 utf8 編碼最大字符長度爲3字節，若是遇到4字節的寬字符就會出現插入異常。三個字節UTF-8最大能編碼的Unicode字符是 0xffff，即Unicode中的基本多文種平面（BMP）。於是包括 Emoji 表情（Emoji是一種特殊的Unicode編碼）在內的非基本多文種平面的Unicode字符都沒法使用MySql的utf8字符集存儲。

這也應該就是 Laravel 5.4 改用 4 字節長度的 utf8mb4 字符編碼的緣由之一。不過要注意的是，只有MySql 5.5.3版本之後纔開始支持 utf8mb4 字符編碼（查看版本-mysql命令：SELECT VERSION( )）

解決方案: 在 AppServiceProvider 中調用 Schema::defaultStringLength 方法來實現配置

use Illuminate\Support\Facades\Schema;

/**
* Bootstrap any application services.
*
* @return void
*/
public function boot()
{
   Schema::defaultStringLength(191);
}
複製代碼
  • 問題2: 使用 laravel new yunjuji-generator 報錯 Script "post-install-cmd" is not defined in this package

解決方案: 問題不解決也能夠， 如需解決請執行 composer global update 或者 composer global require "laravel/installer"

相關文章
相關標籤/搜索
每日一句
    每一个你不满意的现在，都有一个你没有努力的曾经。
本站公眾號
   歡迎關注本站公眾號,獲取更多信息
聯繫我們 最近搜索 最新文章 沪ICP备13005482号-10 MyBatis教程 SQL 教程 MySQL教程 Java 教程 Thymeleaf 教程 Hibernate教程 Spring教程 Redis教程