Skip to content

Commit

Permalink
安装说明
Browse files Browse the repository at this point in the history
  • Loading branch information
jqhph committed Nov 11, 2018
1 parent d326b42 commit 9e19237
Show file tree
Hide file tree
Showing 2 changed files with 102 additions and 15 deletions.
17 changes: 11 additions & 6 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,11 +1,11 @@
# swoft-admin

`Swoft Admin`是基于`swoft`框架开发而成的后台系统快速构建工具,使用极少的代码即可构建出一个功能完善的后台系统,性能强悍、代码简洁、易扩展。
`Swoft Admin`是基于[swoft](https://github.com/swoft-cloud/swoft)框架开发而成的后台系统快速构建工具,使用极少的代码即可构建出一个功能完善的后台系统,性能强悍、代码简洁、易扩展。

>本项目基于[laravel-admin](http://laravel-admin.org/)重构而成,保留了基本的代码架构和大部分api。主要改动如下:
>+ 分离了页面构建层和数据层(移除了对框架orm的强绑定)
>+ 解决了`pjax`按需加载问题
>+ 调整了部分api的用法
>+ 调整了部分api的用法,使用更方便
[Demo](http://103.45.104.52:8000)|[文档]()

Expand All @@ -27,10 +27,6 @@
+ 支持数据库版本迁移管理
+ 基于[league/flysystem](http://flysystem.thephpleague.com/docs/)上传文件,可以轻松实现远程上传及云服务上传

## Demo

[Demo](http://103.45.104.52:8000)


## 后端依赖组件

Expand Down Expand Up @@ -62,6 +58,15 @@
```
composer require lldca/swoft-admin
```
然后打开`@root/config/properties/app.php`文件,加上注解扫描配置
```php
'bootScan' => [
// 必须加上
'Swoft\Admin\Controllers',
'Swoft\Admin\Bootstrap',
'Swoft\Admin\Console',
],
```


确保拥有 `@root/config/properties``@root/resources``@root/public`目录的写权限,然后运行
Expand Down
100 changes: 91 additions & 9 deletions docs/zh/README.md
Original file line number Diff line number Diff line change
@@ -1,12 +1,13 @@
# swoft-admin

`Swoft Admin`是基于`swoft`框架开发而成的后台系统快速构建工具,使用极少的代码即可构建出一个功能完善的后台系统,性能强悍、代码简洁清晰、易扩展。
`Swoft Admin`是基于[swoft](https://github.com/swoft-cloud/swoft)框架开发而成的后台系统快速构建工具,使用极少的代码即可构建出一个功能完善的后台系统,性能强悍、代码简洁、易扩展。

>本项目基于[laravel-admin](http://laravel-admin.org/)二次开发而成,保留了基本的代码架构和大部分api。主要改动如下:
>1.分离了页面构建层和数据层(移除了对框架orm的强绑定)
>2.解决了`pjax`按需加载问题
>3.以及部分api的使用体验优化
>本项目基于[laravel-admin](http://laravel-admin.org/)重构而成,保留了基本的代码架构和大部分api。主要改动如下:
>+ 分离了页面构建层和数据层(移除了对框架orm的强绑定)
>+ 解决了`pjax`按需加载问题
>+ 调整了部分api的用法,使用更方便
[Demo](http://103.45.104.52:8000)|[文档]()

## 环境
+ PHP 7.0 +
Expand All @@ -26,9 +27,6 @@
+ 支持数据库版本迁移管理
+ 基于[league/flysystem](http://flysystem.thephpleague.com/docs/)上传文件,可以轻松实现远程上传及云服务上传

## Demo

[http://103.45.104.52:8000](http://103.45.104.52:8000)

## 后端依赖组件

Expand All @@ -40,7 +38,7 @@

## 前端依赖组件
> 注意,为解决前端pjax按需加载功能,本项目修改了`pjax`的代码,请勿升级
> 同样,为优化按钮布局,`RWD-Table-Patterns`的代码也是修改过后的,请勿升级
> 同样,为优化按钮布局,`RWD-Table-Patterns`的代码也进行了微调,请勿升级
+ [AdminLTE](https://almsaeedstudio.com/)
+ [RWD-Table-Patterns](http://gergeo.se/RWD-Table-Patterns/)
+ [Datetimepicker](http://eonasdan.github.io/bootstrap-datetimepicker/)
Expand All @@ -56,6 +54,90 @@
+ [bootstrap-number-input](https://github.com/wpic/bootstrap-number-input)
+ [fontawesome-iconpicker](https://github.com/itsjavi/fontawesome-iconpicker)

## 安装
```
composer require lldca/swoft-admin
```
然后打开`@root/config/properties/app.php`文件,加上注解扫描配置
```php
'bootScan' => [
// 必须加上
'Swoft\Admin\Controllers',
'Swoft\Admin\Bootstrap',
'Swoft\Admin\Console',
],
```


确保拥有 `@root/config/properties``@root/resources``@root/public`目录的写权限,然后运行

```bash
php bin/swoft admin:install
```
运行完命令打开 `@root/config/properties/app.php`配置文件,检查文件末尾是否增加了以下配置,如缺少其中某些字段,手动增加即可。
```php
'components' => [
'custom' => [
'Swoft\Admin',
'Swoft\Blade'
],
],
/*
| 静态资源帮助工具配置
|
*/
'assets' => [
// 静态资源域名配置
'resource-server' => env('ASSETS_SERVER'),

// js文件请求后缀
'js-version' => '',

// css文件请求后缀
'css-version' => '',

// 静态资源别名配置
'alias' => [

],
],

/*
| blade 模板引擎配置
*/
'blade-view' => [
'path' => '@root/resources/views',
'compiled' => '@root/runtime/views',
// 视图命名空间
'namespaces' => [

],
],

'admin' => require __DIR__ . '/admin.php',
```

以上全部完成后需要进入`@root/config/beans/base.php`中加入如下配置开启session功能方可正常使用:
```
'serverDispatcher' => [
'middlewares' => [
Swoft\Session\Middleware\SessionMiddleware::class,
]
],
'sessionManager' => [
'class' => \Swoft\Session\SessionManager::class,
'config' => [
'driver' => 'file',
'name' => 'SWOFT_SESSION_ID',
'lifetime' => 1800,
'expire_on_close' => false,
'encrypt' => false,
'storage' => '@runtime/sessions',
],
],
```


## 加入我们
如果你对此项目有兴趣,欢迎加入我们。
欢迎大家提建议和pr。
Expand Down

0 comments on commit 9e19237

Please sign in to comment.