Delphi DLL

Sync a Single FTP Directory Down to Local

Demonstrates the Chilkat Ftp2.SyncLocalDir method, which synchronizes files from the current remote directory into a local directory without descending into subdirectories. The first argument is the local root and the second is the download mode.

Note: The local paths are relative to the application's current working directory. Absolute paths may also be used. Supply the paths appropriate to your own environment.

Background: This is the single-directory form of SyncLocalTree, using the same mode numbers but touching only the top level. It is the right choice when subdirectories are irrelevant or handled separately — for instance pulling new files from one drop folder without recursing into archive subfolders that would waste time to scan.

Chilkat Delphi DLL Downloads

Download Chilkat for Delphi DLL

Delphi DLL

var
success: Boolean;
ftp: HCkFtp2;
mode: Integer;

begin
success := False;

//  Demonstrates the Ftp2.SyncLocalDir method, which synchronizes files from the current remote
//  directory into a local directory WITHOUT descending into subdirectories.  The 1st argument is
//  the local root and the 2nd is the download mode.

ftp := CkFtp2_Create();

CkFtp2_putHostname(ftp,'ftp.example.com');
CkFtp2_putUsername(ftp,'myFtpLogin');

//  Normally you would not hard-code the password in source.  You should instead obtain it
//  from an interactive prompt, environment variable, or a secrets vault.
CkFtp2_putPassword(ftp,'myPassword');

success := CkFtp2_Connect(ftp);
if (success = False) then
  begin
    Memo1.Lines.Add(CkFtp2__lastErrorText(ftp));
    Exit;
  end;

success := CkFtp2_ChangeRemoteDir(ftp,'public_html');
if (success = False) then
  begin
    Memo1.Lines.Add(CkFtp2__lastErrorText(ftp));
    Exit;
  end;

//  This is the single-directory (non-recursive) form of SyncLocalTree; it uses the same modes.
//    0 = all selected files
//    1 = files missing locally
//    2 = missing locally, or newer on the server
//    3 = only files that exist locally and are newer on the server
//    5 = missing locally, or a different size
//    6 = missing, different size, or newer on the server
//   99 = do not download; delete local... (see docs)

mode := 2;
success := CkFtp2_SyncLocalDir(ftp,'qa_output/site',mode);
if (success = False) then
  begin
    Memo1.Lines.Add(CkFtp2__lastErrorText(ftp));
    Exit;
  end;
Memo1.Lines.Add('Remote directory synced to local (top level only).');

success := CkFtp2_Disconnect(ftp);
if (success = False) then
  begin
    Memo1.Lines.Add(CkFtp2__lastErrorText(ftp));
    Exit;
  end;

CkFtp2_Dispose(ftp);