邁思框架（MyStep Framework）是一套基于?[PHP 7.0]?的web開發(fā)框架，旨在構(gòu)建一個(gè)可以便捷調(diào)用常用功能，以最簡潔的代碼實(shí)現(xiàn)目標(biāo)功能，同時(shí)具備高度可擴(kuò)展性，可通過代理模式，方便的將第三方功能模塊集成到框架中。

• 路由系統(tǒng) - 框架通過 rewrite 方法接管所有響應(yīng)，除 static 目錄和自定義擴(kuò)展類型外，其他文件均無法直接通過 url 訪問，兼具高可控性和安全性。 （IIS對應(yīng)web.config，Apache對應(yīng).htaccess，NginX需參考目錄下文件手動(dòng)添加）。
• 路由模式 - 為增加環(huán)境適應(yīng)度，框架同時(shí)支持Rewrite，QueryString和PathInfo三種模式，頁面中站內(nèi)URL只需要按照rewrite的模式書寫（相對于框架目錄，首位無需加"/"），框架將自動(dòng)調(diào)整為對應(yīng)模式，但為保證最大兼容性，php腳本內(nèi)的鏈接多以QueryString模式處理。
• 模版系統(tǒng) - 采用二次編譯模式，嚴(yán)格實(shí)現(xiàn)模板與程序的分離，通過通俗的標(biāo)簽模式調(diào)用各類數(shù)據(jù)。基本模板格式簡單易學(xué)，方便制作，只要對HTML有一定了解的設(shè)計(jì)師均可以很快上手，模板修改后即時(shí)生效。同時(shí)具備高度可擴(kuò)展性，可根據(jù)實(shí)際需要任意擴(kuò)充模版標(biāo)簽。
• 插件系統(tǒng) - 可插件模式擴(kuò)展框架功能，無論是功能增強(qiáng)、系統(tǒng)優(yōu)化、前臺展示均可與系統(tǒng)無縫連接。內(nèi)容評分、評論、投票、專題、檢索、采集、統(tǒng)計(jì)等都可以通過插件實(shí)現(xiàn)，并可以無縫結(jié)合到系統(tǒng)中。
• 應(yīng)用接口 - 系統(tǒng)為各類插件提供了豐富的接口，無論是api、模板標(biāo)簽、代碼嵌入、腳本附加、登錄處理，都可以通過系統(tǒng)接口便捷地實(shí)現(xiàn)，為二次開發(fā)或插件開發(fā)提供最大限度的支持和自由。
• 多語言支持 - 系統(tǒng)可以隨意添加語言包，通過調(diào)整參數(shù)立即變化。
• 緩存機(jī)制 - 通過三級緩存保證高效
  • 數(shù)據(jù)緩存，用于緩存從數(shù)據(jù)庫查詢出的結(jié)果集，包含自建文件和數(shù)據(jù)庫兩種模式，也可通過代理模式擴(kuò)展；
  • 頁面緩存，可將解析好的頁面整體緩存到緩存文件，在過期前不用再次生成頁面，即實(shí)現(xiàn)了靜態(tài)化的效果，也保留了動(dòng)態(tài)腳本的特性；
  • 瀏覽器緩存，通過etag標(biāo)識，在客戶端再次請求頁面數(shù)據(jù)時(shí)，如頁面未發(fā)生變化，則直接從客戶端緩存調(diào)用數(shù)據(jù)，減少了對服務(wù)器帶寬的請求。

公共函數(shù)：

• getMicrotime($rate) - 獲取微秒時(shí)間
• getTimeDiff($time_start, $decimal, $micro) - 取得時(shí)間差
• getDate_cn($date) - 獲取中文日期
• shortUrl($url, $max_length) - 縮略鏈接
• tinyUrl($url) - 獲取短網(wǎng)址
• isMobile() - 判斷是否為移動(dòng)設(shè)備
• isHttps() - 判斷當(dāng)前是否為SSL鏈接
• myEval($code) - 自定義代碼執(zhí)行
• checkPara($att_list, $parse) - 檢測數(shù)據(jù)變量中是否有待解析的變量，并解析
• recursionFunction($func, $para) - 遞歸執(zhí)行某一函數(shù)
• getOB() - 獲取緩存區(qū)內(nèi)容并清空
• debug系列函數(shù) - 變量情況查看

執(zhí)行順序：

