코딩스쿨

PHP FTP

PHP FTP 참조: FTP 기능과 활용

*PHP FTP(Files Transfer Protocol)**는 웹 애플리케이션에서 원격 서버와 파일을 주고받을 수 있는 기능을 제공합니다. PHP는 내장된 FTP 함수를 통해 FTP 서버에 연결하고, 파일을 업로드 및 다운로드하며, 디렉토리를 관리하는 등의 다양한 작업을 수행할 수 있습니다. 이 가이드는 PHP의 FTP 기능에 대한 종합적인 참조를 제공하며, 주요 함수, 사용법, 보안 고려사항, 실용적인 예제 등을 상세히 설명합니다.

1. PHP FTP의 기본 이해

1.1 FTP란?

FTP(Files Transfer Protocol)는 네트워크를 통해 파일을 전송하기 위한 표준 프로토콜입니다. FTP를 사용하면 클라이언트와 서버 간에 파일을 업로드, 다운로드, 삭제, 이름 변경 등의 작업을 수행할 수 있습니다.

1.2 PHP에서의 FTP 활용

PHP는 FTP 서버와의 상호작용을 위해 다양한 내장 함수를 제공합니다. 이를 통해 웹 애플리케이션에서 자동화된 파일 전송 작업을 구현할 수 있습니다.

2. PHP FTP 함수

PHP는 FTP 작업을 수행하기 위한 다양한 함수를 제공합니다. 주요 FTP 함수과 그 사용법을 아래에 정리했습니다.

2.1 FTP 서버에 연결: `ftp_connect()`

ftp_connect() 함수는 지정된 호스트에 FTP 연결을 설정합니다. 기본 포트는 21번입니다.

사용 예시: FTP 서버에 연결하기

<?php
$ftp_server = "ftp.example.com";
$ftp_port = 21;

// FTP 서버에 연결
$conn_id = ftp_connect($ftp_server, $ftp_port);

if ($conn_id) {
    echo "FTP 서버에 성공적으로 연결되었습니다.<br>";
} else {
    echo "FTP 서버에 연결할 수 없습니다.<br>";
}
?>

설명:

ftp_connect()는 FTP 서버의 호스트명과 포트를 인수로 받습니다.
연결이 성공하면 FTP 스트림 리소스를 반환하고, 실패 시 false를 반환합니다.

2.2 FTP 서버에 로그인: `ftp_login()`

ftp_login() 함수는 FTP 서버에 로그인합니다. 사용자 이름과 비밀번호가 필요합니다.

사용 예시: FTP 서버에 로그인하기

<?php
$ftp_user = "username";
$ftp_pass = "password";

// FTP 서버에 로그인
if (ftp_login($conn_id, $ftp_user, $ftp_pass)) {
    echo "FTP 서버에 로그인했습니다.<br>";
} else {
    echo "FTP 서버에 로그인하지 못했습니다.<br>";
}
?>

설명:

ftp_login()은 FTP 스트림 리소스, 사용자 이름, 비밀번호를 인수로 받습니다.
로그인에 성공하면 true, 실패 시 false를 반환합니다.

2.3 FTP 연결 종료: `ftp_close()`

ftp_close() 함수는 FTP 연결을 종료합니다.

사용 예시: FTP 연결 종료하기

<?php
// FTP 연결 종료
ftp_close($conn_id);
echo "FTP 연결이 종료되었습니다.";
?>

설명:

ftp_close()는 FTP 스트림 리소스를 인수로 받으며, 연결을 종료합니다.

2.4 파일 업로드: `ftp_put()`, `ftp_fput()`

ftp_put() 함수는 로컬 파일을 원격 FTP 서버에 업로드합니다. ftp_fput()은 파일 핸들을 사용하여 업로드합니다.

사용 예시: 파일 업로드하기

<?php
$local_file = "local/path/to/file.txt";
$remote_file = "remote/path/to/file.txt";

// 파일 업로드
if (ftp_put($conn_id, $remote_file, $local_file, FTP_ASCII)) {
    echo "파일이 성공적으로 업로드되었습니다.<br>";
} else {
    echo "파일 업로드에 실패했습니다.<br>";
}
?>

설명:

