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 分页类实现代码
Dec 03 PHP
PHP MemCached 高级缓存应用代码
Aug 05 PHP
如何用php获取程序执行的时间
Jun 09 PHP
php解决约瑟夫环示例
Apr 09 PHP
codeigniter中测试通过的分页类示例
Apr 17 PHP
PHP采用XML-RPC构造Web Service实例教程
Jul 16 PHP
PHP中返回引用类型的方法
Apr 03 PHP
基于OpenCart 开发支付宝,财付通,微信支付参数错误问题
Oct 01 PHP
php 5.4 全新的代码复用Trait详解
Jan 05 PHP
PHP PDOStatement::getColumnMeta讲解
Feb 01 PHP
PHP判断一个变量是否为整数、正整数的方法示例
Sep 11 PHP
PHP数据源架构模式之表入口模式实例分析
Jan 23 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
一个用php实现的获取URL信息的类
2007/01/02 PHP
基于Linux调试工具strace与gdb的常用命令总结
2013/06/03 PHP
PHP冒泡算法详解(递归实现)
2014/11/10 PHP
PHP中curl_setopt函数用法实例分析
2015/04/16 PHP
php中注册器模式类用法实例分析
2015/11/03 PHP
php通过PHPExcel导入Excel表格到MySQL数据库的简单实例
2016/10/29 PHP
阻止JavaScript事件冒泡传递(cancelBubble 、stopPropagation)
2007/05/08 Javascript
javascript 可以拖动的DIV(二)
2009/06/26 Javascript
js获取height和width的方法说明
2013/01/06 Javascript
jquery中页面Ajax方法$.load的功能使用介绍
2014/10/20 Javascript
做web开发 先学JavaScript
2014/12/12 Javascript
JavaScript优化专题之Loading and Execution加载和运行
2016/01/20 Javascript
微信小程序 wx:key详细介绍
2016/10/28 Javascript
layer实现弹窗提交信息
2016/12/12 Javascript
jQuery使用正则表达式替换dom元素标签用法示例
2017/01/16 Javascript
react-native中ListView组件点击跳转的方法示例
2017/09/30 Javascript
Vue.js组件通信的几种姿势
2017/10/23 Javascript
AngularJS实现图片上传和预览功能的方法分析
2017/11/08 Javascript
jquery在启动页面时,自动加载数据的实例
2018/01/22 jQuery
axios拦截设置和错误处理方法
2018/03/05 Javascript
express默认日志组件morgan的方法
2018/04/05 Javascript
vue.js使用3DES加密的方法示例
2018/05/18 Javascript
微信小程序实现图片上传放大预览删除代码
2020/06/28 Javascript
浅谈Vue为什么不能检测数组变动
2019/10/14 Javascript
[33:39]DOTA2上海特级锦标赛C组小组赛#2 LGD VS Newbee第二局
2016/02/27 DOTA
python3 使用Opencv打开USB摄像头,配置1080P分辨率的操作
2019/12/11 Python
使用pytorch实现论文中的unet网络
2020/06/24 Python
HTML5组件Canvas实现图像灰度化(步骤+实例效果)
2013/04/22 HTML / CSS
处理textarea中的换行和空格
2019/12/12 HTML / CSS
YOOX美国官方网站:全球著名的多品牌时尚网络概念店
2016/09/11 全球购物
美国马匹用品和马钉购物网站:State Line Tack
2018/08/05 全球购物
辩论赛主持词
2014/03/18 职场文书
党员公开承诺事项
2014/03/25 职场文书
党员个人批评与自我批评
2014/10/14 职场文书
如何用RabbitMQ和Swoole实现一个异步任务系统
2021/05/29 PHP
Python编解码问题及文本文件处理方法详解
2021/06/20 Python