# 微信菜单项基类 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为有子菜单,否则没有`
- 1、序言
- 1.1、更新说明
- 1.2、更新计划
- 2、开始使用 Endor
- 3、目录结构
- 4、类说明
- 4.1、WechatConfig
- 4.2、WechatValid
- 4.3、WechatCommon
- 4.4、WechatException
- 4.5、基础接口
- 4.5.1、ShortUrl
- 4.5.2、WechatServerApi
- 4.6、菜单接口
- 4.6.1、菜单类设计
- 4.6.2、Menu
- 4.6.3、ClickMenu
- 4.6.4、ViewMenu
- 4.6.5、MiniProgramMenu
- 4.6.6、MenuApi
- 4.7、消息接口
- 4.7.1、Receiver
- 4.7.2、Message
- 4.7.3、EventMessage
- 4.7.4、TextMessage
- 4.7.5、ClickEventMessage
- 4.7.6、SubscribeEventMessage
- 4.7.7、UnSubscribeEventMessage
- 4.7.8、LocationEventMessage
- 4.7.9、ImageMessage
- 4.7.10、LinkMessage
- 4.7.11、NewsMessage
- 4.7.12、NewsContext
- 4.8、OAuth2.0权限验证
- 4.8.1、WechatUser
- 4.8.2、OAuthApi
- 4.9、微信支付接口
- 4.9.1、微信支付类设计
- 4.9.2、PayApi
- 4.9.3、RequestPay
- 4.9.4、ResponsePay
- 4.9.5、UnifiedOrder
- 4.9.6、JsPay
- 4.9.7、Refund
- 4.9.8、Query
- 4.9.9、Bill
- 4.9.10、NotifyData
- 4.9.11、Notify
- 4.10、模板消息接口
- 4.10.1、TemplateContext
- 4.10.2、TemplateMessageApi
- 5、使用场景
- 5.1、微信接入服务器验证
- 5.2、获取微信API令牌(access_token)
- 5.3、获取JS API
- 5.4、OAuth2.0静默登录
- 5.5、微信菜单
- 5.6、微信消息
- 5.7、微信支付
- 5.7.1、微信公众号内JsApi支付
- 5.7.2、Native 模式二 扫码支付
- 5.8、模板消息发送