PHP のアップロード上限拡大:upload_max_filesize と post_max_size
20 MiB のファイルを受け付けるには、upload_max_filesize = 20M を設定し、post_max_size = 25M で multipart リクエスト全体に余裕を持たせ、アプリケーションと Web サーバーでも許可されていることを確認します。PHP の設定を変更しても、アップロードハンドラーに設定された小さい上限は上書きできません。このガイドでは、有効な設定を特定し、小さなローカルエンドポイントを使って
HTTP 経由で各失敗を再現する方法を説明します。
PHP のファイルアップロード最大サイズを確認するには
アップロード URL を処理する PHP プロセスを確認します。php --ini が示すのはコマンドラインの設定であり、FPM や Apache が読み込んだ設定を確定するものではありません。PHP はサーバーインターフェースごとに異なる設定ファイルを使えます。
次のコードをアップロードエンドポイントと同じ場所に
check_upload_size.php として保存し、同じ Web サイト経由でアクセスします。既存のサイトでは管理者だけがアクセスできるように制限し、診断後に削除してください。ファイルパスは診断に役立ちますが、公開すべき情報ではありません。
<?php
header('Content-Type: application/json');
echo json_encode([
'version' => PHP_VERSION,
'sapi' => PHP_SAPI,
'loaded_ini' => php_ini_loaded_file(),
'scanned_ini' => php_ini_scanned_files(),
'file_uploads' => ini_get('file_uploads'),
'upload_max_filesize' => ini_get('upload_max_filesize'),
'post_max_size' => ini_get('post_max_size'),
'max_file_uploads' => ini_get('max_file_uploads'),
], JSON_PRETTY_PRINT | JSON_THROW_ON_ERROR);
PHP のドキュメントでは、デフォルト値は 2M(upload_max_filesize)、8M(post_max_size)、20(max_file_uploads)とされていますが、インストール環境によって上書きされることがあります。最初の二つはバイト数の上限で、max_file_uploads はファイル数を制限します。PHP のサイズ表記では、20M は 20 × 1,024 × 1,024 バイト、つまり 20 MiB を意味します。コアディレクティブとサイズパーサーを参照してください。
| 層 | 制限の対象 | 確認する点 |
|---|---|---|
| Web サーバーまたはプロキシ | 受信するリクエストボディ | PHP ハンドラーの実行前に拒否される場合は、そのサーバーのログを確認 |
post_max_size | フィールドと multipart のオーバーヘッドを含む POST ボディ全体 | $_POST と $_FILES の両方が空になる場合がある |
upload_max_filesize | アップロードされた各ファイル | ファイルの error フィールドにある UPLOAD_ERR_INI_SIZE |
| アプリケーションの検証 | アプリケーションが受け付けるファイル | PHP の上限より小さい可能性がある、ハンドラーの定数やフレームワークのルール |
PHP のドキュメントには、スーパーグローバルが空になる動作とアップロードエラーコードが記載されています。$_FILES が空というだけでは、リクエストのサイズ超過とは断定できません。ファイルフィールドがない場合にも空になります。
PHP のファイルアップロードサイズを増やすには
上記の診断出力で場所を特定し、Web リクエストで使われる設定を編集します。Ubuntu にパッケージでインストールした PHP 8.3 では、一般に FPM は
/etc/php/8.3/fpm/php.ini、mod_php は /etc/php/8.3/apache2/php.ini を使います。これらの例より、診断で報告されたパスと実際の設定値を優先してください。
file_uploads = On
upload_max_filesize = 20M
post_max_size = 25M
display_errors = Off
log_errors = On
設定を変更したら、PHP を実行するサービスを再読み込みします。FPM なら該当する
FPM サービス、mod_php なら Apache です。診断 URL に再度アクセスし、実際の設定値を確認します。この二つのサイズディレクティブは INI_PERDIR 設定なので、ini_set() を upload.php 内で使っても引き上げられません。設定でエラー表示を無効にすると、リクエストの解析中に発生した警告が
JSON レスポンスに混入することも防げます。
PHP-FPM 設定の使用
プールは php.ini を上書きできます。値がまだ異なる場合は、このサイトを処理するプールを確認してください。20 MiB の上限に対応するプール設定は
php_admin_value[upload_max_filesize] = 20M と php_admin_value[post_max_size] = 25M です。FPM の設定リファレンスにプールでの上書きの説明があります。対象の FPM サービスを再読み込みし、HTTP 経由で再確認します。
.htaccess の使用(mod_php を使う Apache 2.4 以降)
PHP を Apache モジュールとして実行する場合、サーバーがこれらの上書きを許可していれば、php_value upload_max_filesize 20M と php_value post_max_size 25M を
.htaccess に記述できます。これらは PHP-FPM の設定ではありません。サイトの前段に Apache があるという理由だけで追加しないでください。PHP の Apache 設定手順を参照してください。
リクエストが PHP に到達しない場合は、上流のボディサイズ上限を確認します。Nginx の client_max_body_sizeはデフォルトが 1m で、サイズ超過のリクエストに 413 を返します。この例では、client_max_body_size 25m; で想定する multipart リクエストを許可できます。Apache には LimitRequestBodyがあり、ホスティング環境のプロキシが別の上限を課す場合もあります。すべての層でリクエスト全体を収める余裕を確保してください。PHP の上限を引き上げても、これらの設定は変わりません。
PHP でのファイルアップロード機能の実装
64 ビット版 PHP 8.3 以降、Fileinfo 拡張、cURL を備えたローカルの Linux 環境を使います。サポート対象のブランチの最新パッチ、または同等のセキュリティ修正がバックポートされたベンダーパッケージを選んでください。PHP の 2026年10月21日のセキュリティリリースでは、PHP 8.3.36、8.4.27、8.5.12 で二つの重大な脆弱性が修正されました。それより前のバージョンでは、修正の有無をベンダーに確認してください。以下の例は PHP 8.3.36 と 8.5.12 でテストしています。PHP の組み込みサーバーはローカル開発用です。FPM、Apache、プロキシを使ったデプロイ環境を再現するものではありません。
PHP の別の 10月23日のセッションに関するアドバイザリーは、session.serialize_handler を php_binary または
php_serialize に設定し、切り替え先を php として
ini_set() で session_start() の前に切り替え、セッションのアップロード進捗機能を有効にしているアプリケーションに関するものです。この構成では、起動時の設定で session.upload_progress.enabled=0 を設定し、PHP ワーカーを再起動してください。この予防措置は 10月21日の更新を補完するものです。以下のハンドラーはセッションを開始せず、シリアライザーも切り替えません。
新しいディレクトリを作成します。以下のコマンドは、準備が成功した場合にだけそのディレクトリに移動します。すでに存在する場合は、既存のプロジェクトを上書きせず、別の名前を選んでください。
mkdir php-upload-demo &&
(
cd php-upload-demo &&
mkdir public private &&
chmod 700 private
) &&
cd php-upload-demo
成功した場合にだけ先に進んでください。上記の INI ブロックをこのディレクトリに
php-upload.ini として保存します。診断スクリプトを public/check_upload_size.php として保存します。
PHP アップロードスクリプト
このハンドラー全体を public/upload.php として保存します。APP_MAX_BYTES はアプリケーション独自の上限です。ここでは PHP のファイル単位の上限である 20 MiB に合わせています。ハンドラーは JPEG、PNG、PDF ファイルを受け付け、検出した MIME タイプをファイル名の拡張子と照合し、受け付けたバイト列をドキュメントルートの外にある
private/ 配下に保存します。
<?php
declare(strict_types=1);
const APP_MAX_BYTES = 20 * 1024 * 1024;
header('Content-Type: application/json');
function rejectUpload(int $status, string $code, string $message): never {
http_response_code($status);
echo json_encode([
'success' => false,
'code' => $code,
'message' => $message,
], JSON_THROW_ON_ERROR);
exit;
}
if ($_SERVER['REQUEST_METHOD'] !== 'POST') {
header('Allow: POST');
rejectUpload(405, 'method', 'Send a multipart POST request.');
}
$postLimit = ini_parse_quantity(ini_get('post_max_size'));
$contentLength = $_SERVER['CONTENT_LENGTH'] ?? null;
if ($postLimit > 0 && $contentLength !== null && (int) $contentLength > $postLimit) {
rejectUpload(413, 'post_max_size', 'The complete request exceeds PHP post_max_size.');
}
$file = $_FILES['file'] ?? null;
if (!is_array($file) || array_keys($_FILES) !== ['file'] ||
!isset($file['error'], $file['size'], $file['name'], $file['tmp_name']) ||
!is_int($file['error']) || !is_int($file['size']) ||
!is_string($file['name']) || !is_string($file['tmp_name'])) {
rejectUpload(400, 'invalid_upload', 'Send one file in the file field, without array brackets.');
}
if ($file['error'] !== UPLOAD_ERR_OK) {
[$status, $code, $message] = match ($file['error']) {
UPLOAD_ERR_INI_SIZE => [413, 'upload_max_filesize', 'The file exceeds PHP upload_max_filesize.'],
UPLOAD_ERR_FORM_SIZE => [413, 'form_limit', 'The file exceeds the submitted MAX_FILE_SIZE.'],
UPLOAD_ERR_PARTIAL => [400, 'partial_upload', 'The file arrived incomplete. Retry the upload.'],
UPLOAD_ERR_NO_FILE => [400, 'missing_file', 'Choose a file to upload.'],
default => [500, 'upload_unavailable', 'The upload service is unavailable.'],
};
rejectUpload($status, $code, $message);
}
if (!is_uploaded_file($file['tmp_name'])) {
rejectUpload(400, 'invalid_upload', 'The file is not a valid HTTP upload.');
}
$directory = null;
$destination = null;
try {
$size = filesize($file['tmp_name']);
if ($size === false) {
throw new RuntimeException('Cannot measure upload');
}
if ($size === 0) {
rejectUpload(400, 'empty_file', 'The file is empty.');
}
if ($size > APP_MAX_BYTES) {
rejectUpload(413, 'application_limit', 'The file exceeds the application size limit.');
}
$allowed = [
'image/jpeg' => ['jpg', 'jpeg'],
'image/png' => ['png'],
'application/pdf' => ['pdf'],
];
$mime = (new finfo(FILEINFO_MIME_TYPE))->file($file['tmp_name']);
$extension = strtolower(pathinfo($file['name'], PATHINFO_EXTENSION));
if (!isset($allowed[$mime]) || !in_array($extension, $allowed[$mime], true)) {
rejectUpload(415, 'file_type', 'Send a JPEG, PNG, or PDF with a matching extension.');
}
$hash = hash_file('sha256', $file['tmp_name']);
if ($hash === false) {
throw new RuntimeException('Cannot hash upload');
}
$id = bin2hex(random_bytes(16));
$candidate = dirname(__DIR__) . '/private/' . $id;
// Creating a new directory reserves this ID without overwriting an earlier upload.
if (!@mkdir($candidate, 0700)) {
throw new RuntimeException('Cannot reserve storage');
}
$directory = $candidate;
$destination = $directory . '/file.' . $allowed[$mime][0];
if (!@move_uploaded_file($file['tmp_name'], $destination) || !@chmod($destination, 0600)) {
throw new RuntimeException('Cannot store upload');
}
http_response_code(201);
echo json_encode([
'success' => true,
'id' => $id,
'type' => $mime,
'size' => $size,
'sha256' => $hash,
], JSON_THROW_ON_ERROR);
} catch (Throwable $error) {
if ($destination !== null) {
@unlink($destination);
}
if ($directory !== null) {
@rmdir($directory);
}
error_log('Upload failed: ' . get_class($error));
rejectUpload(500, 'upload_unavailable', 'The upload service is unavailable.');
}
リクエストサイズの確認では Content-Length を使い、ボディのサイズ超過が判明している場合とファイルがない場合を区別します。以下の cURL リクエストはこの長さを送信します。長さがなければ、ハンドラーはこの方法で post_max_size の超過を診断できません。ストリーミング形式のリクエストを使うクライアントには、Web サーバーでボディの上限を適用してください。ini_parse_quantity() は PHP のサイズ接尾辞を処理し、multipart POST のサイズ上限を無効にするゼロの指定にも対応します。
php-upload-demo からサーバーを起動します。空いているポートを選び、以降のリクエストでも同じポートを使ってください。このコマンドで配信するのは public/ だけです。
php -c php-upload.ini -S 127.0.0.1:8080 -t public
そのターミナルは実行したままにします。別のターミナルで同じプロジェクトディレクトリを開き、次のコマンドで確認します。
curl -fsS http://127.0.0.1:8080/check_upload_size.php
sapi が cli-server、upload_max_filesize が 20M、post_max_size が 25M であることを確認します。読み込まれた INI のパスは、このプロジェクトを指しているはずです。作業が終わったら Ctrl+C でサーバーを停止します。
実際の multipart リクエストの送信
サイズ検証を再現できるよう、次のコードをプロジェクトルートに
make-probe.php として保存します。これは、有効な一ピクセルの PNG を作成し、指定したバイト数までパディングを追加します。パディングは意図的なものです。大きな写真を用意せずにバイト数の上限をテストでき、MIME 検出が安全性の判定ではない理由も示せます。排他的作成モードにより、既存の検証用ファイルの上書きを拒否します。
<?php
declare(strict_types=1);
$bytes = filter_var($argv[2] ?? '', FILTER_VALIDATE_INT);
if ($argc !== 3 || $bytes === false || $bytes < 1024 || $bytes > 30 * 1024 * 1024) {
fwrite(STDERR, "Usage: php make-probe.php OUTPUT BYTES (1024 to 31457280)\n");
exit(1);
}
$png = base64_decode('iVBORw0KGgoAAAANSUhEUgAAAAEAAAABAQAAAAA3bvkkAAAACklEQVQI12NoAAAAggCB3UNq9AAAAABJRU5ErkJggg==', true);
$output = @fopen($argv[1], 'xb');
if ($output === false) {
fwrite(STDERR, "Cannot create probe; choose a new output filename.\n");
exit(1);
}
if (fwrite($output, $png) !== strlen($png) || !ftruncate($output, $bytes) || !fclose($output)) {
fwrite(STDERR, "Cannot finish probe.\n");
exit(1);
}
6 MiB のファイルを作成して送信します。-F が
multipart のエンコーディングと境界を設定するため、Content-Type ヘッダーを自分で設定しないでください。-i はレスポンスステータスを表示します。これらの診断呼び出しでは、想定するエラーレスポンスの JSON ボディを読めるよう、cURL の --fail を省いています。
php make-probe.php probe-6.png 6291456 &&
curl -sS -i -F 'file=@probe-6.png' http://127.0.0.1:8080/upload.php
HTTP 201 とともに success: true、type: "image/png"、size: 6291456、ランダムな id、sha256 が返ることを確認します。バイト列は private/<id>/file.png に残り、公開ダウンロード URL はありません。レスポンスのハッシュを、元ファイルからローカルで計算したハッシュと比較します。
php -r 'echo hash_file("sha256", "probe-6.png"), PHP_EOL;'
ちょうど上限の 20 MiB で繰り返した後、PHP の各上限に達する大きさのファイルでも試します。
php make-probe.php probe-20.png 20971520 &&
curl -sS -i -F 'file=@probe-20.png' http://127.0.0.1:8080/upload.php
php make-probe.php probe-21.png 22020096 &&
curl -sS -i -F 'file=@probe-21.png' http://127.0.0.1:8080/upload.php
php make-probe.php probe-26.png 27262976 &&
curl -sS -i -F 'file=@probe-26.png' http://127.0.0.1:8080/upload.php
| ファイル | 記載の設定での想定結果 |
|---|---|
| 6 MiB PNG | 201。バイト列とハッシュが一致した状態で保存 |
| 20 MiB PNG | 201。ファイル単位の上限値ちょうどまで許可 |
| 21 MiB PNG | 413 と code: "upload_max_filesize" |
| 26 MiB PNG | 413 と code: "post_max_size"。リクエスト全体が大きすぎる |
アプリケーションの上限を切り分けるには、サーバーを停止し、次の一時的な上書き設定で再起動します。
php -c php-upload.ini -d upload_max_filesize=24M -S 127.0.0.1:8080 -t public
既存の 21 MiB の検証用ファイルを再度送信します。
curl -sS -i -F 'file=@probe-21.png' http://127.0.0.1:8080/upload.php
今度は 413 と code: "application_limit" が返るはずです。PHP はファイルを許可しますが、APP_MAX_BYTES が拒否します。その後、元のサーバー起動コマンドに戻してください。PHP の上限を引き上げても既存のアプリケーションが 6 MiB のファイルを拒否する場合は、5242880 バイトなどの小さいアプリケーション上限や、フレームワークの検証ルールを探してください。php.ini を変更しても、そのルールは更新されません。
検証用ファイルを作成するコマンドは、既存の検証用ファイルを置き換えません。再送するには、そのファイルの cURL コマンドだけを実行します。内容が同じでも、リクエストが成功するたびに新しい非公開アップロードが作成されます。失敗した場合は、アップロードが保存されたまま残ることはありません。このデモでは、非公開データを削除するまで、成功したアップロードを保持します。
安全なファイルアップロードのベストプラクティス
ディレクトリのセキュリティ
private/ は配信対象のディレクトリの外に置き、PHP アカウントの所有にします。確保する各アップロードディレクトリのモードは
0700、保存するファイルのモードは
0600 です。元のファイル名を保存パスに使うことはありません。PHP の move_uploaded_file()は、移動元が PHP 経由でアップロードされたことを確認しますが、既存の移動先を上書きする場合があります。この例では、ファイルを移動する前に新しいランダムなディレクトリを確保して、上書きを防ぎます。
アップロードエンドポイントの公開前に
このローカルの例には、認証、ユーザーごとのクォータ、マルウェアスキャナー、公開ファイル配信の機能はありません。Fileinfo はバイト列から推定される種類を識別します。その結果も SHA-256 ハッシュも、ファイルが無害であることの証明にはなりません。デプロイするアプリケーションでは、アップロードを許可する対象を決め、ストレージ使用量を制限し、コンテンツを公開する前に検証またはセキュリティスキャンを行ってください。フレームワークやアップロード進捗表示にも同じリクエスト上限とファイル上限が適用され、それらを導入しても上限はなくなりません。