ftp_put()은 FTP 스트림, 원격 파일 경로, 로컬 파일 경로, 전송 모드를 인수로 받습니다.
전송 모드는 FTP_ASCII(텍스트 파일) 또는 FTP_BINARY(바이너리 파일) 중 선택할 수 있습니다.

2.5 파일 다운로드: `ftp_get()`, `ftp_fget()`

ftp_get() 함수는 원격 FTP 서버의 파일을 로컬로 다운로드합니다. ftp_fget()은 파일 핸들을 사용하여 다운로드합니다.

사용 예시: 파일 다운로드하기

<?php
$remote_file = "remote/path/to/file.txt";
$local_file = "local/path/to/file.txt";

// 파일 다운로드
if (ftp_get($conn_id, $local_file, $remote_file, FTP_ASCII)) {
    echo "파일이 성공적으로 다운로드되었습니다.<br>";
} else {
    echo "파일 다운로드에 실패했습니다.<br>";
}
?>

설명:

ftp_get()은 FTP 스트림, 로컬 파일 경로, 원격 파일 경로, 전송 모드를 인수로 받습니다.
전송 모드는 FTP_ASCII 또는 FTP_BINARY 중 선택할 수 있습니다.

2.6 파일 목록 가져오기: `ftp_nlist()`, `ftp_rawlist()`

ftp_nlist() 함수는 지정된 디렉토리의 파일 목록을 간단한 배열로 반환합니다. ftp_rawlist()는 자세한 파일 정보를 포함한 배열을 반환합니다.

사용 예시: 파일 목록 가져오기

<?php
$directory = "/remote/directory/";

// 파일 목록 가져오기
$file_list = ftp_nlist($conn_id, $directory);

if ($file_list !== false) {
    echo "디렉토리 파일 목록:<br>";
    foreach ($file_list as $file) {
        echo $file . "<br>";
    }
} else {
    echo "파일 목록을 가져오는 데 실패했습니다.<br>";
}
?>

설명:

ftp_nlist()은 FTP 스트림과 디렉토리 경로를 인수로 받습니다.
파일 목록을 배열로 반환하며, 실패 시 false를 반환합니다.

2.7 디렉토리 생성: `ftp_mkdir()`

ftp_mkdir() 함수는 원격 FTP 서버에 새로운 디렉토리를 생성합니다.

사용 예시: 디렉토리 생성하기

<?php
$new_dir = "/remote/directory/new_folder";

// 디렉토리 생성
if (ftp_mkdir($conn_id, $new_dir)) {
    echo "디렉토리가 성공적으로 생성되었습니다.<br>";
} else {
    echo "디렉토리 생성에 실패했습니다.<br>";
}
?>

설명:

ftp_mkdir()은 FTP 스트림과 생성할 디렉토리 경로를 인수로 받습니다.
성공 시 디렉토리 이름을, 실패 시 false를 반환합니다.

2.8 디렉토리 변경: `ftp_chdir()`

ftp_chdir() 함수는 현재 작업 디렉토리를 변경합니다.

사용 예시: 디렉토리 변경하기

<?php
$target_dir = "/remote/directory/";

// 디렉토리 변경
if (ftp_chdir($conn_id, $target_dir)) {
    echo "디렉토리가 성공적으로 변경되었습니다.<br>";
} else {
    echo "디렉토리 변경에 실패했습니다.<br>";
}
?>

설명:

ftp_chdir()은 FTP 스트림과 변경할 디렉토리 경로를 인수로 받습니다.
성공 시 true, 실패 시 false를 반환합니다.

2.9 파일 삭제: `ftp_delete()`

ftp_delete() 함수는 원격 FTP 서버에서 파일을 삭제합니다.

사용 예시: 파일 삭제하기

<?php
$file_to_delete = "/remote/directory/file.txt";

// 파일 삭제
if (ftp_delete($conn_id, $file_to_delete)) {
    echo "파일이 성공적으로 삭제되었습니다.<br>";
} else {
    echo "파일 삭제에 실패했습니다.<br>";
}
?>

설명:

ftp_delete()는 FTP 스트림과 삭제할 파일 경로를 인수로 받습니다.
성공 시 true, 실패 시 false를 반환합니다.

