PHP Academy · 강의

파일 업로드 처리

_FILES 슈퍼전역 변수를 사용해 업로드된 파일을 안전하게 처리합니다.

파일 업로드 처리은(는) CoddyKit의 무료 PHP Academy 강의입니다. 이것은 4개 중 4번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 AI 튜터와 함께 브라우저에서 직접 실습할 수 있습니다. 이 강의는 PHP Academy 학습 경로의 일부이며, 진행 상황이 웹과 CoddyKit 앱에 동기화됩니다. PHP Academy 강의에는 총 4개의 강의가 포함되어 있습니다.

PHP 파일 업로드 개요

PHP는 $_FILES 슈퍼글로벌을 통해 파일 업로드를 처리합니다. 폼은 method="POST" 및 enctype="multipart/form-data"를 사용해야 합니다.

HTML 업로드 폼

단일 파일 및 여러 파일 업로드를 위한 HTML 폼 설정입니다:

<!-- Single file -->
<form method="POST" action="upload.php"
      enctype="multipart/form-data">
    <input type="file" name="document">
    <button>Upload</button>
</form>

<!-- Multiple files -->
<form method="POST" enctype="multipart/form-data">
    <input type="file" name="photos[]" multiple>
    <button>Upload All</button>
</form>

$_FILES 구조

업로드된 각 파일에는 $_FILES에 다섯 개의 항목이 있습니다:

<?php
$file = $_FILES['document'];

echo $file['name'];      // original name: report.pdf
echo $file['type'];      // browser-reported MIME: application/pdf
echo $file['tmp_name'];  // server temp path: /tmp/phpXXXXXX
echo $file['error'];     // error code: 0 = UPLOAD_ERR_OK
echo $file['size'];      // file size in bytes

업로드 오류 코드

처리하기 전에 항상 $file['error']를 확인합니다:

<?php
$errorMessages = [
    UPLOAD_ERR_INI_SIZE   => 'Exceeds upload_max_filesize in php.ini',
    UPLOAD_ERR_FORM_SIZE  => 'Exceeds MAX_FILE_SIZE in form',
    UPLOAD_ERR_PARTIAL    => 'Only partially uploaded',
    UPLOAD_ERR_NO_FILE    => 'No file uploaded',
    UPLOAD_ERR_NO_TMP_DIR => 'Missing temp folder',
    UPLOAD_ERR_CANT_WRITE => 'Failed to write to disk',
    UPLOAD_ERR_EXTENSION  => 'PHP extension stopped upload',
];

$err = $_FILES['doc']['error'];
if ($err !== UPLOAD_ERR_OK) {
    die($errorMessages[$err] ?? 'Unknown error');
}

안전한 파일 유형 유효성 검사

브라우저가 제공하는 MIME 유형을 절대 신뢰하지 말고 실제 파일 콘텐츠로 확인합니다:

<?php
$tmp  = $_FILES['image']['tmp_name'];
$allowed = ['image/jpeg', 'image/png', 'image/webp'];

// Check real MIME type from file content
$realMime = mime_content_type($tmp);

if (!in_array($realMime, $allowed)) {
    die('Invalid file type: ' . $realMime);
}

파일 크기 유효성 검사

HTML 폼에 MAX_FILE_SIZE 숨김 필드가 있더라도 서버 측 크기 제한을 적용합니다:

<?php
$maxBytes = 5 * 1024 * 1024;  // 5MB
$size     = $_FILES['video']['size'];

if ($size > $maxBytes) {
    $mb = round($size / 1024 / 1024, 2);
    die("File too large: {$mb}MB (max 5MB)");
}

is_uploaded_file 및 move_uploaded_file

파일이 HTTP 업로드를 통해 전송되었는지 확인하고 안전하게 이동하려면 항상 이 두 함수를 사용합니다:

<?php
$tmp  = $_FILES['photo']['tmp_name'];
$dest = '/var/www/uploads/' . basename($_FILES['photo']['name']);

if (!is_uploaded_file($tmp)) {
    die('Not an uploaded file — possible attack');
}

if (!move_uploaded_file($tmp, $dest)) {
    die('Failed to move uploaded file');
}

echo 'Upload saved to: ' . $dest;

안전한 파일 이름 생성

디렉터리 순회 및 덮어쓰기 공격을 방지하려면 무작위 파일 이름을 생성합니다:

<?php
$originalName = $_FILES['doc']['name'];
$ext          = strtolower(pathinfo($originalName, PATHINFO_EXTENSION));

$allowedExts = ['jpg', 'jpeg', 'png', 'pdf'];
if (!in_array($ext, $allowedExts)) {
    die('File type not allowed');
}

