PHP 5.0~5.6 各版本兼容的cURL文件上傳

最近做的一個需求，使用PHP cURL上傳文件。踩坑若干，整理如下。

不同版本PHP之間cURL的區別

PHP的cURL支持通過給CURL_POSTFIELDS傳遞關聯數組(而不是字符串)來生成multipart/form-data的POST請求。

傳統上，PHP的cURL支持通過在數組數據中，使用“@+文件全路徑”的語法附加文件，供cURL讀取上傳。這與命令行直接調用cURL程序的語法是一致的：

1 curl_setopt(ch, CURLOPT_POSTFIELDS, array(

2 'file' => '@'.realpath('image.png'),

3 ));

4 equals

5 $ curl -F "file=@/absolute/path/to/image.png"

但PHP從5.5開始引入了新的CURLFile類用來指向文件。CURLFile類也可以詳細定義MIME類型、文件名等可能出現在multipart/form-data數據中的附加信息。PHP推薦使用CURLFile替代舊的@語法：

1 curl_setopt(ch, CURLOPT_POSTFIELDS, [

2 'file' => new CURLFile(realpath('image.png')),

3 ]);

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這個兩者都支持過渡版本上，結果就是必須寫出帶有環境判斷的兩套代碼。

現在問題來了……環境判斷：小心魔法數字！

我見過這種環境判斷的代碼：

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

這個判斷掉入了典型的魔法數字陷阱。版本號莫名其妙的出現在代碼之中，不查半天PHP手冊和更新歷史，很難明白作者被卡在了哪個功能的變更上。

代碼應該回歸本源。我們的實際需求其實是：有CURLFile就優先采用，沒有再退化到傳統@語法。那么代碼就來了：

1 if (class_exists('\CURLFile')) {

2 $field = array('fieldname' => new \CURLFile(realpath($filepath)));

3 } else {

4 $field = array('fieldname' => '@' . realpath($filepath));

5 }

建議明確指定的退化選項

從可靠的角度，推薦指定CURL_SAFE_UPLOAD的值，明確告知php是容忍還是禁止舊的@語法。注意在低版本PHP中CURLOPT_SAFE_UPLOAD常量本身可能不存在，需要判斷：

1 if (class_exists('\CURLFile')) {

2 curl_setopt($ch, CURLOPT_SAFE_UPLOAD, true);

3 } else {

4 if (defined('CURLOPT_SAFE_UPLOAD')) {

5 curl_setopt($ch, CURLOPT_SAFE_UPLOAD, false);

6 }

7 }

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()內部的執行順序一定是從頭到尾按順序[注A]，所以盡可放心。

我的做法只是在代碼表現上加個多余的保險，突出強調順序的重要性防以后手賤。

命名空間

PHP 5.2或以下的版本沒有命名空間。代碼中用到了空間分隔符\就會引發解析器錯誤。要照顧PHP 5.2其實容易想，放棄命名空間即可。

要注意的反倒是有命名空間的PHP 5.3+。無論是調用CURLFile還是用class_exists()判斷CURLFile的存在性，都推薦寫成\CURLFile明確指定頂層空間，防止代碼包裹在命名空間內的時候崩掉。

最后兼容各版本代碼如下：

1 <?php

2

3 /* http://localhost/upload.php:

4 print_r($_POST);

5 print_r($_FILES);

6 */

7

8 $ch = curl_init();

9

10 $filePath = '/home/vagrant/test.png';

11 $data = array('name' => 'Foo', 'file' => '@' . $filePath);

12

13 //兼容5.0-5.6版本的curl

14 if (class_exists('\CURLFile')) {

15 $data['file'] = new \CURLFile(realpath($filePath));

16 } else {

17 if (defined('CURLOPT_SAFE_UPLOAD')) {

18 curl_setopt($ch, CURLOPT_SAFE_UPLOAD, FALSE);

19 }

20 }

21

22 curl_setopt($ch, CURLOPT_URL, 'http://localhost/test/curl/load_file.php');

23 curl_setopt($ch, CURLOPT_POST, 1);

24 curl_setopt($ch, CURLOPT_POSTFIELDS, $data);

25

26 curl_exec($ch);

27 ?>

總結

以上是生活随笔為你收集整理的php curl上传文件返回false,php curl上传文件$_FILES为空的问题的全部內容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網站內容還不錯，歡迎將生活随笔推薦給好友。