2.10 파일 복사 및 이동: `ftp_copy()`, `ftp_rename()`

PHP에는 직접적인 ftp_copy() 함수는 없으나, 파일을 복사하려면 ftp_get()과 ftp_put()을 조합할 수 있습니다. ftp_rename() 함수는 파일의 이름을 변경하거나 이동할 때 사용됩니다.

사용 예시: 파일 복사하기

<?php
$source = "/remote/directory/source.txt";
$destination = "/remote/directory/copy_of_source.txt";

// 파일 복사 (다운로드 후 업로드)
$temp_local = tempnam(sys_get_temp_dir(), 'FTP');

if (ftp_get($conn_id, $temp_local, $source, FTP_BINARY)) {
    if (ftp_put($conn_id, $destination, $temp_local, FTP_BINARY)) {
        echo "파일이 성공적으로 복사되었습니다.<br>";
    } else {
        echo "파일 복사에 실패했습니다.<br>";
    }
    unlink($temp_local);
} else {
    echo "파일 복사에 실패했습니다.<br>";
}
?>

설명:

ftp_get()을 사용하여 원본 파일을 로컬 임시 파일로 다운로드합니다.
ftp_put()을 사용하여 임시 파일을 원격 서버에 복사본으로 업로드합니다.
작업이 끝난 후 임시 파일을 삭제합니다.

사용 예시: 파일 이동 또는 이름 변경하기

<?php
$old_name = "/remote/directory/old_name.txt";
$new_name = "/remote/directory/new_name.txt";

// 파일 이름 변경 또는 이동
if (ftp_rename($conn_id, $old_name, $new_name)) {
    echo "파일이 성공적으로 이동 또는 이름이 변경되었습니다.<br>";
} else {
    echo "파일 이동 또는 이름 변경에 실패했습니다.<br>";
}
?>

설명:

ftp_rename()은 FTP 스트림, 기존 파일 경로, 새 파일 경로를 인수로 받습니다.
파일의 이름을 변경하거나 다른 디렉토리로 이동할 수 있습니다.

3. PHP FTP SSL/TLS 연결: `ftp_ssl_connect()`

FTP는 기본적으로 암호화되지 않은 프로토콜이므로, 민감한 데이터를 전송할 때는 보안 연결이 필요합니다. ftp_ssl_connect() 함수를 사용하면 FTPS(FTP Secure) 연결을 설정할 수 있습니다.

사용 예시: SSL을 사용하는 FTP 연결

<?php
$ftp_server = "ftp.example.com";
$ftp_port = 990; // 일반적으로 FTPS는 990 포트를 사용

// SSL을 사용하는 FTP 서버에 연결
$conn_id = ftp_ssl_connect($ftp_server, $ftp_port);

if ($conn_id) {
    echo "SSL을 사용하는 FTP 서버에 성공적으로 연결되었습니다.<br>";
} else {
    echo "SSL을 사용하는 FTP 서버에 연결할 수 없습니다.<br>";
}
?>

설명:

ftp_ssl_connect()는 SSL을 사용하는 FTP 서버에 연결합니다.
FTPS는 데이터를 암호화하여 전송하므로, 보안이 강화됩니다.
서버가 FTPS를 지원해야 하며, 올바른 포트를 사용해야 합니다.

4. PHP FTP 오류 처리

FTP 작업 중 발생할 수 있는 오류를 효과적으로 처리하여 애플리케이션의 안정성을 높이는 것이 중요합니다. PHP는 FTP 함수의 반환 값을 통해 오류를 감지할 수 있으며, 예외 처리를 통해 더 세밀한 오류 관리를 할 수 있습니다.

예시: FTP 오류 처리하기

<?php
$ftp_server = "ftp.example.com";
$ftp_user = "username";
$ftp_pass = "password";

// FTP 서버에 연결
$conn_id = ftp_connect($ftp_server);

if (!$conn_id) {
    die("FTP 서버에 연결할 수 없습니다.");
}

// FTP 서버에 로그인
if (!ftp_login($conn_id, $ftp_user, $ftp_pass)) {
    ftp_close($conn_id);
    die("FTP 서버에 로그인할 수 없습니다.");
}

// 패시브 모드 설정
ftp_pasv($conn_id, true);

