萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP 實作微信公眾平台音樂點播:XML 回覆、百度音樂 API 串接與 DOM 解析

功能架構

  1. 用戶發送文字:「音樂 歌名 歌手」
  2. 後端解析關鍵字 → 呼叫百度音樂 API 取得播放連結
  3. 組裝微信規範的 <xml> 音樂訊息回覆

微信音樂訊息 XML 結構

<xml>
  <ToUserName><![CDATA[toUser]]></ToUserName>
  <FromUserName><![CDATA[fromUser]]></FromUserName>
  <CreateTime>12345678</CreateTime>
  <MsgType><![CDATA[music]]></MsgType>
  <Music>
    <Title><![CDATA[TITLE]]></Title>
    <Description><![CDATA[DESCRIPTION]]></Description>
    <MusicUrl><![CDATA[MUSIC_Url]]></MusicUrl>
    <HQMusicUrl><![CDATA[HQ_MUSIC_Url]]></HQMusicUrl>
    <ThumbMediaId><![CDATA[media_id]]></ThumbMediaId>
  </Music>
  <FuncFlag>0</FuncFlag>
</xml>

核心類別實作

<?php
class WeChatMusicBot {
    private $baiduApi = 'https://box.zhangmen.baidu.com/x?op=12&count=1&title=';

    /** 組裝音樂回覆 XML */
    private function transmitMusic($object, array $music, $flag = 0): string {
        $itemTpl = <<<'XML'

    <![CDATA[%s]]>
    
    
    

XML;

        $item = sprintf($itemTpl,
            $music['Title'],
            $music['Description'],
            $music['MusicUrl'],
            $music['HQMusicUrl']
        );

        $tpl = <<
    
    
    %s
    
    %s
    %d

XML;

        return sprintf($tpl,
            $object->FromUserName,
            $object->ToUserName,
            time(),
            $item,
            $flag
        );
    }

    /** 解析用戶指令:音樂 歌名 歌手 */
    private function parseCommand(string $keyword): ?array {
        $prefix = '音樂';
        $pos = strpos($keyword, $prefix);
        if ($pos === false) return null;

        $content = substr($keyword, $pos + mb_strlen($prefix));
        $content = trim($content);
        if ($content === '') return null;

        // 以空格分隔歌名與歌手
        $parts = preg_split('/\s+/', $content, 2);
        $song = $parts[0] ?? '';
        $singer = $parts[1] ?? '';

        return [
            'song' => trim($song),
            'singer' => trim($singer)
        ];
    }

    /** 呼叫百度音樂 API 並解析 XML */
    private function fetchMusicUrls(string $song, string $singer): ?array {
        $url = $this->baiduApi . urlencode($song) . '$$' . urlencode($singer) . '$$$$';
        $xml = @file_get_contents($url);
        if (!$xml) return null;

        // 使用 SimpleXML (比 DOM 簡潔)
        $sxe = simplexml_load_string($xml);
        if (!$sxe) return null;

        $encode = (string)($sxe->url->encode ?? '');
        $decode = (string)($sxe->url->decode ?? '');

        if (!$encode || !$decode) return null;

        // 實測:encode+decode 拼接後截取 &mid 前即為可播放 URL
        $raw = $encode . $decode;
        $musicUrl = substr($raw, 0, strpos($raw, '&mid='));
        $hqUrl = $musicUrl; // 簡化:同一連結

        return [
            'MusicUrl' => $musicUrl,
            'HQMusicUrl' => $hqUrl
        ];
    }

    /** 主入口 */
    public function handle($postObj) {
        $cmd = $this->parseCommand($postObj->Content);
        if (!$cmd) {
            return $this->textReply($postObj, '格式:音樂 歌名 歌手\n例:音樂 大約在冬季 齊秦');
        }

        $urls = $this->fetchMusicUrls($cmd['song'], $cmd['singer']);
        if (!$urls) {
            return $this->textReply($postObj, '找不到該歌曲,諈嘗試其他關鍵字');
        }

        $music = [
            'Title' => $cmd['song'],
            'Description' => '歌手:' . $cmd['singer'],
            'MusicUrl' => $urls['MusicUrl'],
            'HQMusicUrl' => $urls['HQMusicUrl']
        ];

        return $this->transmitMusic($postObj, $music);
    }

    private function textReply($object, string $content): string {
        $tpl = <<
    
    
    %s
    
    

XML;
        return sprintf($tpl, $object->FromUserName, $object->ToUserName, time(), $content);
    }
}

// 入口腳本
$postStr = file_get_contents('php://input');
$postObj = simplexml_load_string($postStr, 'SimpleXMLElement', LIBXML_NOCDATA);
$bot = new WeChatMusicBot();
echo $bot->handle($postObj);

百度音樂 API 回應結構分析

<result>
  <url>
    <encode><![CDATA[https://zhangmenshiting.baidu.com/data2/music/.../file.mp3?xcode=...]]></encode>
    <decode><![CDATA[&mid=0.123456]]></decode>
  </url>
</result>

關鍵邏輯:encode 含播放連結但被 xcode 參數切斷,decode 補充 &mid=...。實測 僅需 encode 中 &mid= 之前的部分即可播放,decode 反而會導致失效。

DOM 解析替代方案 (原文採用)

private function readChild(DOMNode $node): string {
    global $musicStr;
    foreach ($node->childNodes as $child) {
        if ($child->nodeType === XML_ELEMENT_NODE) {
            if ($child->nodeName === 'encode') {
                $musicStr .= $child->nodeValue;
            } elseif ($child->nodeName === 'decode') {
                $musicStr .= $child->nodeValue . '|';
            }
            $this->readChild($child); // 遞迴
        }
    }
    return $musicStr;
}

建議:改用 simplexml_load_string 或 DOMXPath,程式碼更簡潔健壯。

生產環境強化建議

  1. 快取機制:Redis 快取「歌名+歌手 → URL」,減少對百度 API 請求
  2. 多來源備援:整合 QQ 音樂、網易雲 API,提高命中率
  3. 關鍵字分詞:引入 Jieba 分詞,支援「播放周杰倫的稻香」自然語言
  4. 版權合規:確認音樂來源授權,避免侵權風險
  5. HTTPS 強制:微信要求 MusicUrl 必須 HTTPS,需代理轉換或選擇支援 HTTPS 的音樂源

此實作展示了微信公眾號被動回覆音樂訊息的完整流程,可作為聊天機器人擴充功能的基礎模組。

copyright © 萬盛學電腦網 all rights reserved