NAME

Net::UploadMirror - Perl extension for mirroring a local directory via FTP to the remote location

SYNOPSIS

 use Net::UploadMirror;
 my $um = Net::UploadMirror->new(
	ftpserver		=> "my_ftp.hostname.com",
	usr		=> "my_ftp_usr_name",
	pass		=> "my_ftp_password",
	);
$um->Upload();

or more detailed
my $md = Net::UploadMirror->new(
	ftpserver		=> "my_ftp.hostname.com",
	usr		=> "my_ftp_usr_name",
	pass		=> "my_ftp_password",
	localdir		=> "home/nameA/homepageA",
	remotedir	=> "public",
	debug		=> 1 # 1 for yes, 0 for no
	timeout		=> 60 # default 30
	delete		=> "enable" # default "disabled"
	connection	=> $ftp_object, # default undef
# "exclusions" default empty arrayreferences [ ]
	exclusions	=> ["private.txt", "Thumbs.db", ".sys", ".log"],
# "subset" default empty arrayreferences [ ]
	subset		=> [".txt, ".pl", ".html", "htm", ".gif", ".jpg", ".css", ".js", ".png"]
# or substrings in pathnames
#	exclusions	=> ["psw", "forbidden_code"]
#	subset		=> ["name", "my_files"]
# or you can use regular expressions
# 	exclusinos	=> [qr/SYSTEM/i, $regex]
# 	subset		=> {qr/(?i:HOME)(?i:PAGE)?/, $regex]
	filename	=> "modified_times"
	);
$um->Upload();

DESCRIPTION

This module is for mirroring a local directory to a remote location via FTP. For example websites, documentations or developmentstuff which ones were worked on locally. Remote files on the ftp-server will be overwritten, also in case they are newer. It is not developt for mirroring large archivs. But there are not in principle any limits.

Constructor and Initialization =item (object)new(options) Net::UploadMirror is a derived class from Net::MirrorDir. For detailed information about constructor or options read the documentation of Net::MirrorDir.

methods

(1)_Init(%arg) This function is called by the constructor. You do not need to call this function by yourself.

(1|0)Upload(void) Call this function for mirroring automatically, recommended!!!

(ref_hash_modified_files)CheckIfModified(ref_list_local_files) Takes a hashreference of local filenames to compare the last modification time, which is stored in a file, named by the attribute "filename", while uploading. Returns a reference of a list.

(1|0)StoreFiles(ref_array_paths) Takes a arrayreference of local-paths to upload the files via FTP.

(1|0)MakeDirs(ref_array_paths) Takes a arrayreference of directories to make in the remote location.

(1|0)DeleteFiles(ref_array_paths) Takes a arrayreference of files to delete in the remote location.

(1|0)RemoveDirs(ref_array_paths) Takes a arrayreference of directories to remove in the remote location.

optional optiones

filename The name of the file in which the last modified times will be stored. default = "lastmodified_local"

delete When directories or files are to be deleted = "enable" default = "disabled"

EXPORT

None by default.

SEE ALSO

Net::MirrorDir Net::DownloadMirror Tk::Mirror http://www.planet-interkom.de/t.knorr/index.html

FILES

Net::MirrorDir Storable

BUGS

Maybe you'll find some. Let me know.

REPORTING BUGS

When reporting bugs/problems please include as much information as possible.

AUTHOR

Torsten Knorr, E<lt>create-soft@tiscali.deE<gt>

COPYRIGHT AND LICENSE

Copyright (C) 2005 - 2008 by Torsten Knorr

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself, either Perl version 5.9.2 or, at your option, any later version of Perl 5 you may have available.