所有響應(yīng)網(wǎng)址均通過rewrite模塊反饋給根目錄下的index.php腳本統(tǒng)一處理，雖然框架也支持QueryString和PathInfo兩種模式，但是為了更好的網(wǎng)址優(yōu)化和安全性，建議采用rewrite的方式，主要執(zhí)行流程如下：

• 初始化框架 - 通過框架根目錄index.php，調(diào)用myStep::init()
• 路由模式判斷 - 通過 $router->check() 判斷是否存在自定義路由
  • 當(dāng)前響應(yīng)路徑符合已設(shè)定的自定義路由規(guī)則，按規(guī)則調(diào)用指定的響應(yīng)方法，可由多方法依次執(zhí)行構(gòu)成多級響應(yīng)。可通過框架默認(rèn)處理方法myStep::getModule()調(diào)用相應(yīng)模塊（具體處理流程詳見核心類對應(yīng)方法講解），也可以根據(jù)需要替換為自定義方法。
  • 如未發(fā)現(xiàn)何時(shí)規(guī)則，則分析響應(yīng)路徑，將一級路徑或默認(rèn)app指定為響應(yīng)app，并調(diào)用該app路徑下的index.php處理
• 框架變量設(shè)置 - 在獲取執(zhí)行入口之后，框架將繼續(xù)調(diào)用以下程序
  • myStep::setPara() - 此方法在執(zhí)行入口腳本之前將調(diào)用，用于加載應(yīng)用設(shè)置（config.php）、應(yīng)用函數(shù)庫（lib.php），并設(shè)置基本框架變量
  • $mystep->preload() - 并非myStep類中的原生方法，但是如果應(yīng)用擴(kuò)展類中存在此方法，將會(huì)在聲明類后立即執(zhí)行
  • lib.php - 應(yīng)用函數(shù)庫（app/[name]/lib.php，推薦使用命名空間），在核心類已加載并聲明實(shí)例后加載
  • global.php - 本腳本為應(yīng)用通用腳本，自定義路由模式下通過 myStep::getModule() 自動(dòng)加載，其他模式下需手動(dòng)加載，可用于在模版實(shí)例聲明后做后期變量及程序調(diào)整。
  • $mystep->shutdown() - 并非myStep類中的原生方法，但是如果應(yīng)用擴(kuò)展類中存在此方法，將在頁面結(jié)束時(shí)執(zhí)行

PHP常量：

• PATH - 當(dāng)前應(yīng)用路徑
• ROOT - 框架根目錄路徑
• ROOT_WEB - 框架相對于網(wǎng)站根目錄的相對路徑
• APP - 應(yīng)用存放路徑
• LIB - 函數(shù)及類存放路徑
• CACHE - 緩存及臨時(shí)文件存放路徑
• CONFIG - 配置文件存放路徑
• PLUGIN - 插件存放路徑
• STATICS - CSS、JS及圖片等靜態(tài)文件存放路徑
• VENDOR - 第三方應(yīng)用庫存放路徑
• FILE - 文件上傳目錄

全局變量：

• $s - 框架配置，通過對象模式調(diào)用，如$s->web-title
• $info_app - 當(dāng)前調(diào)用應(yīng)用的基本信息，除對應(yīng)APP信息外（APP目錄下info.php定義），還包括path（數(shù)組）和route（字符串）項(xiàng)目
• $mystep - 應(yīng)用入口類，如應(yīng)用路徑下不存在以應(yīng)用路徑名命名的類（如test/test.class.php里面的test類，且此類應(yīng)該是mystep類的擴(kuò)展），則調(diào)用默認(rèn)mystep類
• $db - 數(shù)據(jù)庫操作類，在函數(shù)初始化時(shí)根據(jù)設(shè)置連接，采用代理模式，可擴(kuò)展
• $cache - 數(shù)據(jù)緩存類，在函數(shù)初始化時(shí)根據(jù)設(shè)置連接，采用代理模式，可擴(kuò)展
• $tpl_setting - 模版參數(shù)，從 app 設(shè)置中調(diào)用，并繼承于全局變量
• $tpl_cache - 模版緩存參數(shù)，從 app 設(shè)置中調(diào)用，并繼承于全局變量

基礎(chǔ)類：

myBase為抽象類，可為所有其他子類提供統(tǒng)一的構(gòu)建方法和錯(cuò)誤處理；myTrait為擴(kuò)展類，可為所調(diào)用的類提供一整套魔術(shù)方法

