PHP5.0~5.6 各版本兼容性cURL文件上传功能实例分析


Posted in PHP onMay 11, 2018

本文实例分析了PHP5.0~5.6 各版本兼容性cURL文件上传功能。分享给大家供大家参考,具体如下:

最近做的一个需求,要通过PHP调用cURL,以multipart/form-data格式上传文件。踩坑若干,够一篇文章了。

重要警告

没事不要读PHP的官方中文文档!版本跟不上坑死你!

不同版本PHP之间cURL的区别

PHP的cURL支持通过给CURL_POSTFIELDS传递关联数组(而不是字符串)来生成multipart/form-data的POST请求。

传统上,PHP的cURL支持通过在数组数据中,使用“@+文件全路径”的语法附加文件,供cURL读取上传。这与命令行直接调用cURL程序的语法是一致的:

curl_setopt(ch, CURLOPT_POSTFIELDS, array(
  'file' => '@'.realpath('image.png'),
));

equals

$ curl -F "file=@/absolute/path/to/image.png" <url>

但PHP从5.5开始引入了新的CURLFile类用来指向文件。CURLFile类也可以详细定义MIME类型、文件名等可能出现在multipart/form-data数据中的附加信息。PHP推荐使用CURLFile替代旧的@语法:

curl_setopt(ch, CURLOPT_POSTFIELDS, [
  'file' => new CURLFile(realpath('image.png')),
]);

PHP 5.5另外引入了CURL_SAFE_UPLOAD选项,可以强制PHP的cURL模块拒绝旧的@语法,仅接受CURLFile式的文件。5.5的默认值为false,5.6的默认值为true。

但是坑的一点在于:@语法在5.5就已经被打了deprecated,在5.6中就直接被删除了(会产生 ErorException: The usage of the @filename API for file uploading is deprecated. Please use the CURLFile class instead)。

对于PHP 5.6+而言,手动设置CURL_SAFE_UPLOAD为false是毫无意义的。根本不是字面意义理解的“设置成false,就能开启旧的unsafe的方式”——旧的方式已经作为废弃语法彻底不存在了。PHP 5.6+ == CURLFile only,不要有任何的幻想。

我的部署环境是5.4(仅@语法),但开发环境是5.6(仅CURLFile)。都没有压在5.5这个两者都支持过渡版本上,结果就是必须写出带有环境判断的两套代码。

现在问题来了……

环境判断:小心魔法数字!

我见过这种环境判断的代码:

if (version_compare(phpversion(), '5.4.0') >= 0)

我对这种代码的评价只有一个字:屎。

这个判断掉入了典型的魔法数字陷阱。版本号莫名其妙的出现在代码之中,不查半天PHP手册和更新历史,很难明白作者被卡在了哪个功能的变更上。

代码应该回归本源。我们的实际需求其实是:有CURLFile就优先采用,没有再退化到传统@语法。那么代码就来了:

if (class_exists('\CURLFile')) {
  $field = array('fieldname' => new \CURLFile(realpath($filepath)));
} else {
  $field = array('fieldname' => '@' . realpath($filepath));
}

建议明确指定的退化选项

从可靠的角度,推荐指定CURL_SAFE_UPLOAD的值,明确告知php是容忍还是禁止旧的@语法。注意在低版本PHP中CURLOPT_SAFE_UPLOAD常量本身可能不存在,需要判断:

if (class_exists('\CURLFile')) {
  curl_setopt($ch, CURLOPT_SAFE_UPLOAD, true);
} else {
  if (defined('CURLOPT_SAFE_UPLOAD')) {
    curl_setopt($ch, CURLOPT_SAFE_UPLOAD, false);
  }
}

cURL选项设置的顺序

不管是curl_setopt()单发还是curl_setopt_array()批量,cURL的选项总是设置一个生效一个,而设置好的选项立刻就会影响cURL在设置后续选项时的行为。

例如CURLOPT_SAFE_UPLOAD就和CURLOPT_POSTFIELDS的行为有关。如果先设置CURLOPT_POSTFIELDS再设置CURLOPT_SAFE_UPLOAD,那么后者的约束作用就不会生效。因为设置前者时cURL就已经把数据实际的识读处理完毕了!

cURL有那么几个选项存在这种坑,务必小心。还好这种存在“依赖关系”的选项不多,机制也不复杂,简单处理即可。我的方法是先批量设置所有的选项,然后直到curl_exec()的前一刻才用curl_setopt()单发设置CURLOPT_POSTFIELDS

实际上在curl_setopt_array()用的数组中,保证CURLOPT_POSTFIELDS的位置在后边也是可靠的。PHP的关联数组是有顺序保障的,我们也可以假设curl_setopt_array()内部的执行顺序一定是从头到尾按顺序(好吧我知道assume不是件好事,不过有些实在过分浅显的事实,就容我下个最低限度的断言吧),所以尽可放心。

