How to detect that a file is being uploaded over FTP

There’s no generic solution to this problem.

Some FTP servers lock the file being uploaded, preventing you from accessing it, while the file is still being uploaded. For example IIS FTP server does that. Most other FTP servers do not. See my answer at Prevent file from being accessed as it’s being uploaded.


There are some common workarounds to the problem (originally posted in SFTP file lock mechanism, but relevant for the FTP too):

  • You can have the client upload a “done” file once the upload finishes. Make your automated system wait for the “done” file to appear.

  • You can have a dedicated “upload” folder and have the client (atomically) move the uploaded file to a “done” folder. Make your automated system look to the “done” folder only.

  • Have a file naming convention for files being uploaded (“.filepart”) and have the client (atomically) rename the file after upload to its final name. Make your automated system ignore the “.filepart” files.

    See (my) article Locking files while uploading / Upload to temporary file name for an example of implementing this approach.

    Also, some FTP servers have this functionality built-in. For example ProFTPD with its HiddenStores directive.

  • A gross hack is to periodically check for file attributes (size and time) and consider the upload finished, if the attributes have not changed for some time interval.

  • You can also make use of the fact that some file formats have clear end-of-the-file marker (like XML or ZIP). So you know, that the file is incomplete.


Some FTP servers allow you to configure a hook to be called, when an upload is finished. You can make use of that. For example ProFTPD has a mod_exec module (see the ExecOnCommand directive).

Leave a Comment