• myBase->__construct - 將構(gòu)造函數(shù)引導(dǎo)至init方法
• myBase->setErrHandler - 設(shè)置錯(cuò)誤處理函數(shù)
• myBase->error - 通過異常處理類處理代碼錯(cuò)誤
• myTrait->__set - 添加類動(dòng)態(tài)變量，即沒有在類中聲明過的變量
• myTrait->__get - 調(diào)用類動(dòng)態(tài)變量，如變量名為instatnce，則直接返回新的當(dāng)前類實(shí)例
• myTrait->__destruct - unset類時(shí)，注銷所有類內(nèi)部變量
• myTrait->__call - 智能判斷并調(diào)用方法別名，動(dòng)態(tài)方法或類外部函數(shù)
• myTrait->addMethod - 動(dòng)態(tài)添加類方法
• myTrait->regAlias - 注冊類內(nèi)方法別名

控制類：

myController類為核心控制類，具體用法請參加功能類文檔，其中幾個(gè)重要方法說明如下：

• 頁面附加內(nèi)容設(shè)置 - 包括 setAddedContent 和 pushAddedContent 兩個(gè)方法，可設(shè)置指定關(guān)鍵字的內(nèi)容，并將相關(guān)內(nèi)容插入到模版中"page_關(guān)鍵字"的位置
• 語言文件管理 - 包括 setLanguage，setLanguagePack 和 getLanguage 三個(gè)方法，可設(shè)置語言、語言包或調(diào)用指定語言、指定索引的文字
• 應(yīng)用接口設(shè)置 - 包括 regApi 和 runApi 兩個(gè)方法，可通過路由的 /api/[str]/[any] 調(diào)用
• 模塊設(shè)置 - 包括 regModule 和 module 兩個(gè)方法，可通過路由的 /module/[str]/[any] 調(diào)用
• 模版標(biāo)簽設(shè)置 - 包括 regTag 一個(gè)方法，將在調(diào)用show方法時(shí)加載給模版類
• 鏈接設(shè)置 - 包括 regUrl 和 url 兩個(gè)方法，通過指定方法和相關(guān)參數(shù)生成對應(yīng)鏈接
• 插件設(shè)置 - 包括 regPlugin 和 plugin 兩個(gè)方法，每個(gè)插件是應(yīng)用接口，模塊，標(biāo)簽和鏈接的組合
• 代碼鉤子設(shè)置 - 包括 setFunction 和 run 兩個(gè)方法，將在指定的位置（start，end，page等，也可自定義）依次（順序或倒序）執(zhí)行指定的方法
• 用戶賬戶管理 - 包括 regLog，login，logout 和 chg_psw 四個(gè)方法，用于與第三方用戶系統(tǒng)對接
• 腳本管理 - 包括 addCSS，removeCSS，clearCSS，CSS，addJS，removeJS，clearJS 和 JS 八個(gè)方法，用于動(dòng)態(tài)加載js和css腳本
• 頁面控制 - 包括 start，show 和 end 三個(gè)方法，用于頁面起始、顯示和結(jié)束
• etag方法 - 用于賦予或調(diào)用指定標(biāo)識的瀏覽器緩存
• file方法 - 直接顯示指定文件
• guid方法 - 生成唯一ID
• setOp方法 - OPcache設(shè)置與調(diào)用
• regClass方法 - 設(shè)置類自動(dòng)載入規(guī)則
• setAlias方法 - 設(shè)置類調(diào)用別名
• header方法 - 返回指定的響應(yīng)頭（可以編碼或指定的索引，具體參見源代碼）

核心類：

myStep類擴(kuò)展自myController類，具體用法請參加功能類文檔，其中幾個(gè)重要方法說明如下：

