## 下载
- 码云: [git@gitee.com:evan-li/super-php.git](https://gitee.com/evan-li/super-php)
> 如果要协助开发, 请联系 [574583177@qq.com](574583177@qq.com)
## 安装方式
1. git 安装
1. git clone 代码仓库
```
git clone git@gitee.com:evan-li/super-php.git
```
2. 修改env环境变量, 将根目录下`.env.example` 文件复制为`.env`, 并修改对应的环境变量, 如数据库等配置
3. 安装`php`依赖
cd super-php
composer install
4. 安装并编译前端资源
# 切换到前端资源目录
cd resources/admin_v3
# 安装npm依赖
npm install
# 编译前端资源
npm run build
# 或执行dev模式调试前端组件
npm run dev
> 如前端资源未变动, 可不编译前端资源, 框架内置了编译好的前端资源。以便于不需要修改前端资源的开发人员可以不安装node环境。
2. 手动安装
1. 下载代码库后, 将构建器放入extra目录, `application`下的 `system`与`common`模块放入项目的`application`目录
2. route/route.php文件添加路由:
```
Route::any('/', 'index.html');
```
> 此路由为后台页面入口
3. index.php文件中增加定义控制器层级代码
~~~
if(strpos($_SERVER['HTTP_HOST'], 'admin') === 0 ) {
// 定义控制器层目录
define('SITE_NAME', 'admin');
// 定义控制器层目录,若不定义则默认使用站点名作为目录名
define('URL_CONTROLLER_LAYER', 'admin');
}else if(strpos($_SERVER['HTTP_HOST'], 'api') === 0 ) { // 修改api端控制器层目录
// 定义控制器层目录
define('SITE_NAME', 'api');
// 定义控制器层目录,若不定义则默认使用站点名作为目录名
define('URL_CONTROLLER_LAYER', 'api');
}else {
// 定义控制器层目录
define('SITE_NAME', 'home');
// 定义控制器层目录,若不定义则默认使用站点名作为目录名
define('URL_CONTROLLER_LAYER', 'controller');
}
~~~
> 可根据自己需要定义, 此处默认使用controller作为控制器层目录
4. 配置修改
- app.php配置文件 修改 `url_controller_layer`:
~~~
'url_controller_layer' => defined('URL_CONTROLLER_LAYER') ? URL_CONTROLLER_LAYER : (defined('SITE_NAME') ? SITE_NAME : 'home'),
~~~
- 修改`exception_handle`:
~~~
'exception_handle' => \app\common\exception\Handle::class,
~~~
- 添加 `admin.php` 配置文件
- 添加 `filesystem.php` 配置文件
- 修改数据库配置
- 序言
- 下载及安装
- 目录结构
- 基础
- 多站点-单入口文件(推荐)
- (旧)多站点-多入口文件方式
- (旧)入口文件
- (旧)站点配置
- 按钮操作
- 区块概念
- 构建器(SBuilder)
- 页面-Page
- 设置页面标题
- 添加页面提示信息
- 设置页面Tab
- 设置页面背景色
- 设置是否点击遮罩关闭
- 添加区块
- 区块-Block
- 设置区块名
- 设置区块布局
- 表单(form)
- 添加表单项通用方法
- 添加表单项
- 单行文本框
- 多行文本框
- 数字输入框
- 密码框
- 数组输入框
- 单选框
- 状态选择器
- 复选框
- 下拉框
- 级联选择器
- 开关
- 日期选择器
- 日期时间选择器
- 日期范围选择器
- 日期时间范围选择器
- 时间选择器
- 时间范围选择器
- Tree 树形组件
- 图标选择器
- 颜色选择器
- 单图片上传
- 多图片上传
- 视频上传
- 单文件上传
- 多文件上传
- 富文本编辑器-QEditor
- 富文本编辑器-UEditor
- 小程序富文本
- 静态文本
- 隐藏表单项
- 表格数据输入框
- 分组
- 地图选择器(未实现)
- 地区选择器(未实现)
- 穿梭框(未实现)
- 图片裁剪(未实现)
- 邮箱输入框(未实现)
- 设置表单LabelWidth
- 设置表单提交地址
- 设置默认按钮标题
- 提交表单确认框
- 隐藏默认按钮
- 添加额外按钮
- 设置触发器
- 设置表单数据
- 表单布局
- 模板
- 表格(table)
- 设置表名
- 添加顶部按钮
- 添加时间段筛选
- 设置搜索栏
- 添加列
- text
- byte
- status
- tags
- yesno
- datetime
- icon
- image
- images
- external_image[已废弃]
- external_images[已废弃]
- link
- html
- select
- text.edit
- group
- 多选框栏
- 数量索引栏
- 操作栏
- 右侧操作按钮
- 设置多选框
- 设置显示数量索引
- 设置列表数据地址
- 直接设置数据
- 关闭ajax获取数据功能
- 设置分页
- 自动新增
- 自动编辑
- 图表(Charts)
- Html
- Iframe
- 数据面板
- 卡片列表
- 按钮(Button)
- 按钮调用示例
- 自定义组件
- 混合页面
- 概念说明
- 扩展
- 图标扩展
- 杂项
- 帮助函数
- TODO