// 파일 업로드
$local_file = "local/path/to/file.txt";
$remote_file = "remote/path/to/file.txt";

if (ftp_put($conn_id, $remote_file, $local_file, FTP_BINARY)) {
    echo "파일이 성공적으로 업로드되었습니다.<br>";
} else {
    echo "파일 업로드에 실패했습니다.<br>";
}

// FTP 연결 종료
ftp_close($conn_id);
?>

설명:

각 FTP 함수의 반환 값을 확인하여 오류를 감지합니다.
오류 발생 시 적절한 조치를 취하고, 필요 시 스크립트를 종료합니다.
die() 함수를 사용하여 오류 메시지를 출력하고 스크립트를 종료할 수 있습니다.

5. PHP FTP 보안 고려사항

FTP는 기본적으로 암호화되지 않은 프로토콜이므로, 보안에 취약할 수 있습니다. PHP에서 FTP를 사용할 때는 다음과 같은 보안 고려사항을 준수하는 것이 중요합니다.

5.1 SSL/TLS 사용

FTPS를 사용하여 데이터 전송을 암호화함으로써 보안을 강화할 수 있습니다. ftp_ssl_connect() 함수를 사용하여 SSL 연결을 설정합니다.

5.2 패시브 모드 설정

패시브 모드는 방화벽을 우회하여 FTP 연결을 설정할 때 유용합니다. ftp_pasv() 함수를 사용하여 패시브 모드를 활성화할 수 있습니다.

예시: 패시브 모드 활성화

<?php
ftp_pasv($conn_id, true); // 패시브 모드 활성화
?>

5.3 사용자 입력 검증

FTP 경로 및 파일명을 사용자 입력으로 받을 경우, 디렉토리 트래버설 공격을 방지하기 위해 입력을 철저히 검증해야 합니다.

예시: 경로 정규화 및 검증

<?php
function sanitizePath($baseDir, $userInputPath) {
    // 기본 디렉토리의 절대 경로 가져오기
    $realBase = realpath($baseDir);
    // 사용자 입력 경로를 기본 디렉토리와 결합 후 절대 경로로 변환
    $realUserPath = realpath($baseDir . DIRECTORY_SEPARATOR . $userInputPath);

    // 경로가 기본 디렉토리 내부에 있는지 확인
    if ($realUserPath && strpos($realUserPath, $realBase) === 0) {
        return $realUserPath;
    } else {
        return false;
    }
}

$baseDir = "/var/www/html/uploads";
$userInput = $_GET['file']; // 예: ../../etc/passwd

$sanitizedPath = sanitizePath($baseDir, $userInput);

if ($sanitizedPath) {
    // 안전하게 파일에 접근
    if (file_exists($sanitizedPath)) {
        echo "파일을 찾았습니다: " . htmlspecialchars($sanitizedPath);
    } else {
        echo "파일이 존재하지 않습니다.";
    }
} else {
    echo "유효하지 않은 파일 경로입니다.";
}
?>

설명:

realpath() 함수를 사용하여 실제 절대 경로를 얻고, 기본 디렉토리 내에 있는지 확인합니다.
이를 통해 ../../ 같은 상대 경로를 통한 디렉토리 트래버설 공격을 방지할 수 있습니다.

5.4 최소 권한 원칙 준수

FTP 서버의 사용자 계정에는 필요한 최소한의 권한만 부여하여 불필요한 접근을 제한해야 합니다. 예를 들어, 파일 업로드 및 다운로드만 필요한 경우, 디렉토리 생성이나 삭제 권한은 제한할 수 있습니다.

6. PHP FTP Best Practices

효과적이고 안전한 FTP 관리를 위해 다음과 같은 최선의 실천 방법을 따르는 것이 좋습니다.

6.1 연결 관리

FTP 연결은 필요한 작업이 끝난 후 즉시 종료하여 리소스를 효율적으로 관리합니다.

예시: 연결 종료

<?php
// FTP 작업 수행

// 작업 완료 후 연결 종료
ftp_close($conn_id);
?>

6.2 에러 핸들링

모든 FTP 함수의 반환 값을 확인하여 오류를 적절히 처리합니다. 예외 처리를 도입하여 더 세밀한 오류 관리를 구현할 수도 있습니다.

