# :-: 寶塔API全功能接管接口
官方程序中默認使用**封裝**的方法,自定義僅供開發參考。
## 一、封裝使用
`bt($sid, $go, $data, $pid, $type)`
| 參數 | 說明 |
| --- | --- |
| $sid | 服務器ID,必須 |
| $go | 請求功能,必須 |
| $data | 傳送數組,必須<br>可參考 系統后臺->搭建系統->功能配置->各項中能中的 示范請求 |
| $pid | 所操作的站點ID,選填|
| $type | 對接模式,默認為官方接口,選填<br> 1:官方接口 2:cmspro接口 需修改__init__.py(可參考 【寶塔通用就接口】) |
**1、系統封裝使用:采用官方 url**
```
/**
* 檢查面板更新
*/
$data = array(
'check' => 'true'
);
$server = bt('10001', '/config?action=get_token', $data, 0);
if ($server['token'] != true) {
echo '提交失敗,請根據提示調整。<br>' . $server["msg"];
var_dump($server);
exit;
} else {
exit('yes');
}
```
2、系統精簡請求
```
/**
* 檢查面板更新
*/
$data = array(
'check' => 'true'
);
$server = bt('10001', 'UpdatePanel', $data, 0);
if ($server['token'] != true) {
echo '提交失敗,請根據提示調整。<br>' . $server["msg"];
var_dump($server);
exit;
} else {
exit('yes');
}
```
系統已做好**全局**封裝直接使用即可,也可以拿去做別的封裝參考。
參考封裝
```
/**
* 寶塔系統對接
* @param type $sid 服務器ID
* @param type $gourl 所操作的URL 格式為 /data?action=getKey 形式
* @param type $data 發送的數據數組形式
* @param type $pid 所操作的站點ID,選填
* @param type $type 對接模式,默認為官方接口 (1:官方接口 2:cmspro接口 需修改__init__.py)
* @return Array
*/
function bt($sid, $gourl, $data, $pid = 0, $type = 1) {
$row = DB('setup_panel_bt')->where("id=$sid")->find();
if ($row['id'] > 0) {
//配置服務器信息
$bt_data = array(
'bt_panel' => $row['ssl'] . '://' . $row['api'] . ':' . $row['port'], //服務器地址
'bt_key' => $row['pass'], //服務器秘鑰
'bt_cookie' => DATA . 'temp/', // COOKIE保存目錄
'bt_type' => $type, //對接模式,默認為官方接口 (1:官方接口 2:cmspro接口)
'bt_path' => $row['entry'], //接口路徑,僅對cmspro接口有效
'bt_sid' => $row['id'], //對接的服務器ID
'bt_pid' => $pid, //所操作的項目ID
);
//鏈接對應服務器的寶塔
$_bt = new BT_SYS($bt_data);
//執行操作命令
return $_bt->Get($gourl, $data);
} else {
return '服務器不存在或不屬于寶塔面板!';
}
}
```
## 二、自定義使用
**初始化**
```
$bt_data = array(
'bt_panel' => $_POST['ssl'] . '://' . $_POST['api'] . ':' . $_POST['port'], //服務器地址
'bt_key' => $_POST['pass'], //服務器秘鑰
'bt_cookie' => DATA . 'temp/', // COOKIE保存目錄
'bt_type' => 1, //對接模式,默認為官方接口 (1:官方接口 2:cmspro接口)
'bt_path' => null, //接口路徑,僅對cmspro接口有效
'bt_sid' => $_POST['id'], //對接的服務器ID
);
$bt = new BT_SYS($bt_data);
```
**功能使用**
1、采用官方 url
```
/**
* 檢查面板更新
*/
$data = array(
'check' => 'true'
);
$server = $bt->Get('/config?action=get_token', $data);
if ($server['token'] != true) {
echo '提交失敗,請根據提示調整。<br>' . $server["msg"];
var_dump($server);
exit;
} else {
exit('yes');
}
```
2、系統精簡請求
注:下方用的`UpdatePanel`參考 系統后臺->搭建系統->功能配置->各項中能中的`值`
```
/**
* 檢查面板更新
*/
$data = array(
'check' => 'true'
);
$server = $bt->Get('UpdatePanel', $data);
if ($server['token'] != true) {
echo '提交失敗,請根據提示調整。<br>' . $server["msg"];
var_dump($server);
exit;
} else {
exit('yes');
}
```
## 三、寶塔通用就接口
這種情況為備用方案,在寶塔接口無法使用的情況下使用。
**!!!!一定要在修改前備份修改的文件!**
此方法,修改后重啟面板即可,服務重啟面板無法進入面板。
```
linux登陸ssh 輸入bt 選擇修復面板,然后嘗試重新修改或放棄
win登陸3389覆蓋同版本的文件,然后嘗試重新修改或放棄
```
此方法完成后可實現免密碼登錄面板,因此切勿泄露url信息給外人。
免登錄訪問地址為:`http://服務器IP:端口/login?api地址=密鑰`
**再次提醒:本方法僅支持寶塔6.0以上的面板,每次更新、重置面板一定要重新檢查是否有以下代碼。**
1.打開面板程序文檔
```
windows 路徑 D:\BtSoft\panel\BTPanel\__init__.py
linux 路徑 /www/server/panel/BTPanel/__init__.py
```
2.找到
```
if hasattr(get,'dologin'):
```
在**上面**增加增加以下代碼
建議用 sublime 編輯器下載下來進行編輯。
特別注意:一定要保持縮進,不然面板無法運行。如最下面的圖
```
#寶塔對接接口開始
#設置項開始
cp_api_path = 'cmspro' # cmspro 為api地址,請填寫與后臺設置的一致 實際地址為/login?cmspro=123456
cp_api_key = '123456' # 123456 為密鑰,請填寫與后臺設置的一致
#設置項結束
if hasattr(get,cp_api_path):
api = request.args.get(cp_api_path, '').strip()
if api==cp_api_key:
session['admin_auth'] = True
session['login'] = True
login_path = '/'
return redirect(login_path)
#寶塔對接接口結束??
```
**正確的**

