用户
 找回密码
 立即注册

QQ登录

只需一步,快速开始

扫一扫,登录网站

小程序社区 首页 教程 实战教程 查看内容

微信开发之上传素材

Rolan 2017-6-10 00:22

本文目录 :上传图文素材的图片上传其他素材关键的http表单请求代码小结参考文档前言:我在实现微信公众平台上传素材的时候遇到了许多问题,但最终还是成功实现这一功能,特此在这里做一下总结和记录。文中遇到诸如 ...

本文目录 : 
上传图文素材的图片 
上传其他素材 
关键的http表单请求代码 
小结 
参考文档

前言: 
我在实现微信公众平台上传素材的时候遇到了许多问题,但最终还是成功实现这一功能,特此在这里做一下总结和记录。

文中遇到诸如 getAccessToken() 等关键函数却没有找到实现时,可参考前面的这两篇文章: 
1、微信开发之获取用户详细列表 
2、微信开发之向用户群发文本消息

1、 上传图文素材的图片 
首先选一个简单的接口来做说明例子,这个上传素材的接口在所有上传素材的接口中是参数最简单的,而且还单独享用一个URL, 作为入门例子再合适不过了。 
注意,本文主要侧重点是代码层面的实现,而不是微信官方一大堆规则的讲解,如果你有需要此方面的介绍,下面已给出官方链接不谢。 
官方文档: 
新增永久素材 
官方给的这个接口,除了需要惯例的 access_token ,还需要一个文件的参数,一般而言,只需要一个文件路径,其他文件参数通过这个路径获取解析则可,做成一个黑匣子,简单易用。 
我知道,有人就是专门找下边的 Requests::request() 的实现的,可在这就没看到实现,别急,下面就有。

  1. public function uploadNewsImage($path)
  2. {
  3. $access_token = $this->getAccessToken();
  4. if (!$access_token) {
  5. return false;
  6. }
  7. $path = realpath($path);
  8. $post = ['media '=> '@'.$path];
  9. $url ="https://api.weixin.qq.com/cgi-bin/media/uploadimg?access_token={$access_token}";
  10. $return = $this->requestAndCheck($url, 'POST', $post);
  11. if ($return === false) {
  12. return false;
  13. }
  14. return $return;
  15. }
  16. /**
  17. * 专门用来检查微信接口返回值的。
  18. * 是的,这个接口比上一两篇文章的接口更加好用。东西一般做多,就知道要抽象了,如果还没有那水平的话。
  19. */
  20. public function requestAndCheck($url, $method = 'GET', $fields = [])
  21. {
  22. $return = Requests::request($url, $method, $fields);
  23. if ($return === false) {
  24. $this->setError("request出错! " . Requests::$error);
  25. return false;
  26. }
  27. $wxdata = json_decode($return, true);
  28. if (isset($wxdata['errcode']) && $wxdata['errcode'] != 0) {
  29. $this->setError("微信错误代码:{$wxdata['errcode']};<br>错误信息:{$wxdata['errmsg']}<br>请求链接:$url");
  30. return false;
  31. }
  32. if (strtoupper($method) === 'GET' && empty($wxdata)) {
  33. $this->setError("微信http请求返回为空!<br>请求链接:$url");
  34. return false;
  35. }
  36. return $wxdata;
  37. }

2、 上传其他素材 
懂得上面的流程,其他的上传素材的接口,无非就是加多个 GET 和 POST 参数,主流程没变。 
其他相关接口列举如下: 
1、新增永久图文素材:https://api.weixin.qq.com/cgi-bin/material/add_news?access_token=ACCESS_TOKEN 
2、新增其他类型永久素材:https://api.weixin.qq.com/cgi-bin/material/add_material?access_token=ACCESS_TOKEN&type=TYPE 
3、新增临时素材:https://api.weixin.qq.com/cgi-bin/media/upload?access_token=ACCESS_TOKEN&type=TYPE

功能的约束和细节还望参考官方文档: 
1、新增永久素材 
2、新增临时素材

3、 关键的http表单请求代码 
先上代码:(这里边已经简化很多附加功能,比如可以改变header之类的功能,该代码主要参考一些开源的项目)

