Use this application to manage files and directories on your webserver or any FTP server. You can
create, rename, move and delete directories, upload, download, edit, rename, move, copy, delete
and search files, and change file and directory permissions*. It's also possible to play audio/video
files and view preview thumbnails of images.
Have a look at the following examples (most file actions are disabled for security reasons, though).
The first example shows the default view with directory tree and log window:
×
×
×
×
×
×
×
×
×
The next two examples are "minimized" views; the first one lists all MP3 files, while the second
one shows preview thumbnails from all JPG files - this time without title bar. In both cases, the
search function has been disabled to "lock" the initial search result:
Please have a look at the config.inc.php file to find out how FileManager can be adapted
to your needs.
FileManager can be used as a stand-alone application, but it's also easy to integrate it into
your own website. The above examples show that it is no problem to create as many FileManager
instances as you like, each one with its own specific settings. Just have a look at the
usage section and the source code of filemanager.php to see
how you can do this.
FileManager works fine with FTP connections. Please note that if you don't set up an FTP
connection in the configuration, FileManager will use the
local file system instead. In this case it can only access directories and files for which
PHP has at least read permission; if you want to upload, edit, rename, move, copy or delete
files, or change file permissions*, PHP must also have write permission for these files or
directories.
This software needs PHP 5 or higher.
Features
Works with FTP servers (UNIX and Windows) and local file system.
Supports multiple languages.
Can be easily adapted by modification of configuration file and CSS file.
Can be easily integrated into your website - even multiple instances.
Supports detailed view and icon view.
Built-in editor for text files with realtime syntax hilighting.
Built-in image preview with thumbnails.
Built-in action log.
Integrated file and directory search.
Integrated directory tree for quick directory switching**.
Supports automatic setting of permissions when creating new directories or saving
files*.
Supports automatic modification (to lowercase, replace spaces) of filenames for
uploaded and downloaded files.
Images can be resized automatically before they are saved.
Multiple files and even whole directories can be uploaded and downloaded at once.
Files can also be saved from URLs.
Supports automatic backup creation (versioning) when saving files.
Supports restoring of deleted files.
Supports password protection (login).
Supports hiding of system files, files with arbitrary extensions, and whole directories.
Works with UTF-8 and other character sets.
Integrated media player for audio and video files.
Can view documents (Word, Excel, PDF, etc.) with Google Docs Viewer.
Provides hooks for upload and download.
Smart refresh feature keeps all users updated.
* On Windows systems changing of file permissions doesn't work properly. This is not a
restriction of this software.
** If the number of directories is too big, it will take some time to load. This goes
especially for FTP connections. In this case it is recommended to disable the directory
tree.
File Search
You can use FileManager to search files and directories. It will search all directories
recursively, starting in the directory that is currently viewed. At the moment, it is only
possible to search for file or directory names. Wildcards like "*" are not supported; FileManager
will find all files and directories containing the search string in their name. For instance, if
you search for "file", the files "filemanager.php", "file.gif", etc. will match your search.
While FileManager views a search result, file upload is disabled, and you cannot create new
directories. If you want to do so, please return to your current directory listing first. Please
note that this is not possible if you disabled the search function, but told FileManager to start
with a search - in this case, the current search result will be "locked" and file upload and
directory creation won't be possible.
Upload Engines
File upload with PHP has two drawbacks: usually the file size is limited (default is 2 MB
per file and 8 MB per POST request), and it is not possible to view a progress bar - at least
not without APC extension (NOTE: you need PHP 5.2+). The size limit can be changed for instance
in the php.ini file by the server administrator, but this will also affect all other PHP
applications. (Changing this value on a per-directory-basis is also possible, see
php.net for detailed information.) For this
reason, FileManager comes with several upload engines.
The Java Uploader
The open source JUpload applet
views a progress bar, supports drag and drop, upload of big files and even whole directories.
It's integrated into FileManager since version 7.8 as default upload engine. Java 1.4 or higher
is required on the client side.
The JavaScript Uploader
Don't want to use a Java applet? Well, if you don't need to upload big files, you can try the
integrated open source
FileDrop
uploader, which views a progress bar, supports drag and drop and multiple file upload. It should
work with all browsers that support HTML5. Please note that when uploading several big files at
once, the browser may crash - if this happens, try to upload the files one by one or use another
upload engine.
The Perl Uploader
Alternatively FileManager can also upload files via Perl and view a progress bar while uploading.
This requires however that Perl is installed on your server, and that the Perl scripts in
FileManager's cgi directory can be executed. Please have a look at the
usage section to see how this can be done.
The PHP Uploader
This is the basic uploader that should only be used if the other upload engines don't work for you.
It only requires PHP on your server, but you will have to live with a file size limit (depending
on your PHP configuration) and without a progress bar (unless your browser views it by default).
Authentication
If you want to use the Java or Perl uploader and installed FileManager on a server that requires
authentication, you must set the authUser and authPassword variables in
FileManager's configuration file.
Smart Refresh
If two or more users share the same directories and files, usually they don't see the modifications
of each other until they refresh their directory listings manually. FileManager comes with a smart
refresh feature that can do this automagically if any user has made modifications.
However, keep in mind that FileManager enables you to set an individual start directory for each
user. In this case, the smart refresh function won't work properly. There might be other cases
where the smart refresh fails, but remember that you can still refresh your FileManager manually. ;-)
The smart refresh feature is disabled by default, because it puts more load on the server and
produces more traffic. You can enable it anytime in the configuration file or at runtime
(have a look at the usage section for more info). Please note that this
feature is experimental, i.e. there might be unexpected behavior.
Media Player
The integrated open source audio player
SoundManager 2
can handle MP3 audio files. Please note that Flash 9+ is required on the client side. MP4/AAC,
WAV and OGG audio files are also playable if your browser supports them with HTML5 audio.
FileManager can view SWF files, too. MP4, WebM and OGG videos are supported via HTML5 video.
This only works if your browser supports HTML5 and the above video formats. For the video formats
MP4 and FLV, the OOS FlvPlayer
is being used as a fallback. This also requires Flash 9+ on the client side.
A Quick Note On ID3 Tags And Preview Thumbnails
It is only possible to view ID3 tags and preview thumbnails from files of the server's local file
system. This is no problem when FileManager uses the local file system, but in FTP mode these files
must first be copied from the FTP server. This can take quite some time especially when the file
size is big and/or there are a lot of files in a directory. In this case, it is recommended to
disable image preview and ID3 tags. This can be done in the configuration file (variables
enableImagePreview and enableId3Tags).
A Quick Note On File Download
When FileManager runs in FTP mode, files must first be transfered to the local system before
they can be sent to the browser. This can take some time especially with big files. To avoid
this, FileManager uses the asynchronous FTP mode: while loading a file from the FTP server, it can
start to send it to the browser without having to wait until the transfer is complete.
Known Issues
Here's a list of things that don't work on some systems or with certain configurations:
If SSL is used, FileManager might not work properly in Internet Explorer. This seems to be a
browser problem, though. It might help to tweak your SSL server configuration like this:
Thumbnail creation of big images might not work on some servers. This also goes for automatic
resizing when uploading images (server returns error 500 and the image won't be saved). Increase
the memory size limit in your server's PHP configuration and restart your web server.
Conversion to CP437 (for filenames in a ZIP archive) doesn't work on my web server
(SunOS), but it does work on my local server (Windows). This means that file and directory
names in ZIP archives created by FileManager may be corrupted if they contain non-ASCII
characters.
The FileDrop upload engine may have problems with big files - if it doesn't work for you,
use another upload engine.
FileManager does not work well with Internet Explorer 7 (or less). Use the current version or
at least version 8.
Change Log
Version 10.12
* Fixed directory tree: Handle allowed and hidden directories properly.
Version 10.11
* Added some error messages if certain AJAX requests fail.
Version 10.10
* Added fix for AUTH_USER in session save path. * Use TXT icon as default icon for ASCII files. * Updated SoundManager. * Media player: View ID3 tags via SoundManager.
Version 10.9
* Fix for Java uploader: Create folders correctly when uploading multiple directories.
Version 10.8
* Fix for Java uploader: Only replace spaces with underscores in directory names if $replSpacesUpload is set. * Added possibility to modify e-mail subject line for upload and download info. * Added possibility to set a custom JavaScript function that will be called when a file is clicked.
Version 10.7
* Always replace spaces with underscores in file and directory names if $replSpacesUpload is set. * Always convert file and directory names to lowercase if $lowerCaseUpload is set.
Version 10.6
* Keep sub folder structure when using the Java upload engine. * In sub folders, all entries can be selected at once now. * Bugfix: Don't view context menu when clicking on a checkbox. * Bugfix: View correct context menu after returning to a parent directory.
Version 10.5
* Fixed mail on upload feature.
Version 10.4
* Bugfix: Check if $id is not empty in FM_Event::_refresh method. * Bugfix: Only reload directory tree if needed.
Version 10.3
* Minor bugfix: Removed $this in static method FileManager::error. * Added workaround for session garbage collection on Debian systems. * Bugfix: Don't view context menu when left-clicking on "..".
Version 10.2
* Added icons for global actions to title bar. * View context menu when clicking on FileManager container (if right-click is disabled). * Fixed "empty" file selector fields in Chrome browser.
Version 10.1
* Bugfix: View directory tree when moving/copying files. * Optimized directory tree update. * Optimized smart refresh.
Version 10.0
* Code refactoring for PHP 5. * Added JavaScript uploader (FileDrop). * Added audio player with ID3 tag support. * Added HTML5 video support with Flash fallback. * Added recursive directory deletion. * Added support for directory restoring. * Added smart refresh. * New icons. * Lots of improvements under the hood.
Version 9.12
* Bugfix: Update list view icon in title bar when switching list view.
Version 9.11
* Bugfix: Resize FileManager properly when directory tree has fixed width.
Version 9.10
* Resize FileManager, too if browser window is resized. * Several bugfixes.
Version 9.9
* Added possibility to set width and height by percentage. * Added possibility to hide the title bar. Note that some functions won't be available then.
Version 9.8
* Text editor opens in new "window" now (like document viewer).
Version 9.7
* Added possibility to disable file cache. * Bugfix: Files were not removed properly from cache in FTP mode.
Version 9.6
* Added support for bulk moving of files and directories.
Version 9.5
* Added support for touchscreen devices. * Updated SoundManager.
Version 9.4
* Added fixed table header in detailed view. In IE 7 standard mode it doesn't view properly, but in quirks mode it views ok. No problems with IE 8 and 9, though.
Version 9.3
* Important bugfix: Bulk delete caused JavaScript error.
Version 9.2
* Added support for zipped bulk download of files and directories. * Bugfix: Set session save path if PHP_AUTH_USER is set. * Optimized download mail notification.
Version 9.1
* Important bugfix: Some dialogs caused a JavaScript error because of a PHP warning inside the JSON string.
Version 9.0
* Important bugfix: Upload via Perl didn't work if temporary directory was not the default directory. * Bugfix: View filename in error message if upload fails. * Bugfix: Renamed icon "exe.gif" to "program.gif". * Added support for right-click context menu - does not work with Opera, though. * Lots of improvements under the hood.