PHP5.0~5.6 各版本兼容性cURL文件上傳功能實(shí)例分析
本文實(shí)例分析了PHP5.0~5.6 各版本兼容性cURL文件上傳功能。分享給大家供大家參考,具體如下:
最近做的一個需求,要通過PHP調(diào)用cURL,以multipart/form-data格式上傳文件。踩坑若干,夠一篇文章了。
重要警告
沒事不要讀PHP的官方中文文檔!版本跟不上坑死你!
不同版本PHP之間cURL的區(qū)別
PHP的cURL支持通過給CURL_POSTFIELDS
傳遞關(guān)聯(lián)數(shù)組(而不是字符串)來生成multipart/form-data
的POST請求。
傳統(tǒng)上,PHP的cURL支持通過在數(shù)組數(shù)據(jù)中,使用“@+文件全路徑”的語法附加文件,供cURL讀取上傳。這與命令行直接調(diào)用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類也可以詳細(xì)定義MIME類型、文件名等可能出現(xiàn)在multipart/form-data數(shù)據(jù)中的附加信息。PHP推薦使用CURLFile替代舊的@
語法:
curl_setopt(ch, CURLOPT_POSTFIELDS, [ 'file' => new CURLFile(realpath('image.png')), ]);
PHP 5.5另外引入了CURL_SAFE_UPLOAD
選項(xiàng),可以強(qiáng)制PHP的cURL模塊拒絕舊的@
語法,僅接受CURLFile式的文件。5.5的默認(rèn)值為false,5.6的默認(rèn)值為true。
但是坑的一點(diǎn)在于:@
語法在5.5就已經(jīng)被打了deprecated,在5.6中就直接被刪除了(會產(chǎn)生 ErorException: The usage of the @filename
API for file uploading is deprecated. Please use the CURLFile class instead)。
對于PHP 5.6+而言,手動設(shè)置CURL_SAFE_UPLOAD
為false是毫無意義的。根本不是字面意義理解的“設(shè)置成false,就能開啟舊的unsafe的方式”——舊的方式已經(jīng)作為廢棄語法徹底不存在了。PHP 5.6+ == CURLFile only,不要有任何的幻想。
我的部署環(huán)境是5.4(僅@語法),但開發(fā)環(huán)境是5.6(僅CURLFile)。都沒有壓在5.5這個兩者都支持過渡版本上,結(jié)果就是必須寫出帶有環(huán)境判斷的兩套代碼。
現(xiàn)在問題來了……
環(huán)境判斷:小心魔法數(shù)字!
我見過這種環(huán)境判斷的代碼:
if (version_compare(phpversion(), '5.4.0') >= 0)
我對這種代碼的評價只有一個字:屎。
這個判斷掉入了典型的魔法數(shù)字陷阱。版本號莫名其妙的出現(xiàn)在代碼之中,不查半天PHP手冊和更新歷史,很難明白作者被卡在了哪個功能的變更上。
代碼應(yīng)該回歸本源。我們的實(shí)際需求其實(shí)是:有CURLFile就優(yōu)先采用,沒有再退化到傳統(tǒng)@
語法。那么代碼就來了:
if (class_exists('\CURLFile')) { $field = array('fieldname' => new \CURLFile(realpath($filepath))); } else { $field = array('fieldname' => '@' . realpath($filepath)); }
建議明確指定的退化選項(xiàng)
從可靠的角度,推薦指定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選項(xiàng)設(shè)置的順序
不管是curl_setopt()
單發(fā)還是curl_setopt_array()
批量,cURL的選項(xiàng)總是設(shè)置一個生效一個,而設(shè)置好的選項(xiàng)立刻就會影響cURL在設(shè)置后續(xù)選項(xiàng)時的行為。
例如CURLOPT_SAFE_UPLOAD
就和CURLOPT_POSTFIELDS
的行為有關(guān)。如果先設(shè)置CURLOPT_POSTFIELDS
再設(shè)置CURLOPT_SAFE_UPLOAD
,那么后者的約束作用就不會生效。因?yàn)樵O(shè)置前者時cURL就已經(jīng)把數(shù)據(jù)實(shí)際的識讀處理完畢了!
cURL有那么幾個選項(xiàng)存在這種坑,務(wù)必小心。還好這種存在“依賴關(guān)系”的選項(xiàng)不多,機(jī)制也不復(fù)雜,簡單處理即可。我的方法是先批量設(shè)置所有的選項(xiàng),然后直到curl_exec()
的前一刻才用curl_setopt()
單發(fā)設(shè)置CURLOPT_POSTFIELDS
。
實(shí)際上在curl_setopt_array()
用的數(shù)組中,保證CURLOPT_POSTFIELDS
的位置在后邊也是可靠的。PHP的關(guān)聯(lián)數(shù)組是有順序保障的,我們也可以假設(shè)curl_setopt_array()
內(nèi)部的執(zhí)行順序一定是從頭到尾按順序(好吧我知道assume不是件好事,不過有些實(shí)在過分淺顯的事實(shí),就容我下個最低限度的斷言吧),所以盡可放心。
我的做法只是在代碼表現(xiàn)上加個多余的保險(xiǎn),突出強(qiáng)調(diào)順序的重要性防以后手賤。
命名空間
PHP 5.2或以下的版本沒有命名空間。代碼中用到了空間分隔符\
就會引發(fā)解析器錯誤。要照顧PHP 5.2其實(shí)容易想,放棄命名空間即可。
要注意的反倒是有命名空間的PHP 5.3+。無論是調(diào)用CURLFile還是用class_exists()
判斷CURLFile的存在性,都推薦寫成\CURLFile
明確指定頂層空間,防止代碼包裹在命名空間內(nèi)的時候崩掉。
更多關(guān)于PHP相關(guān)內(nèi)容感興趣的讀者可查看本站專題:《php curl用法總結(jié)》、《PHP網(wǎng)絡(luò)編程技巧總結(jié)》、《PHP數(shù)組(Array)操作技巧大全》、《php字符串(string)用法總結(jié)》、《PHP數(shù)據(jù)結(jié)構(gòu)與算法教程》、《php程序設(shè)計(jì)算法總結(jié)》及《PHP運(yùn)算與運(yùn)算符用法總結(jié)》
希望本文所述對大家PHP程序設(shè)計(jì)有所幫助。
- php使用curl下載指定大小的文件實(shí)例代碼
- php使用curl實(shí)現(xiàn)ftp文件下載功能
- php使用curl模擬瀏覽器表單上傳文件或者圖片的方法
- PHP使用curl請求實(shí)現(xiàn)post方式上傳圖片文件功能示例
- PHP實(shí)現(xiàn)通過CURL上傳文件功能示例
- 可兼容php5與php7的cURL文件上傳功能實(shí)例分析
- PHP使用curl模擬post上傳及接收文件的方法
- php curl 上傳文件代碼實(shí)例
- php下利用curl判斷遠(yuǎn)程文件是否存在的實(shí)現(xiàn)代碼
- PHP使用CURL實(shí)現(xiàn)下載文件功能示例
相關(guān)文章
php?overtrue/pinyin拓展實(shí)現(xiàn)漢字轉(zhuǎn)拼音
這篇文章主要為大家介紹了php?overtrue/pinyin拓展實(shí)現(xiàn)漢字轉(zhuǎn)拼音示例,有需要的朋友可以借鑒參考下,希望能夠有所幫助,祝大家多多進(jìn)步,早日升職加薪2023-11-11php采用curl訪問域名返回405 method not allowed提示的解決方法
這篇文章主要介紹了php采用curl訪問域名返回405 method not allowed提示的解決方法,需要的朋友可以參考下2014-06-06PHP Laravel軟刪除的實(shí)現(xiàn)方法介紹
軟刪除就是邏輯刪除,數(shù)據(jù)保留單標(biāo)記上刪除狀態(tài),一般我們會用刪除時間來作為標(biāo)記,這樣標(biāo)記狀態(tài)有了,刪除時間也有了2022-09-09PHP實(shí)現(xiàn)守護(hù)進(jìn)程的示例代碼
守護(hù)進(jìn)程到底是怎么實(shí)現(xiàn)的?為什么有的程序既可以自己就成為守護(hù)進(jìn)程,又可以通過systemd 來后臺運(yùn)行?本文將為大家具體講解,感興趣的可以了解一下2022-05-05PHP實(shí)現(xiàn)獲取ip地址的5種方法,以及插入用戶登錄日志操作示例
這篇文章主要介紹了PHP實(shí)現(xiàn)獲取ip地址的5種方法,以及插入用戶登錄日志操作,結(jié)合實(shí)例形式總結(jié)分析了php獲取訪客IP地址的5種常見操作方法,以及將用戶登陸信息寫入登陸日志數(shù)據(jù)庫相關(guān)操作技巧,需要的朋友可以參考下2019-02-02