6.3 패시브 모드 사용

패시브 모드를 활성화하여 방화벽이나 NAT 환경에서의 연결 문제를 해결할 수 있습니다.

예시: 패시브 모드 활성화

<?php
ftp_pasv($conn_id, true);
?>

6.4 보안 강화

FTPS를 사용하고, 사용자 입력을 철저히 검증하며, 최소 권한 원칙을 준수하여 보안을 강화합니다.

6.5 로그 기록

FTP 작업을 로그에 기록하여 문제 발생 시 신속하게 원인을 파악할 수 있도록 합니다.

예시: 로그 기록

<?php
if (!ftp_put($conn_id, $remote_file, $local_file, FTP_BINARY)) {
    error_log("파일 업로드 실패: $local_file -> $remote_file");
}
?>

7. 실용적인 예제

7.1 파일 업로드 예제

사용자가 웹 폼을 통해 파일을 업로드하면, PHP 스크립트가 FTP 서버에 파일을 전송하는 예제입니다.

HTML 폼: 파일 업로드

<!DOCTYPE html>
<html>
<head>
    <title>FTP 파일 업로드</title>
</head>
<body>
    <h2>파일 업로드</h2>
    <form action="ftp_upload.php" method="post" enctype="multipart/form-data">
        업로드할 파일 선택:
        <input type="file" name="uploadedFile"><br><br>
        <input type="submit" value="업로드">
    </form>
</body>
</html>

PHP 스크립트: ftp_upload.php

<?php
$ftp_server = "ftp.example.com";
$ftp_user = "username";
$ftp_pass = "password";
$remote_dir = "/uploads/";

// FTP 서버에 연결
$conn_id = ftp_connect($ftp_server);

if (!$conn_id) {
    die("FTP 서버에 연결할 수 없습니다.");
}

// FTP 서버에 로그인
if (!ftp_login($conn_id, $ftp_user, $ftp_pass)) {
    ftp_close($conn_id);
    die("FTP 서버에 로그인할 수 없습니다.");
}

// 패시브 모드 설정
ftp_pasv($conn_id, true);

// 업로드할 파일 확인
if (isset($_FILES['uploadedFile']) && $_FILES['uploadedFile']['error'] == UPLOAD_ERR_OK) {
    $local_file = $_FILES['uploadedFile']['tmp_name'];
    $remote_file = $remote_dir . basename($_FILES['uploadedFile']['name']);

    // 파일 업로드
    if (ftp_put($conn_id, $remote_file, $local_file, FTP_BINARY)) {
        echo "파일이 성공적으로 업로드되었습니다.<br>";
    } else {
        echo "파일 업로드에 실패했습니다.<br>";
    }
} else {
    echo "파일 업로드 중 오류가 발생했습니다.<br>";
}

// FTP 연결 종료
ftp_close($conn_id);
?>

설명:

사용자가 업로드한 파일을 FTP 서버의 지정된 디렉토리에 전송합니다.
패시브 모드를 활성화하여 연결 문제를 방지합니다.
업로드 성공 여부에 따라 적절한 메시지를 표시합니다.

7.2 파일 다운로드 예제

사용자가 FTP 서버에서 파일을 다운로드할 수 있도록 하는 예제입니다.

PHP 스크립트: ftp_download.php

<?php
$ftp_server = "ftp.example.com";
$ftp_user = "username";
$ftp_pass = "password";
$remote_file = "/uploads/file.txt";
$local_file = "downloads/file.txt";

// FTP 서버에 연결
$conn_id = ftp_connect($ftp_server);

if (!$conn_id) {
    die("FTP 서버에 연결할 수 없습니다.");
}

// FTP 서버에 로그인
if (!ftp_login($conn_id, $ftp_user, $ftp_pass)) {
    ftp_close($conn_id);
    die("FTP 서버에 로그인할 수 없습니다.");
}

// 패시브 모드 설정
ftp_pasv($conn_id, true);

// 파일 다운로드
if (ftp_get($conn_id, $local_file, $remote_file, FTP_BINARY)) {
    echo "파일이 성공적으로 다운로드되었습니다.<br>";
} else {
    echo "파일 다운로드에 실패했습니다.<br>";
}

