qloog/XAdmin

:kissing_heart: admin system based on Laravel5.3

Laravel5-Backend - base Laravel5.3

此项目主要目的是为了搭建一套常用的基础服务,从而可以专注于其他的业务开发。 Theme已从原来的 ACE 升级为 AdminLTE 部分截图

Requirements

• A web server: Nginx
• PHP 5.6.4+ with the following extensions: mbstring, pdo_mysql
• MySQL
• Composer
• NPM
• CNPM 国内源，可快速安装 如何安装cnpm
• Bower
• Gulp

Installation

git clone https://github.com/qloog/laravel5-backend.git
cd laravel5-backend

// 安装后端依赖组件
composer config -g repo.packagist composer https://packagist.phpcomposer.com    // 使用composer**镜像
composer install -vvv               // 根据composer.json下载依赖包到vendor目录


// 安装前端依赖组件
cnpm install                        // install bower, gulp, laravel-elixir
bower install -V                    // 安装前端组件
npm run build                       // copy js/css/img 到public下
php artisan vendor:publish --provider='Ender\UEditor\UEditorServiceProvider' //copy ueditor to public

// 创建表及导入测试数据
vim .env                            // 修改为自己的数据库信息
php artisan migrate                 // 生成表结构
php artisan db:seed                 // 填充测试数据

// 开启server
php artisan serve --port 8001       // 运行server
open http://localhost:8001/admin/login  // 用户名: admin@test.com, 密码: 12345678

Features

• 用户管理(Done)
• 角色管理(Done)
• 权限管理(Role-Based Access Control)(Done)
• 菜单管理
• 操作管理
• 日志管理

Coding Style

• PHP：遵循PSR规范

  • PSR1 Basic Coding Standard
  • PSR2 Coding Style Guide
  • PSR3 Logger Interface
  • PSR4 Autoloading Standard
  • PSR6 Caching Interface
  • PSR7 HTTP Message Interface

Code check and fix

PHPCS 检查代码规范

// 单个文件, 可以快速查看某个文件符合PSR的情况
./vendor/bin/phpcs -p --standard=PSR2 --ignore=vendor  /path/to/file
// 目录
./vendor/bin/phpcs -p --standard=PSR2 --ignore=vendor  /path/to/dir

PHP-CS-FIXER 修复代码

遵循PSR标准的代码格式化工具php-cs-fixer。 可通过composer安装：

// 安装
composer require friendsofphp/php-cs-fixer
// 修复代码
./vendor/bin/php-cs-fixer fix app/Http/Controllers/Backend/UserController.php --level=psr2

使用文档：

• https://github.com/FriendsOfPHP/PHP-CS-Fixer#usage
• http://0x1.im/blog/php/php-cs-fixer.html

Code Document

按照phpdoc规范写注释，自动生成代码文档 phpDoc文档

Command

• 执行: php artisan make:repository Forum

结果包含:

app/Contracts/Repositories/ForumRepository.php
app/Models/Forum.php
app/Repositories/Eloquent/ForumRepositoryEloquent.php
database/migrations/2016_10_28_121408_create_forums_table.php

Tips

• 尽量使用依赖注入,尤其在控制器里,具体如Laravel文档中：依赖注入和控制器, php依赖注入简介
• Laravel 5.1 LTS 中文文档

参看：PHP之道

ScreenShot

• UI: AdminLTE (基于Bootstrap)

...

Issue

• 欢迎发 issues 交流讨论
• QQ交流群：32649336

Thanks

• Site
  • PHPHub
  • LaraBase
  • Laravel.So
  • Laravel 学院
• Project
  • BootstrapCMS/CMS
  • yccphp/laravel-5-blog
  • yuansir/laravel5-rbac-example
  • rappasoft/laravel-5-boilerplate
• PHP Package
  • zizaco/entrust
  • orangehill/iseed
  • arcanedev/log-viewer
  • barryvdh/laravel-debugbar
  • barryvdh/laravel-ide-helper
• Javascript Package
  • admin-lte
  • sweetalert
  • ztree

License

The laravel5-backend is open-sourced software licensed under the MIT license