## 下載
- 碼云: [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