// FTP 연결 종료
ftp_close($conn_id);
?>

설명:

FTP 서버의 원격 파일을 로컬 디렉토리에 다운로드합니다.
패시브 모드를 활성화하여 연결 문제를 방지합니다.
다운로드 성공 여부에 따라 적절한 메시지를 표시합니다.

7.3 디렉토리 목록 출력 예제

FTP 서버의 특정 디렉토리에 있는 파일과 폴더 목록을 출력하는 예제입니다.

PHP 스크립트: ftp_list.php

<?php
$ftp_server = "ftp.example.com";
$ftp_user = "username";
$ftp_pass = "password";
$directory = "/uploads/";

// FTP 서버에 연결
$conn_id = ftp_connect($ftp_server);

if (!$conn_id) {
    die("FTP 서버에 연결할 수 없습니다.");
}

// FTP 서버에 로그인
if (!ftp_login($conn_id, $ftp_user, $ftp_pass)) {
    ftp_close($conn_id);
    die("FTP 서버에 로그인할 수 없습니다.");
}

// 패시브 모드 설정
ftp_pasv($conn_id, true);

// 파일 목록 가져오기
$file_list = ftp_nlist($conn_id, $directory);

if ($file_list !== false) {
    echo "디렉토리 파일 목록:<br><ul>";
    foreach ($file_list as $file) {
        echo "<li>" . htmlspecialchars($file) . "</li>";
    }
    echo "</ul>";
} else {
    echo "파일 목록을 가져오는 데 실패했습니다.<br>";
}

// FTP 연결 종료
ftp_close($conn_id);
?>

설명:

지정된 디렉토리의 파일 목록을 가져와 웹 페이지에 출력합니다.
ftp_nlist() 함수를 사용하여 파일 목록을 배열로 가져옵니다.

8. PHP FTP 고급 기능

8.1 재귀적으로 디렉토리 탐색

PHP의 SPL(Standard PHP Library)을 사용하여 FTP 서버의 디렉토리를 재귀적으로 탐색할 수 있습니다. 이를 통해 모든 서브디렉토리의 파일을 관리할 수 있습니다.

사용 예시: 재귀 디렉토리 탐색

<?php
class RecursiveFTPIterator implements RecursiveIterator {
    private $files;
    private $position = 0;

    public function __construct($files) {
        $this->files = $files;
    }

    public function hasChildren() {
        // 디렉토리인지 확인 (간단한 예시)
        return is_dir($this->files[$this->position]);
    }

    public function getChildren() {
        // 재귀적으로 자식 FTPIterator 반환
        global $conn_id;
        $children = ftp_nlist($conn_id, $this->files[$this->position]);
        return new RecursiveFTPIterator($children);
    }

    public function current() {
        return $this->files[$this->position];
    }

    public function key() {
        return $this->position;
    }

    public function next() {
        $this->position++;
    }

    public function rewind() {
        $this->position = 0;
    }
}

// FTP 서버에 연결 및 로그인 (생략)

// 패시브 모드 설정
ftp_pasv($conn_id, true);

// 루트 디렉토리 파일 목록 가져오기
$root_files = ftp_nlist($conn_id, "/uploads/");

// 재귀 FTP Iterator 생성
$iterator = new RecursiveIteratorIterator(
    new RecursiveFTPIterator($root_files),
    RecursiveIteratorIterator::SELF_FIRST
);

// 파일 및 디렉토리 출력
foreach ($iterator as $file) {
    echo str_repeat("-", $iterator->getDepth()) . " " . htmlspecialchars($file) . "<br>";
}

// FTP 연결 종료 (생략)
?>

설명:

RecursiveIterator 인터페이스를 구현하여 FTP 서버의 디렉토리를 재귀적으로 탐색합니다.
각 디렉토리의 파일과 서브디렉토리를 탐색하여 계층적으로 출력합니다.

8.2 FTP 업로드 자동화 스크립트

주기적으로 로컬 디렉토리의 파일을 FTP 서버에 자동으로 업로드하는 스크립트 예제입니다.

PHP 스크립트: ftp_auto_upload.php

<?php
$ftp_server = "ftp.example.com";
$ftp_user = "username";
$ftp_pass = "password";
$local_dir = "/local/uploads/";
$remote_dir = "/remote/uploads/";

