本框架的公共函數在:`application\common.php`
如果是自定義公共函數,請寫在:`application\function.php`
以下列舉部分函數,具體用法及其他函數請參考源碼。
## is_signin
>[info] 含義:判斷是否登錄
返回:0或用戶id
## get_file_path($id)
>[info] 含義:獲取附件路徑
返回:附件路徑,如果無附件,則返回一張空圖片路徑
| 參數 | 類型 | 含義 |
| --- | --- | --- |
| $id | int | 附件id |
## get_files_path($ids)
>[info] 含義:批量獲取附件路徑
返回:附件路徑
| 參數 | 類型 | 含義 |
| --- | --- | --- |
| $id | array | 附件id |
## get_file_name
>[info] 含義:獲取附件名稱
返回:附件名稱
| 參數 | 類型 | 含義 |
| --- | --- | --- |
| $id | int | 附件id |
## get_thumb
>[info] 含義:獲取附件縮略圖路徑
返回:縮略圖路徑,如果無縮略圖,則返回原圖路徑
| 參數 | 類型 | 含義 |
| --- | --- | --- |
| $id | int | 附件id |
## get_avatar
>[info] 含義:獲取用戶頭像路徑
返回:頭像路徑,如果無頭像,則返回默認頭像路徑
| 參數 | 類型 | 含義 |
| --- | --- | --- |
| $uid | int | 用戶id,不傳該參數則獲取當前用戶id |
## parse_attr
>[info] 含義:解析配置,按每行為一個數組元素組合成數組
返回:數組
| 參數 | 類型 | 含義 |
| --- | --- | --- |
| $value | string | 配置值 |
## parse_array
>[info] 含義:將一維數組解析成鍵值相同的數組
返回:數組
| 參數 | 類型 | 含義 |
| --- | --- | --- |
| $arr | array | 一維數組 |
## hook
>[info] 含義:監聽鉤子
返回:無
| 參數 | 類型 | 含義 |
| --- | --- | --- |
| $name | string | 鉤子名稱 |
| $params | string | 傳入參數 |
| $extra | string | 額外參數 |
| $once | string | 只獲取一個有效返回值 |
## module_config
>[info] 含義:顯示模塊配置頁面,或獲取或設置插件配置
返回:mixed
具體用法,請參考模塊開發中的[方法參考](方法參考.md)
## plugin_menage
>[info] 含義:顯示插件的管理頁面
返回:mixed
具體用法請參考[方法參考](插件-方法參考.md)
## plugin_config
>[info] 含義:獲取或設置某個插件配置參數
返回:mixed
具體用法請參考[方法參考](插件-方法參考.md)
## plugin_action
>[info] 含義:執行插件動作
返回:mixed
具體用法請參考[方法參考](插件-方法參考.md)
## plugin_action_exists
>[info] 含義:檢查插件控制器是否存在某操作
返回:bool
| 參數 | 類型 | 含義 |
| --- | --- | --- |
| $name | string | 插件名 |
| $controller | string | 控制器 |
| $action | string | 動作 |
## plugin_model_exists
>[info] 含義:檢查插件模型是否存在
返回:bool
| 參數 | 類型 | 含義 |
| --- | --- | --- |
| $name | string | 插件名 |
## plugin_validate_exists
>[info] 含義:檢查插件驗證器是否存在
返回:bool
| 參數 | 類型 | 含義 |
| --- | --- | --- |
| $name | string | 插件名 |
## get_plugin_validate
>[info] 含義:獲取插件驗證類實例
返回:object
| 參數 | 類型 | 含義 |
| --- | --- | --- |
| $name | string | 插件名 |
## get_plugin_model
>[info] 含義:獲取插件模型實例
返回:object
| 參數 | 類型 | 含義 |
| --- | --- | --- |
| $name | string | 插件名 |
## get_plugin_class
>[info] 含義:獲取插件類名
返回:string
## plugin_url
>[info] 含義:生成插件操作鏈接
返回:string
| 參數 | 類型 | 含義 |
| --- | --- | --- |
| $url | string | 鏈接:插件名稱/控制器/操作 |
| $param | array | 參數 |
| $module | string | admin需要登錄驗證,index不需要登錄驗證 |
## public_url
>[info] 含義:生成插件操作鏈接(不需要登陸驗證)
返回:string
| 參數 | 類型 | 含義 |
| --- | --- | --- |
| $url | string | 鏈接:插件名稱/控制器/操作 |
| $param | array | 參數 |
## get_client_ip
>[info] 含義:獲取客戶端IP地址
返回:mixed
| 參數 | 類型 | 含義 |
| --- | --- | --- |
| $type | int | 返回類型 0 返回IP地址 1 返回IPV4地址數字 |
| $adv | bool | 是否進行高級模式獲取 |
## format_bytes
>[info] 含義:格式化字節大小
返回:string
| 參數 | 類型 | 含義 |
| --- | --- | --- |
| $size | int | 字節數 |
| $delimiter | string | 數字和單位分隔符 |
## format_time
>[info] 含義:時間戳格式化
返回:string
| 參數 | 類型 | 含義 |
| --- | --- | --- |
| $time | int | 時間戳 |
| $format | string | 輸出格式,默認為Y-m-d H:i |
## format_linkage
>[info] 含義:格式化聯動數據,array('a', 'b')將格式化為array(array('key' => 0, 'value' => 'a'), array('key' => 1, 'value' => 'b'))
返回:string
| 參數 | 類型 | 含義 |
| --- | --- | --- |
| $data | array | 要格式化的數據 |
## get_auth_node
>[info] 含義:獲取用戶的數據授權節點
返回:array|bool
| 參數 | 類型 | 含義 |
| --- | --- | --- |
| $uid | int | 用戶id |
| $group | string | 權限分組,可以以點分開模型名稱和分組名稱,如user.group |
## check_auth_node
>[info] 含義:檢查用戶的某個節點是否授權
返回:bool
| 參數 | 類型 | 含義 |
| --- | --- | --- |
| $uid | int | 用戶id |
| $group | string | 權限分組,可以以點分開模型名稱和分組名稱,如user.group |
| $node | int | 需要檢查的節點id |
## get_nickname
>[info] 含義:獲取用戶昵稱
返回:string
| 參數 | 類型 | 含義 |
| --- | --- | --- |
| $uid | int | 用戶id |
## action_log
>[info] 含義:記錄行為日志,并執行該行為的規則
返回:bool|string
| 參數 | 類型 | 含義 |
| --- | --- | --- |
| $action | string | 行為標識 |
| $model | string | 觸發行為的模型名 |
| $record_id | int | 觸發行為的記錄id |
| $user_id | int | 執行行為的用戶id |
| $details | string | 詳情 |
## get_location
>[info] 含義:獲取當前位置
返回:array
## packet_exists
>[info] 含義:查詢數據包是否存在,即是否已經安裝
返回:array
| 參數 | 類型 | 含義 |
| --- | --- | --- |
| $name | string | 數據包名 |
## load_assets
>[info] 含義:返回靜態資源路徑代碼,可用于模板
返回:string
| 參數 | 類型 | 含義 |
| --- | --- | --- |
| $assets | string | 資源名稱 |
| $type | string | 資源類型:css或js |
## parse_name
>[info] 含義:字符串命名風格轉換
返回:string
| 參數 | 類型 | 含義 |
| --- | --- | --- |
| $name | string | 字符串 |
| $type | string | 轉換類型,0 將Java風格轉換為C的風格 1 將C風格轉換為Java的風格 |
## index_url(1.0.4+)
>[info] 含義:生成前臺入口url
返回:string
用法和ThinkPHP自帶的url方法一致,參數也一致。
>[danger] 注意:1.0.5以后,請使用home_url()代替index_url()
## admin_url(1.0.4+)
>[info] 含義:生成后臺入口url
返回:string
用法和ThinkPHP自帶的url方法一致,參數也一致。
## htmlpurifier(1.0.5+)
>[info] 含義:html安全過濾
返回:string
| 參數 | 類型 | 含義 |
| --- | --- | --- |
| $html | string | 要過濾的內容 |
## dp_send_message(1.2.0+)
>[info] 含義:發送消息給用戶
返回:bool
| 參數 | 類型 | 含義 |
| --- | --- | --- |
| $type | string | 消息類型 |
| $content | string | 消息內容 |
| $uids | string | 用戶id,可以是數組,也可以是逗號隔開的字符串 |
- 序言
- 環境搭建
- 下載及安裝
- 目錄結構
- 快速構建器(ZBuilder)
- 表單(form)
- 設置頁面標題
- 設置頁提示信息
- 設置表單提交地址
- 隱藏按鈕
- 添加按鈕
- 設置按鈕標題
- 添加表單項
- 復選
- 單選
- 日期
- 時間
- 開關
- 標簽
- 數組
- 分組
- 范圍
- 按鈕
- 數字框
- 密碼框
- 取色器
- 下拉菜單
- 普通聯動
- 快速聯動
- 拖拽排序
- 靜態文本
- 格式文本
- 日期時間
- 日期范圍
- 圖片裁剪
- 百度地圖
- 單文件上傳
- 多文件上傳
- 單圖片上傳
- 多圖片上傳
- 隱藏表單項
- 圖標選擇器
- 單行文本框
- 多行文本框
- 百度編輯器
- CKEditor編輯器
- wang編輯器
- markdown編輯器
- summernote編輯器
- 圖片展示(1.1.0+)
- 單文件展示(1.1.0+)
- 多文件展示(1.1.0+)
- 下拉菜單Ajax(1.3.3+)
- 復雜表格(1.4.3+)
- 數據表格(1.4.3+)
- 分組下拉菜單(1.4.3+)
- 表格選取(1.4.3+)
- 穿梭框(1.4.3+)
- 添加表單項通用方法
- 直接設置表單項
- 表單布局
- 設置Tab按鈕列表
- 設置表單數據
- 引入js文件
- 引入css文件
- 設置額外JS代碼
- 設置額外CSS樣式
- 設置額外HTML代碼
- 是否ajax方式提交
- 設置模版路徑
- 設置觸發器
- 設置表單提交確認框
- 自定義表單項(1.0.6+)
- 設置表單提交方式(1.0.6+)
- 模板變量賦值(1.0.7+)
- 設置頁面空表單項提示(1.0.7+)
- 自定義擴展表單圖標(1.2.0+)
- 設置表單令牌(1.3.1+)
- 新窗口打開返回的url(1.4.4+)
- 表格(table)
- 設置頁面標題
- 設置頁面提示信息
- 添加一列
- 字段類型
- switch
- status
- yesno
- text.edit
- textarea.edit
- password
- url
- tel
- number
- icon
- byte
- date
- time
- datetime
- date.edit
- time.edit
- datetime.edit
- picture
- pictures
- select
- callback
- link
- text
- img_url
- files(1.1.1+)
- popover(1.4.4+)
- 添加多列
- 添加數量索引
- 添加快捷編輯的驗證器
- 設置表格數據
- 隱藏第一列多選框
- 添加表頭排序
- 添加表頭篩選
- 添加表頭篩選條件
- 添加時間段篩選
- 添加一個右側按鈕
- 添加多個右側按鈕
- 添加一個頂部按鈕
- 添加多個頂部按鈕
- 自動添加按鈕
- 自動編輯按鈕
- 替換右側按鈕
- 設置搜索參數
- 設置數據庫表名
- 設置插件名稱
- 設置表格主鍵
- 設置Tab按鈕列表
- 設置分頁
- 去除分頁
- 引入js文件
- 引入css文件
- 設置額外JS代碼
- 設置額外CSS樣式
- 設置額外HTML代碼
- 設置額外HTML代碼-模板文件(1.4.0+)
- 設置模版路徑
- 添加行class名
- 添加頂部下拉篩選
- 設置頁面空數據提示(1.0.7+)
- 模板變量賦值(1.0.7+)
- 設置使用原始數據字段(1.0.8+)
- 設置搜索區域(1.1.0+)
- 設置表格高度(1.3.0+)
- 固定左列(1.3.0+)
- 固定右列(1.3.0+)
- 設置列寬(1.3.0+)
- 設置隱藏列(1.3.0+)
- 側欄(aside)
- 添加區塊
- 設置Tab按鈕列表
- 追加Tab按鈕列表
- 設置當前tab
- 設置單個tab內容
- 設置多個tab內容
- 追加tab內容
- 覆蓋側欄
- 模塊開發
- 創建模塊信息文件
- 安裝模塊
- 模塊配置
- 控制器
- 創建菜單節點
- 第一個控制器
- 模塊參數配置頁面
- 方法參考
- 數據授權(1.3.2+)
- 插件開發
- 插件入口文件
- 插件基本信息
- 管理界面的字段信息
- 新增或編輯的字段信息
- 插件鉤子
- 觸發器
- 原數據庫表前綴
- 插件配置信息
- 安裝和卸載Sql文件
- 控制器
- 模型
- 驗證器
- 視圖
- 方法參考
- 實踐教程
- 變量參考
- 函數參考
- 安全相關
- 常見問題
- 其他雜項
- 更新日志
- 升級指導
- 貢獻名單
- 關于文檔