方式１：multipart/form-dataを使う

• 単純なAPIならコマンドでも比較的ポンと気軽に送信できるのが魅力
• JSONベースのシステムから送信するときにリクエストを別途組み立てないといけないのが面倒

こういうときに採用すると良さそう

• テキストデータが少なくファイルのやり取りがメインのAPIをつくりたいとき
• コマンドベースで使えるようなシンプルなAPIをつくりたいとき

方式２：JSON＋Base64エンコードを使う

• JSONベースのシステムからAPIを使いやすいのが魅力
• ファイルのエンコード・デコードの処理時間が余分にかかるのと、Base64エンコードすることでファイルサイズが増えるので通信時間が増える

こういうときに採用すると良さそう

• ファイルサイズが小さくテキストデータのやり取りがメインのAPIをつくりたいとき
• リクエストもレスポンスもすべてJSONでやり取りできるAPIをつくりたいとき

方式３：multipart/form-dataとJSONを使い分ける

• JSONベースのシステムから使いやすく、アップロードしたファイルを他のAPIで何度も使いまわしやすいのが魅力
• ファイルアップロードが個別のAPIなため、APIのリクエスト回数が増える

こういうときに採用すると良さそう

• サイズの大きいファイルと複雑なテキストデータのどちらも取り扱うAPIをつくりたいとき
• アップロードしたファイルを何度も使いまわせるAPIをつくりたいとき

やろうとしたこと

• HTTPのmultipart/form-dataで送られてきたファイルをリネームして保存する
• ファイルが無ければエラーにする

サンプルコード（修正前）

/**
 * ファイル保存
 */
public function uploadFile(Request $request)
{
    // ①リクエストからファイルを取り出す
    $file = $request->files->get('file');
    
    // ②ファイルが一時的に保存されているパスを取得
    $tmpFilePath = $file->getRealPath();
    
    // ③ファイル存在チェック
    if (!$tmpFilePath) {
        return 'ファイルが見つかりません';
    }
    
    // ④ファイル名をリネーム
    $newFilePath = $this->makeNewPath($tmpFilePath);
    rename($tmpFilePath, $newFilePath);

    // ⑤ファイル保存
    $this->saveFile($tmpFilePath);

    return '成功しました';
}

起きたこと

// $tmpFilePath : '/opt/myWebApp/public'

対処

// $tmpFilePath : '' ←ファイルサイズ上限オーバーのときは空文字が返ってくる（期待通り）

サンプルコード（修正後）

/**
 * ファイル保存
 */
public function uploadFile(Request $request)
{
    // ①リクエストからファイルを取り出す
    $file = $request->files->get('file');
    
    // ②ファイルが一時的に保存されているパスを取得
    $tmpFilePath = $file->getPathname(); // getRealPath ではなく getPathname を使用
    
    // ③ファイル存在チェック
    if (!$tmpFilePath || is_dir($tmpFilePath)) { // パスがディレクトリだった場合もエラーにしておく
        return 'ファイルが見つかりません';
    }
    
    // ④ファイル名をリネーム
    $newFilePath = $this->makeNewPath($tmpFilePath);
    rename($tmpFilePath, $newFilePath);

    // ⑤ファイル保存
    $this->saveFile($tmpFilePath);

    return '成功しました';
}

原因推測

• SplFileInfo::getPathname
  • ファイルへのパスを取得する
• SplFileInfo::getRealPath
  • ファイルへの絶対パスを取得する