**錯誤的**

- 關于CMSPRO
- 安裝使用
- 首次使用
- 功能使用
- 系統后臺
- 系統
- 系統配置
- 開發使用
- 基礎學習
- php如何修改文件創建時間
- 類方法
- 系統框架
- 系統入口框架
- URL處理
- 自動附加封裝類、函數入口
- 內置應用
- GET與POST
- 字符控制
- 多語言使用
- 數據庫使用
- 頁面跳轉
- 數組控制
- 時間相關
- 文件操作
- 獲取系統設置的應用目錄
- IP獲取與解析
- 數據分頁
- 內置插件
- 短信發送
- 信息模板
- 消息操作
- 消息操作(舊)
- 資金操作
- 優惠券
- 積分操作
- 服務器接口
- 寶塔接口
- 域名接口
- 西部數據
- whois查詢
- 事件管理器
- 規則管理器
- 電子郵件
- 常用代碼
- 數據獲取與分頁
- 模型自動構建表單
- 排版布局
- 常用樣式
- 編輯表單
- tab選項卡
- JS相關
- 插件
- 鉤子
- 高級進階
- 消息和模板組合使用
- API接口
- 充值支付
- 積分充值兌換
- 短信驗證碼
- 郵箱驗證碼
- 微信消息模板
- 獲取貨幣信息
- 獲取積分信息
- 商品操作
- 信息反饋
- LayIM相關
- 自定義一級URL
- 自定義功能
- 用戶中心
- 網站管理
- 模板引擎v2
- 基礎學習
- 變量輸出
- 使用函數
- 運算符
- 原樣輸出
- 模板注釋
- 模板繼承
- 包含文件
- 內置標簽
- 循環標簽
- 比較標簽
- 條件判斷
- 資源文件加載
- 標簽嵌套
- 原生PHP
- 定義標簽
- 功能應用
- 站點統計
- 數據列表
- 單條數據
- 功能動作
- 賬戶資金
- 賬戶積分
- 網站導航
- 從零使用
- 結構了解
- 基礎工作
- 模板引擎v1
- 模板標簽
- 導航菜單
- 獲取數據列表
- 獲取單條數據
- 廣告以及連接
- if判斷
- 判斷是否登錄
- 判斷系統變量
- 自定義判斷
- 常規判斷
- 模板表單
- 高級使用
- 前后分離v1
- 通用
- 支付
- 積分
- 論壇
- 下載
- 微信
- 云服務SDK開發
- 通用請求