• start($set_plugin) - 執(zhí)行于腳本主程序開始之前，用于設(shè)置框架類及其方法的調(diào)用別名，設(shè)定錯(cuò)誤報(bào)告模式，加載應(yīng)用對應(yīng)插件，初始化cookie和session，聲明數(shù)據(jù)庫（$db, 如$s->db->auto為false，則不建立連接，以便于無數(shù)據(jù)庫操作的應(yīng)用）和緩存（$cache）實(shí)例，以及為狀態(tài)變量賦值
• show(myTemplate $tpl) - 用于加載網(wǎng)站基本參數(shù)至模版實(shí)例，并將結(jié)果直接顯示（在此可添加針對顯示內(nèi)容的預(yù)處理方法）；同時(shí)也檢測并按需更新應(yīng)用腳本文件（[appName].js 和 [appName].css，詳情見相關(guān)專題），如設(shè)置"$mystep->setting->show = true"，則將在頁面最下面顯示基本運(yùn)行信息。
• render(myTemplate $tpl) - 與 show 方法類似，但是返回通過模版實(shí)例所生成的頁面內(nèi)容，而不是直接顯示
• setLink($content) - 針對所生成頁面的鏈接，根據(jù)設(shè)定的鏈接模式（rewrite，pathinfo或querystring）進(jìn)行處理，頁面模版中只要按照rewrite模式書寫，在頁面顯示時(shí)將自動(dòng)通過本預(yù)處理方法調(diào)整為對應(yīng)設(shè)置的鏈接。
• end() - 腳本結(jié)束時(shí)所用的方法，搜集并對比運(yùn)行結(jié)束時(shí)的信息，結(jié)束并清空變量，并智能調(diào)用用戶擴(kuò)展類中自定義的 shutdown() 方法
• info($msg, $url) - 執(zhí)行結(jié)果或提示信息顯示，并在5秒后自動(dòng)跳轉(zhuǎn)到對應(yīng)的鏈接
• redirect($url, $code) - 腳本內(nèi)鏈接跳轉(zhuǎn)，如$url為空則退回來路鏈接；$code默認(rèn)是302臨時(shí)跳轉(zhuǎn)，可根據(jù)需要改變。
• init() - 靜態(tài)方法，預(yù)初始化基本設(shè)置信息（如發(fā)現(xiàn)有錯(cuò)誤將自動(dòng)調(diào)整），聲明類加載模式，如為首次執(zhí)行框架的話，將自動(dòng)跳轉(zhuǎn)到初始設(shè)置頁面
• go() - 框架執(zhí)行入口，加載設(shè)置信息，判斷靜態(tài)文件并直接顯示，否則根據(jù)路由規(guī)則調(diào)用相關(guān)腳本
• setPara() - 聲明框架實(shí)例，默認(rèn)直接調(diào)用myStep類，也可在對應(yīng)APP中擴(kuò)展，框架會(huì)自動(dòng)調(diào)用APP目錄下"[appName].class.php"中與APP同名的類。將APP配置覆蓋全局配置，然后再調(diào)用start方法，同時(shí)聲明預(yù)加載的css和js腳本文件以及模版的初始設(shè)置。
• vendor($class_info) - 調(diào)用位于VENDOR目錄下的第三方PHP功能類，需要滿足以下條件。
  • 如$class_info為字符串，所調(diào)用類（位于vendor目錄下）的目錄名、文件名和類名必須一致，其中文件名可為"名稱.php"或"名稱.class.php"
  • $class_info可以為數(shù)組，包含
    • dir - 目錄名稱，如不設(shè)置默認(rèn)與 file 值相同
    • file - 不帶擴(kuò)展名的文件名稱，擴(kuò)展名可為".php"或".class.php"，如不設(shè)置默認(rèn)與 dir 值相同
    • class - 調(diào)用類名稱，如不設(shè)置默認(rèn)與 file 值相同
    • namespace - 類的命名空間，沒有請留空
  • 方法中除了首參數(shù)($class_info)外，后面的參數(shù)將用于在聲明類時(shí)，構(gòu)造函數(shù)(__construct()或init())的初始化
• getModule($m) - 自定義路由處理函數(shù)（也可以通過自定義方法處理自定義路由，詳情參見"自定義路由"專題），機(jī)制如下：
  • 傳入?yún)?shù) $m - 本參數(shù)傳遞路由外的路徑信息，如路由為 /manager/[any]，URI 為 /manager/path1/path2，則 $m 為 path1/path2，即[any]部分，但需要注意的是在本方法中，$m 被截取為 path1。此參數(shù)可直接在自定義的路由處理腳本內(nèi)調(diào)用，但如需在下級函數(shù)中調(diào)用，需要先進(jìn)行g(shù)lobal處理。
  • 本方法將通過 myStep::setPara 方法調(diào)用當(dāng)前 app 設(shè)置中的模版參數(shù)設(shè)置（可繼承于全局設(shè)置，存儲(chǔ)于全局變量 $tpl_setting 中）
  • 本方法將按照如下順序調(diào)用處理腳本（發(fā)現(xiàn)可用腳本后將立即調(diào)用并停止試探）
    • app路徑/module/模版樣式/$m.php（$m 為輸入?yún)?shù)）
    • app路徑/module/模版樣式/路由名稱.php （如路由為 /manager/[any]，路由名稱為 manager）
    • app路徑/module/$m.php（$m 為輸入?yún)?shù)）
    • app路徑/module/路由名稱.php （如路由為 /manager/[any]，路由名稱為 manager）
    • app路徑/module/模版樣式/index.php（模版樣式為設(shè)置中對應(yīng)的內(nèi)容）
    • app路徑/module/index.php

