//================================================================================
//
// Author : Law Eng Soon
// Email : mailme@zorex.info
//
// Enhancer : Daniel Vassy (version 1.3 to 2.0)
// Email : daniel@vassy.org
//
// Version : 2.0
//
//================================================================================
//
// Warning :
// This program is non commercial and non professional work.
// This program is not advertized as 100% bug free.
//
// NO RESPONSIBILITY IS ASSUMED BY THE AUTHORS FOR CONSEQUENCES OF
// INSTALLING OR USING THIS PROGRAM.
//
// You are cautioned that installing a file manager on your web server
// entails a major security risk if the file manager is hacked.
//
// You are required to satisfy yourself that the software meets your
// requirement and you will be installing and/or using it at your own risk
//
//======================================================================
// PHP Explorer v2.0 - 03 July 2010
//======================================================================
- Menu
=================================
1 - Introduction
2 - Installation Instructions
3 - License
4 - Changes
5 - Support and Bugs
6 - Warning
7 - Authors
8 - Contributions
1 - Introduction
=================================
A tool use to browse, search, download, upload, move, copy rename and delete
files and folders on a web server through HTTP access only.
2 - Installation Instructions
=================================
1. Extract the files
2. Edit index.php code in the area "Application Parameters" at the top
to configure your authentication parameters and list of authorized users.
You should NOT run PHP Explorer on a web server without authentication enabled,
as it creates an unacceptable security vulnerability. If you choose to do so, that's
at your own risk. In that case, make sure at least that your Apache configuration does
not allow casual browsing to the directory where you installed PHP Explorer, and that
not link to it is posted anywhere !
3. Create a specific folder on your web server or 'localhost' area and upload
the files to it.
How to decide which folder:
PHP explorer will start in a home directory which is either the PHP Exlorer folder itself,
or the parent directory of the PHP Explorer folder, or the HOME_DIRECTORY in this parent
directory, in reverse order of priority (according to which exists and is accessible).
Unless restricted_browsing is disabled, PHP Explorer will not browse UP from the home directory.
Therefore a good location is under the root of the web server.
Note however that the browsing restriction is NOT a security feature. Authentication should
still be used. Read comments in text about this
2. CHMOD all the files and dirs to 0755 if necessary.
3. Launch a web browser and got to index.php in your PHP Explorer directory (on most
web server implementations, this will be the default file opened if you just plug
a link to the directory in your browser URL area)
- Extra
4. Users may add new icons for new files extensions such as 'bak' by creating png images with the
name 'bak.png' (normal) 'bak2.png' (restricted) and place them in the 'ext_ico' dir.
3 - License
=================================
This software is released under GNU/LGPL license.
This software is free, so you can use it at no cost.
We will be happy if you send an email (mailme@zorex.info and daniel@vassy.org) telling
us that you are using the software and what you think about it.
If you like the file upload feature or the right-click driven operations
thanks for telling me (the enhancer) by e-mailing daniel@vassy.org
For more information about GNU/LGPL license : http://www.gnu.org
4 - Changes
=================================
Version 2.0
- Fixed a bug affecting directory copy
- Fixed a bug affecting display in Safari when file list has a scroll bar
- Moved authentication code and parameters at the top of the
file to allow easy configuration
- Moved initial directory specification to configuration area and
created the restricted bowsing mode
- Made PHP command-execution an optional feature
- Cleaned up comments and presentation in preparation for posting
Version 1.4 :
- Added context-menu funtions : Copy, Move, Rename, Delete
Important note: context menus will NOT work under Opera, due
to a deliberate restrinctions in Opera against capturing the rightclick
mouse event. There is NO workaround at this time. Get yourself another
browser...
Version 1.3 :
- Added upload function
- Added authentication
- Code improvement
. added initialization to variables which triggered a warning
. fixed minor bugs
Version 1.2 :
- Added search function
. Enable user to search for files or folders.
. Search part of file content.
- Code improvement
. Code are cleaned in adding of new feature, functions are added.
. Output are parse to prevent display error.
. PHP script execution are executed after the main program to prevent error.
. 'icons' folder is rename to 'ext_ico' to prevent some webserver aliases conflict.
- Bugs fix
. Fixed the problem in sorting the files according to their name.
. Some javascript fix for optimal performance.
. Able to show the executed code in editor.
Version 1.1 :
- Display icons for different file extension.
. Icons are added for nicer display.
. User can add their own icons for other ext.
- Bugs fix
. Fixed javascript problem for open and close in IE.
. Some other minor bugs fix.
Version 1.0 :
- No changes.
5 - Support bugs
=================================
For any support and bugs, please email to daniel@vassy.org
6 - Warning
=================================
This program is non commercial and non professional work.
This program is not advertized as 100% bug free.
NO RESPONSIBILITY IS ASSUMED BY THE AUTHORS FOR CONSEQUENCES OF
INSTALLING OR USING THIS PROGRAM.
You are cautioned that installing a file manager on your web server
entails a major security risk if the file manager is hacked.
You are required to satisfy yourself that the software meets your
requirement and you will be installing and/or using it at your own risk
7 - Authors
=================================
This software is written by Law Eng Soon (mailme@zorex.info) for fun.
The enhancements were written by Daniel Vassy who got mad at firewalls
for restricting ftp access
8 - Contribution
=================================
If you wish to contribute to this project or other projects of mine,
please contact mailme@zorex.info or go to http://zorex.info
