PHP의 ftp_raw() 함수 – FTP 서버에 원시(Raw) 명령 전송하기

개요

PHP의 ftp_raw() 함수는 FTP 서버에 원시(raw) 명령을 그대로 전송하는 데 사용됩니다. 일반적인 FTP 함수들이 내부적으로 처리해 주는 동작을 개발자가 직접 제어해야 하는 경우, 즉 USER, PASS, STAT 같은 표준 FTP 프로토콜 명령을 코드 레벨에서 직접 실행해야 할 때 유용하게 활용됩니다.

문법(Sytax)

ftp_raw(con, command)

매개변수(Parameters)

• con − ftp_connect()를 통해 생성된 FTP 연결 리소스

• command − FTP 서버에 전송하여 실행할 명령 문자열

반환 값(Return)

ftp_raw() 함수는 서버의 응답을 문자열 배열(array) 형태로 반환합니다. 배열의 각 요소는 서버가 보내온 한 줄의 응답에 해당하며, 첫 번째 요소에는 보통 "230", "331"과 같은 FTP 상태 코드가 포함되어 있어 명령 실행 결과를 확인하는 데 활용할 수 있습니다.

예제(Example)

다음은 ftp_raw() 함수를 사용해 FTP 서버에 연결한 후, 로그인 관련 명령을 직접 전송하는 예제입니다.

<?php
    $ftp_server = "192.168.0.4";
    $con = ftp_connect($ftp_server) or die("$ftp_server 에 연결할 수 없습니다.");
    
    // 원시 명령으로 로그인 처리
    ftp_raw($con, "USER david");
    ftp_raw($con, "PASS yourpassword");
    
    // 연결 종료
    ftp_close($con);
?>

참고 사항

ftp_raw()는 다른 FTP 함수들과 달리 사전에 ftp_login()을 호출하지 않아도 명령을 전송할 수 있습니다. 또한 반환되는 배열을 검사하면 인증 성공 여부나 서버 상태 등을 세밀하게 판단할 수 있으므로, 커스텀 FTP 클라이언트나 디버깅 목적의 스크립트를 작성할 때 특히 유용합니다.