PHP Extension

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.

Note: This example requires Chilkat v9.5.0.76 or greater.

PHP Extension

<?php

include("chilkat.php");

$success = false;

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

$ftp = new CkFtp2();

$ftp->put_Hostname('ftp.something.com');
$ftp->put_Username('my_login');
$ftp->put_Password('my_password');

// Connect and login to the FTP server.
$success = $ftp->Connect();
if ($success != true) {
    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 != true) {
    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->put_SyncMustMatchDir('data; x*');
$mode = 0;
$success = $ftp->SyncLocalTree('c:/temp/subDir1',$mode);
if ($success != true) {
    print $ftp->lastErrorText() . "\n";
    exit;
}

$success = $ftp->Disconnect();

// Show the files downloaded.
$st = new CkStringTable();
$ftp->GetSyncedFiles($st);

$numFiles = $st->get_Count();
$i = 0;

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

?>