Perl Requires Chilkat v9.5.0.76+

FTP Sync Download Tree w/ Must-Match Directory Constraints

See more FTP Examples

Demonstrates how synchronize a directory tree in the download direction, but only entering directories matching a set of wildcard filenames. Chilkat2 Perl

use strict;
use warnings;
use Chilkat2;

# This example requires the Chilkat API to have been previously unlocked.
# See Global Unlock Sample for sample code.

my $ftp = Chilkat2::Ftp2->new;

$ftp->Hostname('ftp.something.com');
$ftp->Username('my_login');
$ftp->Password('my_password');

# Connect and login to the FTP server.
my $success = $ftp->Connect();
if (!$success) {
    print $ftp->LastErrorText, "\n";
    exit;
}

# Set the current remote directory to the root of
# the tree to be downloaded.
$success = $ftp->ChangeRemoteDir('/subDir1');
if (!$success) {
    print $ftp->LastErrorText, "\n";
    exit;
}

# Possible synchronization modes are:
# mode=0: Download all files
# mode=1: Download all files that do not exist on the local filesystem.
# mode=2: Download newer or non-existant files.
# mode=3: Download only newer files. If a file does not already exist on the local filesystem, it is not downloaded from the server..
# mode=5: Download only missing files or files with size differences.
# mode=6: Same as mode 5, but also download newer files.

# Imagine our remote directory tree has these files and directories:

#     accentedLatin1.txt
#     accentedUtf8.txt
#     alice.key
#     anter_cert.pem
#     chiliPepper.gif
#     helloWorld.pdf
#     abc/chiliPepper.gif
#     abc/ghk/
#     data/chiliPepper.gif
#     data/xyz/dkimHtmlBody.txt
#     data/xyz/dkimVerifyTest.eml
#     data/xyz/emailForCreateDsn.eml
#     text/frenchUtf8.txt
#     text/helloWorld.txt
#     text/PolishEmailBody.txt
#     text/something/

# Only enter remote directories named either "data" or matching "x*"
$ftp->SyncMustMatchDir('data; x*');
my $mode = 0;
$success = $ftp->SyncLocalTree('c:/temp/subDir1', $mode);
if (!$success) {
    print $ftp->LastErrorText, "\n";
    exit;
}

$success = $ftp->Disconnect();

# Show the files downloaded.
my $st = Chilkat2::StringTable->new;
$ftp->GetSyncedFiles($st);

my $numFiles = $st->Count;
my $i = 0;
my $remoteFilename = '';
while ($i < $numFiles) {
    print $st->StringAt($i), "\n";
    $i = $i + 1;
}

# Output showing the files downloaded:

# accentedLatin1.txt
# accentedUtf8.txt
# alice.key
# anter_cert.pem
# chiliPepper.gif
# helloWorld.pdf
# data/chiliPepper.gif
# data/xyz/dkimHtmlBody.txt
# data/xyz/dkimVerifyTest.eml
# data/xyz/emailForCreateDsn.eml