/XAdmin

:kissing_heart: admin system based on Laravel5.3

Primary LanguagePHP

Laravel5-Backend - base Laravel5.3

Build Status Software License

此项目主要目的是为了搭建一套常用的基础服务,从而可以专注于其他的业务开发。 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

使用文档:

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

参看:PHP之道

ScreenShot

登录页面 角色页面 添加新闻页面 ...

Issue

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

Thanks

License

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