JS變量：

相關(guān)變量是通過腳本在頁面被調(diào)取時(shí)動(dòng)態(tài)生成，在調(diào)用時(shí)建議在onload事件或jQuery的$(function(){})中調(diào)用

• language - 調(diào)用系統(tǒng)語言設(shè)置（可自動(dòng)擴(kuò)展app語言包）
• setting - 調(diào)用系統(tǒng)設(shè)置（包括：language，router，debug，app，path_root，path_app，url_fix，url_prefix，url_prefix_app等信息，可通過APP設(shè)置重的 $setting['js'] 擴(kuò)充）
• global - 全局變量，可在任何函數(shù)內(nèi)部調(diào)用，可隨意擴(kuò)種，已包含以下子參數(shù)：
  • global.root - 針對rewrite、pathinfo和querystring模式下的根路徑
  • global.root_fix - 配合setURL，用于頁面鏈接的自適應(yīng)調(diào)整
  • global.editor_btn - 針對tinyMCE編輯器的按鈕擴(kuò)展
  • global.alert_leave - 在含表單的頁面，如果內(nèi)容發(fā)生變更，且通過非提交方式離開頁面的話，將此變量設(shè)置為 true，即可出現(xiàn)警告
  • global.timer - 用于計(jì)時(shí)器的返回值記錄（非強(qiáng)占，可靈活調(diào)用）
  • global.func - 頁面載入后所需運(yùn)行的函數(shù)組

JS函數(shù)：

• getPath(lvl) - 獲取相對于網(wǎng)站根的到調(diào)用函數(shù)頁面所在路徑的lvl級路徑
• $id(id) - 獲取對應(yīng)id的頁面元素
• $name(name, idx) - 獲取對應(yīng)name的頁面元素（組），idx可為first，last，數(shù)字索引，否則返回全部符合的元素組
• $tag(name, context) - 依照context（默認(rèn)為document）獲取對應(yīng)tag的頁面元素組
• isArray(para) - 判斷變量是否為數(shù)組
• loadingShow(info) - 顯示鎖屏信息，再次調(diào)用則關(guān)閉
• openDialog(url, width, height, mode) - 開啟模態(tài)窗口
• openWindow(url,width,height) - 新開窗口
• sleep(the_time) - 程序終端指定時(shí)間
• copy(obj) - 復(fù)制某一頁面元素內(nèi)容（value或innerText）或者一個(gè)字符串
• rndNum(min,max) - 生成指定范圍內(nèi)的隨機(jī)數(shù)字
• rndStr(len, t_lst, c_lst) - 生成隨機(jī)字符串（可自定義采樣內(nèi)容）
• watermark(obj, rate, copyright, char_c, jam_tag) - 添加字符串水印
• md5(str) - 生成str的md5編碼
• debug(para, mode) - 檢測指定變量para的內(nèi)容
• checkObj(obj, func_show) - 查看對象屬性
• reportError(msg, url, line) - 錯(cuò)誤信息處理
• checkSetting() - 通過在需要調(diào)用檢language, setting變量的函數(shù)開始加上"if(!checkSetting()) return;"（參考global.js中setURL函數(shù)的用法）來保證對應(yīng)函數(shù)執(zhí)行時(shí)可調(diào)用系統(tǒng)變量
• setURL(prefix) - 配合域名綁定模式和路由模式，智能處理頁面內(nèi)鏈接
• gotoAnchor(theAnchor) - 滾動(dòng)至對應(yīng)的錨點(diǎn)
• ms_func_reg(function) - 注冊需要頁面載入后運(yùn)行的函數(shù)
• ms_func_run() - 運(yùn)行于所有頁面載入之后的函數(shù)（框架自動(dòng)在page_end處運(yùn)行）
• 對象方法擴(kuò)展 - 針對 String，Data，Number，Array 等對象
  • string.blen - 返回某字符串的二進(jìn)制長度
  • string.trim - 去除字符串首尾空字符
  • string.printf - 字符串賦值
  • data.format - 格式化日期（YYYY-MM-dd hh