easy-ftp

easy-ftp

• Easy control FTP or SFTP
• 간단한 설정만으로 편리하게 FTP 혹은 SFTP 의 기능을 이용할 수 있습니다.
• 이 모듈은 ftp 와 ssh2 모듈을 참조하였습니다.

Install

npm install easy-ftp

Usage

var EasyFtp = require('easy-ftp');
var ftp = new EasyFTP();
var config = {
    host: '',
    port: 21,
    username: '',
    password: ''
};

//서버 접속(connect)
ftp.connect(config);		

//폴더 변경(directory change)
ftp.cd("/", function(err, path){});	

//파일 or 폴더 삭제(하위 파일 및 폴더 포함)(file or directory remove(recursive))
ftp.rm("/filename", function(err){});	

//폴더 생성(하위 폴더 포함 생성)(make directory)
ftp.mkdir("/directory", function(err){});	

//파일 or 폴더 이동 혹은 이름 변경(file or directory move or change filename)
ftp.mv("/filename", "/newFilename", function(err, newPath){});	

//폴더 내 파일목록 반환(show files in directory)
ftp.ls("/directory", function(err, list){});	

//ftp 서버상의 현재 작업 경로 반환(return server path)
ftp.pwd(function(err, path){});	

//파일 or 폴더 업로드(file or directory upload)
ftp.upload("C:/test.txt", "/test.txt", function(err){});	

//파일 or 폴더 다운로드(file or directory download)
ftp.download("/test.txt", "C:/", function(err){});	

//접속 종료(disconnect)
ftp.close();	

API

Methods

• connect(< object >config)

  • host - string - server domain or ip Default: 'localhost'
  • port - number - port (default : 21)
  • type - string - ftp type. 'ftp' or 'sftp' (default : 'ftp')
  • username - string - username for authentication Default: 'anonymous',
  • password - string - password for authentication. Default: 'anonymous@'
  • privateKey - mixed - sftp only. Buffer or string that contains a private key for either key-based or hostbased user authentication (OpenSSH format) Default: none

• cd(< string >path, < function >callback) - Changes the working directory. callback has 1 parameter: < Error >err.

• rm(< string >path, < function >callback) - Deletes a file or directory(include child files) path on the server. callback has 1 parameter: < Error >err.

• mkdir(< string >path, < function >callback) - Creates a new directory recursive. callback has 1 parameter: < Error >err.

• mv(< string >oldPath, < string >newPath, < function >callback) - Renames or Move oldPath to newPath on the server. callback has 2 parameter: < Error >err, < String >newPath.

• ls(< string >path, < function >callback) - Retrieves the directory listing of path. callback has 2 parameter: < Error >err, < Array >list.

  • name - string - file name
  • size - number - file size
  • type - string - file type. 'd' => directory, 'f' => file
  • date - date - file last modified date

• pwd(< function >callback) - Retrieves the current working directory. callback has 2 parameters: < Error >err, < string >cwd.

• upload(< string >localPath, < string >remotePath, < function >callback) - Sends data to the server to be stored as remotePath. If direcotry path, include self directory and child files. If you want only child files, localPath is "/directory/**". callback has 1 parameter: < Error >err.

  • file - ex) upload("/test.txt", "/a/b/test.txt", ...) => result : /a/b/test.txt
  • directory - ex) upload("/directory", "/a/b", ...) => result : /a/b/directory
  • only child files - ex) upload("/directory/**", "/a/b", ...) => result : /a/b/child files...

• download(< string >remotePath, < function >callback) - Retrieves a file or directory at path from the server. If directory path, include child files. callback has 1 parameter: < Error >err.

• close() - Closes the connection to the server after any/all enqueued commands have been executed.

Event

• open(< FTPClient >client) - Emitted when connection and authentication were sucessful.

• close - Emitted when the connection has fully closed.

• error(< Error >err) - Emitted when the connection has fully closed.

• upload(< string >uploadedRemotePath) - Emitted when file or directory uploaded.

• download(< string >downloadedLocalPath) - Emitted when file or directory downloaded.

Examples

//Connect
var ftp = new EasyFTP();
var config = {
    host: 'localhost',
    port: 21,
    username: 'id',
    password: 'password'
};
ftp.connect(config);




/* 
Ex) Directory structure
/test/test.txt
/test/child1
/test/child1/image.png
/test/child1/child2
/test/child1/child2/shell.sh
*/

//Case1. files Upload
var ftp = new EasyFTP();
ftp.connect({...});
ftp.upload("/test/test.txt", "/test.txt", function(err){
	ftp.close();
});
/* result
/test.txt
*/



//Case2. child files Upload
var ftp = new EasyFTP();
ftp.connect({...});
// '/test/**' or '/test/*'
ftp.upload("/test/**", "/", function(err){
	ftp.close();
});
/* result
/test.txt
/child1
/child1/image.png
/child1/child2
/child1/child2/shell.sh
*/



//Case3. directory Upload
var ftp = new EasyFTP();
ftp.connect({...});
ftp.upload("/test", "/", function(err){
	ftp.close();	
});
/* result
/test/test.txt
/test/child1
/test/child1/image.png
/test/child1/child2
/test/child1/child2/shell.sh
*/



//Case4. file download
var ftp = new EasyFTP();
ftp.connect({...});
ftp.download("/test/test.txt", "/", function(err){
	ftp.close();	
});
/* result
/test.txt
*/



//Case5. direcotry download
var ftp = new EasyFTP();
ftp.connect({...});
ftp.download("/test", "/", function(err){
	ftp.close();	
});
/* result
/test/test.txt
/test/child1
/test/child1/image.png
/test/child1/child2
/test/child1/child2/shell.sh
*/