# 微信菜單項基類 Menu **目錄 (Table of Contents)** [TOC] ## 類基本信息 **類簡要描述：** - 用于首次接入微信公眾號時的服務器驗證 **類名字空間：** - endor/wechat/menu/ **類成員變量說明：** |成員變量|類型|訪問修飾|說明 |:---- |:---|:----- |----- | |_name| string | protected | 菜單名字| |_type | string | protected | 菜單類型，目前支持 click,view,miniprogram| |_media_id| string | protected | 調用新增永久素材接口返回的合法media_id| |_children| Object(Menu)| protected | 菜單對象數組 | ## 類成員函數/方法 ### __construct($name) + 參數列表： |參數名|類型|必填項|說明 |:---- |:---|:----- |----- | |$name| string | 是 | 菜單項名字 | + 返回值： `無` + 函數說明： `構造函數` ### getName(); + 參數列表： `無` + 返回值： `string 返回菜單名字` + 函數說明： `獲取微信菜單名字` ### getType(); + 參數列表： `無` + 返回值： `string 返回菜單類型` + 函數說明： `獲取微信菜單的類型，當前不提供setType接口，不同類型之間的菜單 通過不同子類來實現 ### setMediaId($media_id) + 參數列表： |參數名|類型|必填項|說明 |:---- |:---|:----- |----- | |$media_id| string | 是 | 調用新增永久素材接口返回的合法media_id | + 返回值： `string 返回菜單類型` ### getMediaId() + 參數列表： `無` + 返回值： `string 返回Media_id` + 函數說明： 獲取菜單綁定的media_id值 ### addChild(Menu $menuItem) + 參數列表： |參數名|類型|必填項|說明 |:---- |:---|:----- |----- | |$menuItem| Object (Menu) | 是 | 添加一個二級菜單 | + 返回值： `返回當前的操作對象` + 函數說明： `給當前菜單添加一個子菜單項` ### getChildByName($name) + 參數列表： |參數名|類型|必填項|說明 |:---- |:---|:----- |----- | |$name| string | 是 | 根據name尋找子菜單 | + 返回值： `mixed (object|null)` + 函數說明： `根據name尋找子菜單項實例，如果找到，返回該子菜單對象的實例，否則返回null` + 函數示例 ```PHP $fristMenu = new ClickMenu("團購"); // 添加 團購簡介 和 團購預約 二級菜單 $fristMenu->addChild(new ClickMenu("團購簡介","groupbuy info")) ->addChild(new ViewMenu("團購預約","https://github.com/DarthAhsoka/Endor-Wechat")); $markItemMenu = $fristMenu->getChildByName("團購預約"); if(isset($markItemMenu) { $markItemMenu->setUrl("https://github.com/DarthAhsoka/Endor-Wechat"); } ``` ### getChlildren() + 參數列表： `無` + 返回值： `array ` + 函數說明： ` 返回當前菜單下的所有子菜單` ### getChildrenLength() + 參數列表： `無` + 返回值： `int` + 函數說明： ` 返回當前菜單下的子菜單個數` ### hasChildren() + 參數列表： `無` + 返回值： `boolean` + 函數說明： ` 判斷當前菜單下是否有子菜單，返回true為有子菜單，否則沒有`