本文提供PHP語言的自訂Topic訊息解析指令碼模板和樣本。
指令碼模板
PHP指令碼模板,您可以基於以下模板編寫訊息解析指令碼。
<?php
/**
* 將裝置自訂Topic訊息資料轉換為JSON格式資料,裝置上報資料到物聯網平台時調用。
* 入參:$topic,字串,裝置上報訊息的Topic。
* 入參:$rawData,普通數組,數組元素為整數。
* 出參:$jsonObj,關聯陣列,關聯陣列key取值為英文字串不能是字元的數字如"10",不可為空。
*/
function transformPayload($topic, $rawData)
{
$jsonObj = array();
return $jsonObj;
}
?>
指令碼編寫注意事項
- 請避免使用全域變數或者static變數,否則會造成執行結果不一致。
- 指令碼中,處理資料採用補碼的方式, [-128, 127]補碼範圍為[0, 255]。例如,-1對應的補碼為255(10進位表示)。
- 自訂協議解析的函數(transformPayload)的入參為整型數組。需要通過
0xFF
進行與操作,擷取其對應的補碼。返回結果為關聯陣列,要求key取值包含非數組字元(如數組key為“10”,PHP數組中會擷取到整數10)。 - PHP執行環境對於異常處理會很嚴格,如發生錯誤會直接拋出異常,後續代碼不會執行。保證代碼的健壯性,對於異常需要捕獲並進行處理。
樣本指令碼
說明 以下樣本指令碼僅用於解析自訂Topic訊息。如果產品的資料格式為透傳/自訂,還需編寫物模型訊息解析指令碼。物模型訊息解析指令碼編寫指導,請參見提交物模型訊息解析指令碼。
有關透傳/自訂說明,請參見建立產品。
<?php
/*
樣本資料
自訂Topic:
/user/update,上報資料。
輸入參數:
topic: /${productKey}/${deviceName}/user/update
bytes: 0x000000000100320100000000。
輸出參數:
{
"prop_float": 0,
"prop_int16": 50,
"prop_bool": 1,
"topic": "/${productKey}/${deviceName}/user/update"
}
*/
function transformPayload($topic, $bytes)
{
$data = array();
$length = count($bytes);
for ($i = 0; $i < $length; $i++) {
$data[$i] = $bytes[$i] & 0xff;
}
$jsonMap = array();
if (strpos($topic, '/user/update/error') !== false) {
$jsonMap['topic'] = $topic;
$jsonMap['errorCode'] = getInt8($data, 0);
} else if (strpos($topic, '/user/update') !== false) {
$jsonMap['topic'] = $topic;
$jsonMap['prop_int16'] = getInt16($data, 5);
$jsonMap['prop_bool'] = $data[7];
}
return $jsonMap;
}
function getInt32($bytes, $index)
{
$array = array($bytes[$index], $bytes[$index + 1], $bytes[$index + 2], $bytes[$index + 3]);
return hexdec(byteArrayToHexString($array));
}
function getInt16($bytes, $index)
{
$array = array($bytes[$index], $bytes[$index + 1]);
return hexdec(byteArrayToHexString($array));
}
function getInt8($bytes, $index)
{
$array = array($bytes[$index]);
return hexdec(byteArrayToHexString($array));
}
function byteArrayToHexString($data)
{
$hexStr = '';
for ($i = 0; $i < count($data); $i++) {
$hexValue = dechex($data[$i]);
$tempHexStr = strval($hexValue);
if (strlen($tempHexStr) === 1) {
$hexStr = $hexStr . '0' . $tempHexStr;
} else {
$hexStr = $hexStr . $tempHexStr;
}
}
return $hexStr;
}
function hexStringToByteArray($hex)
{
$result = array();
$index = 0;
for ($i = 0; $i < strlen($hex) - 1; $i += 2) {
$result[$index++] = hexdec($hex[$i] . $hex[$i + 1]);
}
return $result;
}
function concat($array, $data)
{
return array_merge($array, $data);
}
function toHex($data)
{
$var = dechex($data);
$length = strlen($var);
if ($length % 2 == 1) {
$var = '0' . $var;
}
return $var;
}