public static function request($url, $method = 'GET', $fields = [])
    {
        self::$ch = curl_init();
        curl_setopt(self::$ch, CURLOPT_RETURNTRANSFER, true);
        curl_setopt(self::$ch, CURLOPT_CONNECTTIMEOUT, 10);

    $method = strtoupper($method);
    if ($method == 'GET' && !empty($fields)) {
        $url = $url . (strpos($url,"?")===false ? "?" : "&") . http_build_query($fields);
    }
    curl_setopt(self::$ch, CURLOPT_URL, $url);

    if ($method != 'GET') {
            curl_setopt(self::$ch, CURLOPT_POST, true);

        if (!empty($fields)) {
                if (is_array($fields)) {
                    /* 支持文件上传 */
                    if (class_exists('\CURLFile')) {
                        curl_setopt(self::$ch, CURLOPT_SAFE_UPLOAD, true);
                        foreach ($fields as $key => $value) {
                            if (is_string($value) && strpos($value, '@') === 0) {
                                $fields[$key] = new CURLFile(realpath(ltrim($value, '@')),
                                                'image/jpg', basename(ltrim($value, '@')));
                            }
                        }
                    } elseif (defined('CURLOPT_SAFE_UPLOAD')) {
                        curl_setopt(self::$ch, CURLOPT_SAFE_UPLOAD, false);
                    }
                }
                curl_setopt(self::$ch, CURLOPT_POSTFIELDS, $fields);
        }
    }

    /* 关闭https验证 */
    if ("https" == substr($url, 0, 5)) {
            curl_setopt(self::$ch, CURLOPT_SSL_VERIFYPEER, false);
            curl_setopt(self::$ch, CURLOPT_SSL_VERIFYHOST, false);
    }

    self::$content = curl_exec(self::$ch);
    curl_close(self::$ch);

    return self::$content;
}

重点分析:
/* 支持文件上传 */
if (class_exists('\CURLFile')) {
    curl_setopt(self::$ch, CURLOPT_SAFE_UPLOAD, true);
        foreach ($fields as $key => $value) {
        if (is_string($value) && strpos($value, '@') === 0) {
            $fields[$key] = new CURLFile(realpath(ltrim($value, '@')));
            }
        }
    } elseif (defined('CURLOPT_SAFE_UPLOAD')) {
        curl_setopt(self::$ch, CURLOPT_SAFE_UPLOAD, false);
}

这里面有个PHP版本的坑,5.4版本只支持用 @ 来进行上传文件,5.5是个过渡版本,支持 @ 和 CURLFile 两种方式上传文件,而到了5.6,就只支持 CURLFile 了。所以需要用兼容模式来适应不同版本。 
关于为什么不用php版本号来判断呢?你用版本号谁知道你是要来判断啥呢?难道加个注释? 
而常量 CURLOPT_SAFE_UPLOAD 是用来开启是否支持 @ 的,当然,5.6版本设置了也没有。 
还有,要上传file的时候,一定要用数组给 curl_setopt(self::fields); 传值,而不能用 http_build_query() ,一个的http请求头中的 content-type 是 multipart/form-date ,另一个是 application/x-www-form-urlencoded 。file用二进制编码进行传输,而普通的post数据是文本传输。 
上面的相关知识还请详看 参考文档。

小结: 
如果你已有上传文件的接口,其实这个功能不算啥,按照官方文档进行 post url 即可。如果没有,或者没有实现文件上传功能,就要对 curl 研究一下了,还要踩一下php版本的坑。。。不过对 curl 掌握就更加全面而牢固了,这难道不是我们的目的?

主要参考文档: 
1、微信公众号开发文档 
2、Multipart/form-data POST文件上传详解 
3、PHP的CURLOPT_POSTFIELDS参数使用数组和字符串的区别 
4、The CURLFile class 
5、考虑 PHP 5.0~5.6 各版本兼容性的 cURL 文件上传

-end-

鲜花
鲜花
鸡蛋
鸡蛋
分享至 : QQ空间
收藏
原作者: e62ces0iem 来自: csdn博客

相关阅读

推荐阅读

    最新Demo