PureBasic

Upload a Large File in Chunks (FTP)

Demonstrates the Chilkat Ftp2.LargeFileUpload method, which uploads a local file as a sequence of transfers, each up to a given chunk size. The arguments are the local path, the remote path, and the chunk size in bytes.

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: Some servers, proxies, or firewalls impose a limit on the size or duration of a single data transfer, which a very large file can exceed. This method sidesteps that by sending the file in pieces — the first with STOR to create or replace the file, each subsequent one appended — so no single transfer is oversized. Choose a chunk size comfortably under whatever limit you are working around.

Chilkat PureBasic Downloads

Download Chilkat for PureBasic

PureBasic

IncludeFile "CkFtp2.pb"

Procedure ChilkatExample()

    success.i = 0

    ;  Demonstrates the Ftp2.LargeFileUpload method, which uploads a local file as a sequence of
    ;  transfers, each up to a given chunk size.  The 1st argument is the local path, the 2nd is the
    ;  remote path, and the 3rd is the chunk size in bytes.

    ftp.i = CkFtp2::ckCreate()
    If ftp.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    CkFtp2::setCkHostname(ftp, "ftp.example.com")
    CkFtp2::setCkUsername(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::setCkPassword(ftp, "myPassword")

    success = CkFtp2::ckConnect(ftp)
    If success = 0
        Debug CkFtp2::ckLastErrorText(ftp)
        CkFtp2::ckDispose(ftp)
        ProcedureReturn
    EndIf

    ;  The first chunk is sent with STOR (creating/replacing the remote file); each later chunk is
    ;  appended.  Uploading in chunks can work around server or network limits on a single transfer.
    chunkSize.i = 10485760
    success = CkFtp2::ckLargeFileUpload(ftp,"qa_data/bigfile.zip","uploads/bigfile.zip",chunkSize)
    If success = 0
        Debug CkFtp2::ckLastErrorText(ftp)
        CkFtp2::ckDispose(ftp)
        ProcedureReturn
    EndIf

    Debug "Large file uploaded."

    success = CkFtp2::ckDisconnect(ftp)
    If success = 0
        Debug CkFtp2::ckLastErrorText(ftp)
        CkFtp2::ckDispose(ftp)
        ProcedureReturn
    EndIf



    CkFtp2::ckDispose(ftp)


    ProcedureReturn
EndProcedure