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 和 COM
Oct 09 PHP
PHP脚本的10个技巧(1)
Oct 09 PHP
PHP 如何向 MySQL 发送数据
Oct 09 PHP
php后门URL的防范
Nov 12 PHP
php生成短网址示例
May 05 PHP
php实现简单的MVC框架实例
Sep 23 PHP
PHP连接MSSQL方法汇总
Feb 05 PHP
[原创]php简单防盗链验证实现方法
Jul 09 PHP
php 判断字符串编码是utf-8 或gb2312实例
Nov 01 PHP
降低PHP Redis内存占用
Mar 23 PHP
PHP实现的多维数组排序算法分析
Feb 10 PHP
PHP 中 var_export、print_r、var_dump 调试中的区别
Jun 19 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 xml常用函数的集合(比较详细)
2013/06/06 PHP
Laravel 5框架学习之用户认证
2015/04/09 PHP
PHP简单获取上月、本月、近15天、近30天的方法示例
2017/07/03 PHP
JavaScript中令你抓狂的魔术变量
2006/11/30 Javascript
Javascript JSQL,SQL无处不在,
2010/05/05 Javascript
Javascript判断对象是否相等实现代码
2013/03/18 Javascript
基于JavaScript实现继承机制之原型链(prototype chaining)的详解
2013/05/07 Javascript
Javascript 垃圾收集机制介绍理解
2013/05/14 Javascript
jquery使用append(content)方法注意事项分享
2014/01/06 Javascript
jquery实现省市select下拉框的替换(示例代码)
2014/02/22 Javascript
浅谈Javascript中深复制
2014/12/01 Javascript
jQuery增加与删除table列的方法
2016/03/01 Javascript
angularJS的radio实现单项二选一的使用方法
2018/02/28 Javascript
vue移动端轻量级的轮播组件实现代码
2018/07/12 Javascript
详解Koa中更方便简单发送响应的方式
2018/07/20 Javascript
vue移动端微信授权登录插件封装的实例
2018/08/28 Javascript
vue 实现 rem 布局或vw 布局的方法
2019/11/13 Javascript
JS实现点击下拉列表文本框中出现对应的网址,点击跳转按钮实现跳转
2019/11/25 Javascript
微信小程序wx.navigateTo方法里的events参数使用详情及场景
2020/01/07 Javascript
浅析vue中的nextTick
2020/12/28 Vue.js
[30:00]完美世界DOTA2联赛PWL S2 Rebirth vs LBZS 第二场 11.28
2020/12/01 DOTA
使用DataFrame删除行和列的实例讲解
2018/04/08 Python
python 创建一个空dataframe 然后添加行数据的实例
2018/06/07 Python
python树莓派红外反射传感器
2019/01/21 Python
记录Python脚本的运行日志的方法
2019/06/05 Python
python os.path.isfile 的使用误区详解
2019/11/29 Python
使用Matplotlib 绘制精美的数学图形例子
2019/12/13 Python
解决Pytorch自定义层出现多Variable共享内存错误问题
2020/06/28 Python
经营管理策划方案
2014/05/22 职场文书
母亲节演讲稿
2014/05/27 职场文书
区域销售主管岗位职责
2014/06/15 职场文书
个人专业技术总结
2015/03/05 职场文书
自荐信模板大全
2015/03/27 职场文书
红色经典观后感
2015/06/18 职场文书
Redis 哨兵集群的实现
2021/06/18 Redis
Python中文分词库jieba(结巴分词)详细使用介绍
2022/04/07 Python