Uc pm send
出自Discuz! 技术文库
uc_pm_send
- integer uc_pm_send(integer fromuid , string msgto , string subject , string message [, bool instantly , integer replypmid , bool isusername , integer type])
目录 |
描述
本接口函数用于发送短消息。当 instantly 为 1 时，短消息会直接发送出去，否则本函数会发送一个 header 的 location 请求，使当前页面跳转到短消息中心的发送短消息页面。因此，当 instantly 为 0 时请不要在这个函数运行前后有任何的输出性的代码。type 为 1 时为发送群聊消息。msgto 默认为用户 ID，如果要让用户名作为参数，可让 isusername 为 1。replypid 为 0 表示发送的短消息为短消息话题的发起者，如果 replypid 为指定的消息 ID 则表示发送的短消息为回复指定短消息话题的回复信息。如果 instantly 为 1，那么发送成功后函数返回发送成功的最后一条消息 ID，返回 0 表示发送失败。
参数
| 参数名 | 类型 | 是否必需 | 说明 | 备注 |
| fromuid | integer | 是 | 发件人用户 ID | |
| msgto | string | 是 | 收件人用户名 / 用户 ID，多个用逗号分割 | |
| subject | string | 是 | 消息标题 | |
| message | string | 是 | 消息内容 | |
| instantly | bool | 否 | 是否直接发送 | 1:(默认值) 直接发送消息 0:进入发送短消息的界面 |
| replypid | integer | 否 | 回复的消息 ID | 大于 0:回复指定的短消息 0:(默认值) 发送新的短消息 |
| isusername | bool | 否 | msgto 参数是否为用户名 | 1:msgto 参数为用户名 0:(默认值) msgto 参数为用户 ID |
| type | integer | 否 | 消息类别 | 1:群聊消息 0:(默认值)私人消息 |
范例
if(uc_pm_send($uid, $_POST['msgto'], $_POST['subject'], $_POST['message'])) {
echo "短消息发送成功";
}
返回值
| 返回值类型 | 说明 | 备注 |
| integer | 大于 0:发送成功的最后一条消息 ID 0:发送失败 -1:超过两人会话的最大上限 -2:超过两次发送短消息时间间隔 -3:不能给非好友批量发送短消息(已废弃) -4:目前还不能使用发送短消息功能（注册多少日后才可以使用发短消息限制） -5:超过群聊会话的最大上限 -6:在忽略列表中 -7:超过群聊人数上限 -8:不能给自己发短消息 -9:收件人为空 -10:发起群聊人数小于两人 |
