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

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-