我的做法只是在代码表现上加个多余的保险,突出强调顺序的重要性防以后手贱。

命名空间

PHP 5.2或以下的版本没有命名空间。代码中用到了空间分隔符\就会引发解析器错误。要照顾PHP 5.2其实容易想,放弃命名空间即可。

要注意的反倒是有命名空间的PHP 5.3+。无论是调用CURLFile还是用class_exists()判断CURLFile的存在性,都推荐写成\CURLFile明确指定顶层空间,防止代码包裹在命名空间内的时候崩掉。

希望本文所述对大家PHP程序设计有所帮助。

PHP 相关文章推荐
php 友好URL的实现(吐血推荐)
Oct 04 PHP
Windows Apache2.2.11及Php5.2.9-1的安装与配置方法
Jun 08 PHP
数组与类使用PHP的可变变量名需要的注意的问题
Jun 20 PHP
php ci框架中加载css和js文件失败的原因及解决方法
Jul 29 PHP
跟我学Laravel之配置Laravel
Oct 15 PHP
PHP版微信公众平台红包API
Apr 02 PHP
PHP实现抓取迅雷VIP账号的方法
Jul 30 PHP
PHP内存使用情况如何获取
Oct 10 PHP
thinkPHP连接sqlite3数据库的实现方法(附Thinkphp代码生成器下载)
May 27 PHP
PHP读取zip文件的方法示例
Nov 17 PHP
PHP实现基于图的深度优先遍历输出1,2,3...n的全排列功能
Nov 10 PHP
PHP设计模式之观察者模式定义与用法分析
Apr 04 PHP
PHP7基于curl实现的上传图片功能
May 11 #PHP
关于ThinkPHP中的异常处理详解
May 11 #PHP
PHP基于递归算法解决兔子生兔子问题
May 11 #PHP
PHP7如何开启Opcode打造强悍性能详解
May 11 #PHP
laravel项目利用twemproxy部署redis集群的完整步骤
May 11 #PHP
PHP实现搜索时记住状态的方法示例
May 11 #PHP
PHP实现压缩图片尺寸并转为jpg格式的方法示例
May 10 #PHP
You might like
phpmyadmin操作流程
2006/10/09 PHP
我的论坛源代码(二)
2006/10/09 PHP
深入理解PHP原理之Session Gc的一个小概率Notice
2011/04/12 PHP
ThinkPHP模板输出display用法分析
2014/11/26 PHP
PHP二维数组矩形转置实例
2016/07/20 PHP
php curl批处理实现可控并发异步操作示例
2018/05/09 PHP
laravel获取不到session的三种解决办法【推荐】
2018/09/16 PHP
javascript中2个感叹号的用法实例详解
2014/09/04 Javascript
JS实现简易图片轮播效果的方法
2015/03/25 Javascript
7个去伪存真的JavaScript面试题
2016/01/07 Javascript
vue-router路由简单案例介绍
2017/02/21 Javascript
video.js 实现视频只能后退不能快进的思路详解
2018/08/09 Javascript
详解如何在Angular优雅编写HTTP请求
2018/12/05 Javascript
JavaScript格式化json和xml的方法示例
2019/01/22 Javascript
小程序扫描普通链接二维码跳转小程序指定界面方法
2019/05/07 Javascript
vue实现计步器功能
2019/11/01 Javascript
js实现无限层级树形数据结构(创新算法)
2020/02/27 Javascript
vue实现购物车加减
2020/05/30 Javascript
[01:08:10]2014 DOTA2国际邀请赛中国区预选赛 SPD-GAMING VS LGD-CDEC
2014/05/22 DOTA
python装饰器使用方法实例
2013/11/21 Python
用python删除java文件头上版权信息的方法
2014/07/31 Python
Python语言描述机器学习之Logistic回归算法
2017/12/21 Python
python实现QQ空间自动点赞功能
2019/04/09 Python
python自定义时钟类、定时任务类
2021/02/22 Python
Django文件上传与下载(FileFlid)
2019/10/06 Python
Python实现清理微信僵尸粉功能示例【基于itchat模块】
2020/05/29 Python
python与pycharm有何区别
2020/07/01 Python
python 列表推导和生成器表达式的使用
2021/02/01 Python
梅西百货官网:Macy’s
2020/08/04 全球购物
共产党员公开承诺书范文
2014/03/28 职场文书
保险公司演讲稿
2014/09/02 职场文书
写作技巧:如何撰写一份优秀的营销策划书
2019/08/13 职场文书
Java输出Hello World完美过程解析
2021/06/13 Java/Android
详解nginx安装过程并代理下载服务器文件
2022/02/12 Servers
世界无敌的ICOM IC-R9500宽频接收机
2022/03/25 无线电
AngularJS实现多级下拉框
2022/03/25 Javascript