## 哪些人適合使用 tpAdmin 管理后臺?
首先,很歡迎所有人都使用 tpAdmin 管理后臺,但是:
* 如果你是一個對 ThinkPHP5 都不了解的 PHPer 或者不愿意好好看文檔就直接下手使用的 PHPer ,或許這個框架不太適合你,因為簡潔的開發模式到你手上可能更復雜了,你需要理解整個框架的思想,充分利用利用 traits 和公共控制器提供的方法,并且結合 ThinkPHP5 的模型、驗證器使用,開發效率將大增
* 如果你是一個連 chrome 控制臺都不知道而且不知道瀏覽器開發者工具怎么使用,不會看 Network 和 Console 的 PHPer,那么這個框架也不適合你,因為框架用到了大量的 ajax 請求,必須會使用瀏覽器開發者工具調試,后續版本更新會增加更多的 ajax 請求,你需要去學習瀏覽器開發者工具如何使用
* 如果你是一個想要各種組件的后臺,或許這個框架也不適合你,這個框架提供的是靈活的開發模式,而不是各種很死的組件、去使用他們得看大量的前端文檔,而且不容易靈活變動。如果你需要這些很強大的組件,你可以去 github 或者 npm 尋找,自己給加進去,tpAdmin 給你的是一種更靈活而又高效的開發模式
* 如果你是一個很喜歡問問題,框架出了任何 bug 都不自己看下日志,看下錯誤就直接問別人問題的 PHPer ,而且問問題前從來沒用使用過搜索引擎,或許這個框架也不適合你,因為我也是一名小白,我也需要學習,我需要更多時間去學習,包括其他人,請仔細讀文檔( [ThinkPHP5 文檔](www.hmoore.net/manual/thinkphp5) 和 [tpAdmin 文檔](doc.tpadmin.yuan1994.com) ,請尊重別人的勞動成果,否則你可能也得不到應有的尊重,下面的幾個鏈接請您收藏好:
* [斷言:不懂《提問的智慧》的人不會從初級程序員水平畢業]( https://phphub.org/topics/535)
* [PHP 之道](http://laravel-china.github.io/php-the-right-way/)
* [PHP 標準規范](https://psr.phphub.org/)
## 框架的設計思想
### 以表格為主
一個常規控制器包含的方法為 index, recycleBin, add, edit, forbid, resume, delete, recycle, deleteForever,所有的方法都是圍繞一個表格列表的增刪改查(CURD),其他的模式得自己寫代碼,常規的 CURD 直接使用 traits 即可
### 公共控制器集成很多常用方法
所有控制器都繼承與一個公共控制器(`app\admin\Controller`),該控制器提供了所有會在 CURD 方法中常用的公共基礎方法,CURD 方法一般都使用這些方法快速生成一個 CURD 方法
>[info] 所有的 CURD 方法都不在公共控制器中,而在對應的 traits (`app\admin\traits\controller\Controller`) 中,如果要使用常規 CURD 方法手動 use traits 就行,不需要使用可以利用公共控制器的基礎方法進行快速封裝
### CURD 方法集成在 traits 中
為了照顧到一些特殊控制器(不需要 CURD 方法的控制器),所以沒有將 CURD 方法直接放在公共控制器中,需要使用 CURD 方法的控制器集成公共控制器后,然后手動使用 traits ,CURD 方法包括 index, recycleBin, add, edit, forbid, resume, delete, recycle, deleteForever 幾個方法,如有特殊變動可以重寫方法,每個方法可以結合前置方法 before 實現攔截、過濾、前置賦值等操作,如果不需要使用其中的某些方法,可以使用控制器的靜態屬性 `protect static $blacklist = ['delete', ...]` 指定你需要禁用的方法
### 模板使用繼承和文件引入,實現模板復用
所有模板都繼承于基礎模板 `template/base.html` ,其他模板對基礎模板的區塊進行重寫,對于 `form.html`,`th.html`,`td.html` 模板代碼塊是列表首頁和回收站公共代碼,故使用了 `include` 標簽實現文件引入,再次實現模板復用,一處修改、多處生效。
## 請確保自己擁有基本的瀏覽器調試能力
本框架大量使用 ajax 請求,不通過瀏覽器調試很難抓取數據進行快速調試,如果你還不會使用瀏覽器調試,請利用搜索引擎自行腦補,如果你還在使用 360 或 IE 等瀏覽器,除非你是做前端需要測試瀏覽器兼容性,建議你馬上卸載,換用 chrome 或者 firefox
---
>[info] 如果您是一名資深的前輩或者對該框架有自己的見解,您可以加群反饋或者去 github 提交 issues ,我非常歡迎您的建議,在此我非常感謝一位前輩在 v1.0 版本中給我提的建議,他的建議讓我飛速進步,讓 tpAdmin 管理后臺改頭換面,變得更規范、強大,非常的感謝這位前輩

- 概要
- 開始使用
- 寫在前面
- 目錄結構
- 模板主題支持
- 前置方法before支持
- 數據返回
- 異常接管
- Rbac 權限管理
- 開始使用
- 用戶管理
- 分組管理
- 節點管理
- 角色管理
- 使用流程
- 其他
- 代碼自動生成 v1.2
- 示例一 - 一級控制器
- 示例二 - 多級控制器
- 示例三 - 從數據表生成
- 示例四 - 指定生成的文件
- 示例五 - 命令行模式
- 示例六 - 模擬命令行模式
- 代碼自動生成
- 示例一 - 一級控制器
- 示例二 - 多級控制器
- 控制器
- 公共控制器
- traits 多繼承 Controller
- 公開不授權控制器
- 其他控制器
- 標簽擴展
- 模板
- 網站操作日志
- 節點圖
- 行為驅動
- 其他后端方法
- Excel一鍵導出
- Excel一鍵導入
- 文件下載
- 郵件發送
- 七牛文件上傳
- id加密
- 前端
- ajax請求
- 表單校驗
- 豐富彈層
- 異步操作
- 表格溢出
- 隨機字符串
- 自動面包屑導航
- 動態加載文件
- 文件上傳
- Tab 切換
- 圖片預覽
- 二維碼生成
- 日歷組件
- 升級指導
- 更新日志
- FAQ