CURLFileを使ったらエラーになった話

のえる のえる
2019.10.11

CURLでファイルアップロードをする際、フォームとして送る時はCURLFileを使うのが一般的となりました。

 

少し前までは「@」を使ったアップロードだったのですが、セキュリティ的な問題もあり、今では使用することはほぼないと思います。

 

今回はそんなCURLFileで発生したエラーについて書いてみようと思います。

 

 

はじめに

今回はCURLを使ったコマンドラインのファイルアップロードに関する記事です。
PHPでCURLを使用する方法や詳細なオプションなどは公式を参照してください。

 

cURL / PHP Manual
CURLFile / PHP Manual

環境

今回は下記のような環境になってます。

 

【テスト環境】
CentOS 7
PHP Version 7.3.10
curl 7.61.1

 

【本番環境】
Windows Server
PHP Version 7.3.2
curl 7.61.1

 

ご覧の通り、ほとんど同じ環境になっています。

CURLFileでファイルアップロード

では、CURLでForm形式のファイルアップロードを行うプログラムを書いていきましょう。

 

この時のポイントは CURLFileにはフルパスを指定する というところです。

 

この転送方法の場合、受ける方のプログラムでは $_FILES で受け取ることができます。

エラーに遭遇する

テスト環境でアップロードができることを確認し、本番に入れたところ $curlInfo[‘http_code’] が 0 で返ってくるエラーに遭遇しました。
開発当初はPHPバージョンやCURLのバージョンが異なっていたため、テスト環境をほぼ同じに合わせてみましたが、結果は変わりませんでした。

 

また curl_errno で取得したエラーコードは 26(CURLE_READ_ERROR) が返ってきているにもかかわらず curl_error は何のエラー文字列も返って来ないという奇妙なエラーでした。

 

通常なら CURLE_READ_ERROR はファイルパーミッションやPOSTの最大ファイルサイズによるものとも考えましたが、ここも特に問題が無く、途方に暮れてしまいました。

今回のエラーの原因

みなさんはここまでの情報で何が原因かわかりましたか?

 

今回の原因はPHPでもApacheでもなく OSの違いによるもの でした。

 

ここでプログラムを見直してみましょう。

 

 

はい、マーカーがついている行が問題となったところです。
お気づきの方もいると思いますが、今回のファイル名は 「日本語(マルチバイト文字)」 が使用されています。

 

日本語(マルチバイト文字)の扱いはOSによって異なります。
今回のエラーは CURLE_READ_ERROR つまり 日本語ファイルが読み込めない という意味だったんです。

 

最近のPHPでのデフォルトエンコードは UTF-8 となっていることが多いですが、Windowsのファイルシステムでは未だ ShiftJIS です。
この違いからファイル名が文字化けしてしまい、読み込めないというものでした。

 

これを解決させるためには、下記のような感じで文字コードを変換してあげればOKでした。

 

これにより、ディレクトリ名に日本語があってもエンコードの変換を行ってファイルがアップできるようになりました。

さいごに

今回のこの情報は、国内外の質問サイトでも全く書いておらず、多大な時間を取られたエラーでした。
今後は日本語ファイル名やディレクトリ名の時は、特に注意して取り扱おうと思いました。

スポンサーリンク

POPULAR

のえる

のえる

Full-stack Developer