$safeName = bin2hex(random_bytes(16)) . '.' . $ext;
$dest     = '/var/www/uploads/' . $safeName;

move_uploaded_file($_FILES['doc']['tmp_name'], $dest);

여러 파일 업로드 처리

name="photos[]"을 사용하면 $_FILES에 배열이 포함되므로 배열을 순회합니다:

<?php
$files = $_FILES['photos'];
$count = count($files['name']);

for ($i = 0; $i < $count; $i++) {
    if ($files['error'][$i] !== UPLOAD_ERR_OK) continue;
    
    $tmp  = $files['tmp_name'][$i];
    $ext  = pathinfo($files['name'][$i], PATHINFO_EXTENSION);
    $dest = '/uploads/' . uniqid() . '.' . strtolower($ext);
    
    move_uploaded_file($tmp, $dest);
    echo "Saved: $dest" . PHP_EOL;
}

php.ini 업로드 설정

파일 업로드에 영향을 주는 주요 php.ini 지시어:

file_uploads = On — 업로드를 활성화합니다
upload_max_filesize = 8M — 단일 파일의 최대 크기입니다
post_max_size = 32M — 최대 POST 본문 크기입니다(upload_max_filesize보다 커야 합니다)
max_file_uploads = 20 — 요청당 최대 파일 수입니다

업로드 후 이미지 크기 조정

업로드 후 이미지 크기를 조정하려면 GD 라이브러리를 사용합니다:

<?php
function resizeImage(string $src, string $dst, int $maxW): void {
    [$w, $h, $type] = getimagesize($src);
    $ratio   = $maxW / $w;
    $newH    = (int) ($h * $ratio);
    $srcImg  = imagecreatefromjpeg($src);
    $dstImg  = imagecreatetruecolor($maxW, $newH);
    imagecopyresampled($dstImg, $srcImg, 0,0,0,0, $maxW, $newH, $w, $h);
    imagejpeg($dstImg, $dst, 90);
    imagedestroy($srcImg);
    imagedestroy($dstImg);
}

빠른 확인

업로드된 파일을 최종 대상 위치로 안전하게 이동하는 데 필요한 PHP 함수는 무엇인가요?

복습: 파일 업로드

업로드 처리 확인 목록:

폼은 method=POST enctype=multipart/form-data를 사용해야 합니다
$_FILES['field']['error'] === UPLOAD_ERR_OK를 확인합니다
mime_content_type()로 실제 MIME 유형을 확인합니다
서버 측에서 파일 크기를 확인합니다
move_uploaded_file()을 사용합니다 — rename/copy는 사용하지 않습니다
충돌을 방지하려면 무작위 파일 이름을 생성합니다

자주 묻는 질문

“파일 업로드 처리” 강의는 무료인가요?

네 — “파일 업로드 처리” 전체 내용을 이 웹사이트에서 무료로 읽을 수 있습니다. 인터랙티브하게 실습하려면(내장 코드 에디터와 24/7 AI 튜터), CoddyKit PRO로 업그레이드하면 PHP Academy 강의 전체를 잠금 해제할 수 있습니다. PHP Academy 강의에는 총 4개의 강의가 포함되어 있습니다.

“파일 업로드 처리”에서 뭘 배우나요?

_FILES 슈퍼전역 변수를 사용해 업로드된 파일을 안전하게 처리합니다. 브라우저에서 직접 실행하는 실습 코드로 PHP Academy을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.

PHP Academy을(를) 시작하는 데 경험이 필요한가요?

사전 경험은 필요하지 않습니다. CoddyKit의 PHP Academy은(는) 초급자부터 고급 학습자까지를 위해 구성되어 있으므로, 여기서 시작하거나 처음부터 시작할 수 있으며 자신의 속도대로 진행할 수 있습니다. 이것은 4개 중 4번째 강의입니다.

“파일 업로드 처리” 강의는 얼마나 걸리나요?

대부분의 CoddyKit 강의는 약 5~10분이 소요됩니다. 각 강의는 간결하고 인터랙티브하여 꾸준한 진행이 가능하며, 웹과 앱에서 중단한 부분부터 바로 시작할 수 있습니다.

이 PHP Academy 강의에서 코드를 작성하고 실행할 수 있나요?

네. 모든 PHP Academy 강의에는 내장 코드 에디터가 포함되어 있으므로, 브라우저에서 바로 실제 코드를 작성하고 실행한 후 즉시 AI 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.

이 강의의 모든 강의

← PHP Academy(으)로 돌아가기