README

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.

flobee / filemanager

Maintainers

Details