PHP File Manager

A good solution for managing files and folders for developers who can't access their site over SSH or FTP or who need "www-data" permission (*nix).

Danger!

WARNING! Do not use this script as a regular file manager in public area. After all actions you must delete this script from the server.

And: Skip error reporting! This tools does a good job but take care and don't look behind the scene :) Test it first in a save enviroment (eg.: define('FM_ROOT_PATH', '/tmp'); // playground first!

Requirements

• PHP 5.2 / PHP 7++
• Zip extension for zip and unzip actions.
• Fileinfo, iconv and mbstring extensions are strongly recommended.

How to use

Download ZIP with the latest version from the master branch.

Copy filemanager.php to your website folder and open it in a web browser (e.g. http://yoursite/any_path/filemanager.php).

Security

Default username/password: fm_admin/fm_admin

Warning! Please set your own username and password in $auth_users before use.

To enable or disable authentication set $use_auth to true or false.

For better security enable HTTP Authentication in your web server.

Embedding

You can include file manager in another script. Just define FM_EMBED and other necessary constants.

The authentication does not work in emedded mode and it is expacted you use your own authentication/ authorisation mechanism!

Example:

class FileManagerController
{
    public function runAction()
    {
        define('FM_EMBED', true);
         // must be set if URL to manager is not equal to PHP_SELF
        define('FM_SELF_URL', 'https://host/path/index.php?controller=FileManager&action=run';

        // if document root location is different to filesystem
        define('FM_ROOT_PATH', '/tmp'); // playground first!

        require 'path/to/filemanager.php';
    }
}

Supported constants:

• FM_ROOT_PATH - default is $_SERVER['DOCUMENT_ROOT']
• FM_ROOT_URL - default is 'http(s)://site.domain/'
• FM_SELF_URL - default is 'http(s)://site.domain/' . $_SERVER['PHP_SELF']
• _FM_SELF_URL - internal usage (to improve embedded usage)
• FM_ICONV_INPUT_ENC - default is 'CP1251'
• FM_USE_HIGHLIGHTJS - default is true
• FM_HIGHLIGHTJS_STYLE - default is 'vs'
• FM_DATETIME_FORMAT - default is 'd.m.y H:i'
• FM_SESSION_ID - Session name and session key (default 'filemanager') to prevent conflicts

Public parameters/ actions in use (when using embedded you may need this info):

• p - filesystem path to use
• new - Create a new directory
• copy - Copy a file or directory src
• move - Flag to move and not to copy a file or directory
• finish - Flag to enable file/directory copy/movements
• ren - Rename selected file or directory
• to - Rename target
• dl - Download selected file
• del - delete a file/ directory
• group - Mass deletion of selected items
• delete
• group - Pack selected items
• zip
• unzip - Unpack selected item
• tofolder - Upack to folder of zip's filename
• chmod - Change mode (permissions) of selected item
• view - Show selected item (list zip contents, shows images/media or mime:text files)
• logout - logout (if enabled)
• img - Show a selected image
• upl - Flag for uploads
• upload - Upload _FILES
• fm_usr - Login user (if auth enabled)
• fm_pwd - Login pass (if auth enabled)

Alternatives

• PHP File Manager origin
• Tiny PHP File Manager with search and file editor
• simple php filemanager

Bug tracker

If you have any issues with file manager, you may report them on Issue tracker.

License

This software is released under the MIT license.

Icons by Yusuke Kamiyamane.