PHP 파일 업로드

1. HTML 폼 준비

파일 업로드를 위해서는 다음과 같은 필수 조건이 있습니다:

• form 태그에 enctype="multipart/form-data" 지정

• method="post" 사용

• input type="file" 포함

<form action="upload.php" method="post" enctype="multipart/form-data">
    <input type="file" name="myfile">
    <input type="submit" value="업로드">
</form>

---

2. PHP 업로드 처리 (upload.php)

업로드된 파일은 PHP에서 $_FILES 배열을 통해 접근할 수 있습니다.

if (isset($_FILES['myfile'])) {
    $file = $_FILES['myfile'];

    if ($file['error'] === UPLOAD_ERR_OK) {
        $tmpName = $file['tmp_name'];      // 임시 저장 위치
        $name = basename($file['name']);   // 원본 파일 이름
        $uploadDir = "uploads/";
        $uploadFile = $uploadDir . $name;

        if (move_uploaded_file($tmpName, $uploadFile)) {
            echo "파일 업로드 성공: $uploadFile";
        } else {
            echo "파일 업로드 실패";
        }
    } else {
        echo "에러 코드: " . $file['error'];
    }
}

---

3. $_FILES 배열 구조

$_FILES['myfile'] = [
    'name' => '파일명.jpg',
    'type' => 'image/jpeg',
    'tmp_name' => '/tmp/phpYzdqkD',
    'error' => 0,
    'size' => 123456
];

키	설명
name	사용자가 업로드한 파일의 원래 이름
type	MIME 타입
tmp_name	서버에 저장된 임시 파일 경로
error	업로드 상태 코드
size	바이트 단위 파일 크기

---

4. 업로드 오류 코드 ($_FILES['myfile']['error'])

코드	설명
0	정상 업로드
1	php.ini의 upload_max_filesize 초과
2	HTML 폼에서 설정된 MAX_FILE_SIZE 초과
3	파일이 일부만 업로드됨
4	파일이 업로드되지 않음
6	임시 폴더 없음
7	디스크에 쓰기 실패
8	확장에 의해 업로드 중단

---

5. 업로드 파일 제한 설정 (php.ini)

file_uploads = On
upload_max_filesize = 5M
post_max_size = 8M
max_file_uploads = 10

• 업로드 최대 용량은 post_max_size보다 upload_max_filesize가 작아야 합니다.

---

6. 파일 유효성 검사 예

$allowedTypes = ['image/jpeg', 'image/png', 'application/pdf'];
$maxSize = 2 * 1024 * 1024; // 2MB

if (!in_array($file['type'], $allowedTypes)) {
    echo "허용되지 않은 파일 형식";
} elseif ($file['size'] > $maxSize) {
    echo "파일 크기가 너무 큽니다";
} else {
    move_uploaded_file($file['tmp_name'], "uploads/" . basename($file['name']));
}

---

7. 보안 고려 사항

• 파일 이름 검증: basename()이나 고유한 이름 사용 (uniqid() 등)

• 확장자 검사: MIME 타입과 파일 확장자 모두 확인

• 디렉토리 경로 고정: 사용자가 경로를 조작할 수 없도록 하드코딩

• 임시 파일은 반드시 move_uploaded_file() 사용: 임의 이동 방지

• 실행 가능한 파일 제한: .php, .exe, .sh 등의 업로드 방지

---

8. 업로드 파일명 변경 예

$ext = pathinfo($file['name'], PATHINFO_EXTENSION);
$newName = uniqid('upload_', true) . '.' . $ext;
move_uploaded_file($file['tmp_name'], "uploads/" . $newName);

---

9. 여러 파일 업로드

HTML:

<input type="file" name="myfiles[]" multiple>

PHP:

foreach ($_FILES['myfiles']['name'] as $i => $name) {
    $tmp = $_FILES['myfiles']['tmp_name'][$i];
    move_uploaded_file($tmp, "uploads/" . basename($name));
}

---

10. 디렉토리 존재 확인 및 생성

$dir = "uploads/";
if (!is_dir($dir)) {
    mkdir($dir, 0755, true);
}

---

요약

작업	관련 함수/항목
HTML 폼 구성	<form enctype="multipart/form-data">
파일 정보 확인	$_FILES 배열
파일 이동	move_uploaded_file()
파일 검증	type, size, extension 검사
에러 처리	$_FILES['error'] 코드 확인
보안 조치	확장자 제한, 고유 파일명 사용 등