리눅스 웹으로 파일 업로드

11 Sep 2023

linux

리눅스 환경에서 웹 애플리케이션을 개발하다보면 파일 업로드 기능이 필요한 경우가 많습니다. 파일 업로드는 사용자가 웹 애플리케이션을 통해 서버에 파일을 전송하는 과정을 의미합니다. 이번 포스트에서는 리눅스 환경에서 웹으로 파일을 업로드하는 방법에 대해 알아보겠습니다.

웹 서버 설정

먼저, 파일 업로드를 지원하는 웹 서버를 설정해야 합니다. 가장 일반적으로 사용되는 웹 서버인 Apache와 Nginx를 예로 들어보겠습니다.

Apache 설정

Apache 웹 서버의 설정 파일인 httpd.conf를 열어 다음과 같이 수정합니다.

LoadModule phpX_module         modules/libphpX.so
AddType application/x-httpd-php .phpX
PHPIniDir "/path/to/php.ini"

<FilesMatch ".phpX$">
    SetHandler application/x-httpd-php
</FilesMatch>

위 예제에서 X는 설치된 PHP 버전을 나타냅니다. 예를 들어 PHP 7.4 버전을 사용 중이라면 php7_module이 됩니다. PHPIniDir 설정은 해당 디렉토리에 있는 php.ini 파일을 참조하도록 설정하는 것입니다.

Nginx 설정

Nginx 웹 서버의 설정 파일인 nginx.conf를 열어 다음과 같이 수정합니다.

location ~ \.phpX$ {
    root           /path/to/webroot;
    fastcgi_pass   127.0.0.1:9000;
    fastcgi_index  index.php;
    fastcgi_param  SCRIPT_FILENAME  $document_root$fastcgi_script_name;
    include        fastcgi_params;
}

위 예제에서 X는 설치된 PHP 버전을 나타냅니다. root 설정은 웹 애플리케이션의 루트 디렉토리를 지정한 것이며, fastcgi_pass 설정은 PHP-FPM과 연동하기 위해 필요한 설정입니다. location 블록 내의 설정들은 .phpX 확장자를 가진 파일에 대해 PHP 처리를 하도록 구성한 것입니다.

파일 업로드 처리

웹 서버의 설정이 완료되었다면 이제 파일 업로드를 처리할 PHP 스크립트를 작성해야 합니다. 아래 예제는 가장 기본적인 파일 업로드 처리 방법을 보여줍니다.

<?php
if ($_SERVER['REQUEST_METHOD'] === 'POST' && isset($_FILES['file'])) {
    $uploadDir = '/path/to/uploads/';
    $uploadedFile = $uploadDir . $_FILES['file']['name'];
    
    if (move_uploaded_file($_FILES['file']['tmp_name'], $uploadedFile)) {
        echo '파일이 성공적으로 업로드되었습니다.';
    } else {
        echo '파일 업로드에 실패하였습니다.';
    }
}
?>

위 예제에서는 $_FILES 슈퍼글로벌 변수를 이용하여 업로드된 파일 정보를 받아옵니다. move_uploaded_file 함수를 사용하여 임시 저장 경로에서 파일을 실제 업로드 경로로 이동시킵니다. 이후 결과에 따라 적절한 메시지를 출력합니다.

보안 고려 사항

파일 업로드 기능은 보안에 민감한 부분이기 때문에 몇 가지 주의사항을 알아두어야 합니다.

업로드된 파일의 크기 제한을 설정해야 합니다. php.ini 파일의 upload_max_filesize 및 post_max_size 설정을 확인하고 필요하다면 수정해야 합니다.
업로드된 파일의 확장자 및 MIME 유형을 검증해야 합니다. 악의적인 사용자가 업로드한 스크립트 파일 등을 실행할 수 없도록 제한을 두어야 합니다.
파일 저장 경로를 잘 설정해야 합니다. 서버의 중요한 파일을 덮어쓰거나 노출시키지 않도록 주의해야 합니다.
업로드된 파일에 대한 접근 권한을 제한해야 합니다. 업로드된 파일은 외부로부터 직접 접근할 수 없도록 보호되어야 합니다.

이러한 보안 고려사항을 충분히 고려하여 파일 업로드 기능을 구현해야 합니다.