// FTP 서버에 연결
$conn_id = ftp_connect($ftp_server);

if (!$conn_id) {
    die("FTP 서버에 연결할 수 없습니다.");
}

// FTP 서버에 로그인
if (!ftp_login($conn_id, $ftp_user, $ftp_pass)) {
    ftp_close($conn_id);
    die("FTP 서버에 로그인할 수 없습니다.");
}

// 패시브 모드 설정
ftp_pasv($conn_id, true);

// 로컬 디렉토리의 파일 목록 가져오기
$files = scandir($local_dir);

foreach ($files as $file) {
    if ($file != '.' && $file != '..') {
        $local_file = $local_dir . $file;
        $remote_file = $remote_dir . $file;

        if (ftp_put($conn_id, $remote_file, $local_file, FTP_BINARY)) {
            echo "파일 업로드 성공: $file<br>";
            // 업로드 후 로컬 파일 삭제 (옵션)
            // unlink($local_file);
        } else {
            echo "파일 업로드 실패: $file<br>";
        }
    }
}

// FTP 연결 종료
ftp_close($conn_id);
?>

설명:

로컬 디렉토리의 모든 파일을 FTP 서버의 지정된 디렉토리에 업로드합니다.
업로드 후 로컬 파일을 삭제할 수 있습니다(주석 처리된 unlink() 부분 참고).

9. PHP FTP 보안 Best Practices

9.1 FTPS 사용

FTPS(FTP Secure)를 사용하여 데이터 전송 시 암호화를 적용함으로써 보안을 강화합니다. ftp_ssl_connect() 함수를 사용하여 FTPS 연결을 설정할 수 있습니다.

사용 예시: FTPS 연결

<?php
$ftp_server = "ftp.example.com";
$ftp_port = 990; // FTPS 일반 포트

// FTPS 서버에 연결
$conn_id = ftp_ssl_connect($ftp_server, $ftp_port);

if (!$conn_id) {
    die("FTPS 서버에 연결할 수 없습니다.");
}

// FTPS 서버에 로그인
if (!ftp_login($conn_id, $ftp_user, $ftp_pass)) {
    ftp_close($conn_id);
    die("FTPS 서버에 로그인할 수 없습니다.");
}

// 패시브 모드 설정
ftp_pasv($conn_id, true);

// 이후 FTP 작업 수행

// FTP 연결 종료
ftp_close($conn_id);
?>

9.2 사용자 입력 검증

FTP 경로 및 파일명을 사용자 입력으로 받을 경우, 경로 정규화 및 검증을 통해 디렉토리 트래버설 공격을 방지합니다.

예시: 사용자 입력 경로 검증

<?php
function sanitizePath($baseDir, $userInputPath) {
    $realBase = realpath($baseDir);
    $realUserPath = realpath($baseDir . DIRECTORY_SEPARATOR . $userInputPath);

    if ($realUserPath && strpos($realUserPath, $realBase) === 0) {
        return $realUserPath;
    } else {
        return false;
    }
}

$baseDir = "/var/www/html/uploads";
$userInput = $_GET['file']; // 예: ../../etc/passwd

$sanitizedPath = sanitizePath($baseDir, $userInput);

if ($sanitizedPath) {
    if (file_exists($sanitizedPath)) {
        echo "파일을 찾았습니다: " . htmlspecialchars($sanitizedPath);
    } else {
        echo "파일이 존재하지 않습니다.";
    }
} else {
    echo "유효하지 않은 파일 경로입니다.";
}
?>

9.3 최소 권한 원칙

FTP 서버의 사용자 계정에는 필요한 최소한의 권한만 부여하여 보안을 강화합니다. 예를 들어, 파일 업로드와 다운로드만 필요한 경우, 디렉토리 생성 및 삭제 권한은 제한할 수 있습니다.

10. 참조 자료

11. 요약

PHP FTP 참조는 웹 애플리케이션에서 FTP 서버와의 상호작용을 효과적으로 관리하기 위한 필수 도구와 기능을 제공합니다. ftp_connect(), ftp_login(), ftp_put(), ftp_get() 등의 함수를 활용하여 파일 전송, 디렉토리 관리, 오류 처리 등을 손쉽게 구현할 수 있습니다. 보안을 강화하기 위해 FTPS를 사용하고, 사용자 입력을 철저히 검증하며, 최소 권한 원칙을 준수하는 것이 중요합니다.

