namespace Psr\Http\Message;

use Psr\Http\Message\StreamInterface;
use Psr\Http\Message\UploadedFileInterface;

interface UploadedFileFactoryInterface
{
    /**
     * 新しいアップロードファイルを作成します。
     *
     * サイズが指定されていない場合は、ストリームのサイズを確認することによって決定されます。
     *
     * @link http://php.net/manual/features.file-upload.post-method.php
     * @link http://php.net/manual/features.file-upload.errors.php
     *
     * @param StreamInterface $stream アップロードされたファイルコンテンツを表す基になるストリーム。
     * @param int $size ファイルのサイズ（バイト単位）。
     * @param int $error PHPファイルのアップロードエラー。
     * @param string $clientFilename クライアントが提供するファイル名（存在する場合）。
     * @param string $clientMediaType クライアントが提供するメディアタイプ（存在する場合）。
     *
     * @throws \InvalidArgumentException ファイルリソースが読み取り可能でない場合。
     */
    public function createUploadedFile(
        StreamInterface $stream,
        int $size = null,
        int $error = \UPLOAD_ERR_OK,
        string $clientFilename = null,
        string $clientMediaType = null
    ): UploadedFileInterface;
}