주요 포인트 요약:

FTP 함수 이해: PHP의 다양한 FTP 함수를 숙지하고, 필요에 맞게 활용합니다.
보안 강화: FTPS 사용, 패시브 모드 설정, 사용자 입력 검증 등을 통해 보안을 강화합니다.
에러 핸들링: FTP 함수의 반환 값을 확인하여 오류를 적절히 처리합니다.
Best Practices: 연결 관리, 패시브 모드 사용, 로그 기록 등을 통해 효율적이고 안전한 FTP 관리를 구현합니다.
실용적인 예제: 파일 업로드, 다운로드, 디렉토리 목록 출력 등의 실제 예제를 통해 이해를 심화합니다.

PHP FTP 기능을 잘 활용하면, 웹 애플리케이션의 파일 관리가 더욱 효율적이고 안전하게 이루어질 수 있습니다. 다양한 예제를 통해 실습하고, 공식 문서를 참고하여 깊이 있는 이해를 쌓는 것이 중요합니다.

팁: PHP FTP 기능을 마스터하려면, 다양한 FTP 작업을 직접 구현해보고, 보안 모범 사례를 준수하는 것이 좋습니다. 이를 통해 복잡한 파일 관리 작업에서도 안전하고 효율적으로 대처할 수 있는 능력을 키울 수 있습니다.

코딩 스쿨 PHP

PHP FTP

PHP FTP 참조: FTP 기능과 활용

1. PHP FTP의 기본 이해

1.1 FTP란?

1.2 PHP에서의 FTP 활용

2. PHP FTP 함수

2.1 FTP 서버에 연결: ftp_connect()

2.2 FTP 서버에 로그인: ftp_login()

2.3 FTP 연결 종료: ftp_close()

2.4 파일 업로드: ftp_put(), ftp_fput()

2.5 파일 다운로드: ftp_get(), ftp_fget()

2.6 파일 목록 가져오기: ftp_nlist(), ftp_rawlist()

2.7 디렉토리 생성: ftp_mkdir()

2.8 디렉토리 변경: ftp_chdir()

2.9 파일 삭제: ftp_delete()

2.10 파일 복사 및 이동: ftp_copy(), ftp_rename()

3. PHP FTP SSL/TLS 연결: ftp_ssl_connect()

4. PHP FTP 오류 처리

5. PHP FTP 보안 고려사항

5.1 SSL/TLS 사용

5.2 패시브 모드 설정

5.3 사용자 입력 검증

5.4 최소 권한 원칙 준수

6. PHP FTP Best Practices

6.1 연결 관리

6.2 에러 핸들링

6.3 패시브 모드 사용

6.4 보안 강화

6.5 로그 기록

7. 실용적인 예제

7.1 파일 업로드 예제

7.2 파일 다운로드 예제

7.3 디렉토리 목록 출력 예제

8. PHP FTP 고급 기능

8.1 재귀적으로 디렉토리 탐색

8.2 FTP 업로드 자동화 스크립트

9. PHP FTP 보안 Best Practices

9.1 FTPS 사용

9.2 사용자 입력 검증

9.3 최소 권한 원칙

10. 참조 자료

11. 요약

2.1 FTP 서버에 연결: `ftp_connect()`

2.2 FTP 서버에 로그인: `ftp_login()`

2.3 FTP 연결 종료: `ftp_close()`

2.4 파일 업로드: `ftp_put()`, `ftp_fput()`

2.5 파일 다운로드: `ftp_get()`, `ftp_fget()`

2.6 파일 목록 가져오기: `ftp_nlist()`, `ftp_rawlist()`

2.7 디렉토리 생성: `ftp_mkdir()`

2.8 디렉토리 변경: `ftp_chdir()`

2.9 파일 삭제: `ftp_delete()`

2.10 파일 복사 및 이동: `ftp_copy()`, `ftp_rename()`

3. PHP FTP SSL/TLS 연결: `ftp_ssl_connect()`