Introduction

Web File Browser is a simple open-source file browser written in PHP (1 single file) that allows users to create, delete, edit, copy, rename, move and upload files and directories thru a light, full-text, web-based interface

Download

Web File Browser's home page is here.
Web File Browser's project page at SourceForge is here.

To download current version 0.4b14 (still beta) go to Web File Browser's download page at SourceForge.

Installation

Copy the webFileBrowser.php file to your target directory in your web server's document root.
Give any name to this file (it will remain invisible anyway) : wfb.php for instance.

Look at the source for optional customization.

Start your favorite Web Browser and point to http://yourserver.yourdomain/yourdirectory/wfb.php.

If you have just unziped the package and if this page is served by a PHP enabled web server :

Click HERE

It should be working...

Warning for users of previous versions : some default settings have changed, check them carefully !

Customization

Web File Browser allows you to customize certain features such as :

  • Title, colors, sizes...
  • Enable/disable links on files
  • Enable/disable file uploads
  • Customize list of extensions that allow files to be edited
  • ...

Give an eye to the source to see all options.

Security

Web file browser includes a builtin authentication (look at the source) but you *must* run PHP as a module in order to be able to turn it on.

You can also rely on your web server for authentication.

For instance with Apache you can setup a .htaccess file like this :

<Files "wfb.php">
   AuthType Basic
   AuthUserFile ".htpasswd"
   AuthName "webFileBrowser"
   Require valid-user
</Files>

FAQ

File upload does not work, what's wrong ?

There are two main reasons for that :

  • First, check your php.ini :
    file_uploads = On
    upload_max_filesize = 2M
    and verify that the value in $uploadmaxsize variable is the same as this value (for istance 2M means 2 megabytes = 2097152 bytes)
  • Second, if you run your PHP-enabled web server under UNIX, uploaded files (and created files/directories) are created under the ownership of the UNIX user that runs your webserver.
    As the PHP function chown() does not work unless this user is root (which is obviously a bad idea) it is not possible to chown files to another user after creation.
    A simple workaround is to chown/chgrp your directories to the webbrowser user/group,
    Another workaround is to add the webbrowser group to the secondary groups of the user owner of the directories (that's what I do). In that case remeber to set $filemode to 0664 and $dirmode to 0775.

URL upload does not work, what's wrong ?

Check your php.ini :
allow_url_fopen = On
and keep in mind that only URL explicitely pointing to a file (such as http://myserver/myfile.txt) can be URL-uploaded.

How do I hide files ?

Customize $hidefilepattern so as it contains a regular expression matching the name of the files you want to hide.
An example is given is the source to hide dot files.

Why "delete" action does not appear ?

When you delete a file Web File Browser just move it into the trash can directory. This directory (located in the base directory) must exists and be writeable, if not the delete button is inhibited.
You can customize its name using $trashcan.

Which web browsers are supported ?

WebFileBrowser have been tested on Internet Explorer 6.0, Netscape 4.75 and Netscape 7.0. It should work with other W3C compliant browsers, if not tell me what goes wrong !

Feel free to ask me any question

BUGS

None reported on current version for the moment. But there are certainly some...

Feel free to report me any problem.

TODO List

Identified features that will be soon develloped :

  • Handling of multiple uploads
  • Zip/Unzip files and directories
  • Reorganization of the code and added comments

Feel free to send me any feature request.

Help needed

The internationalization effort has just began. These language are now supported :

  • English (corrected by Randall COHEN)
  • French
  • Spanish and Catalan thanks to Albert LOMBARTE
  • German thanks to Johannes EDER
  • Swedish thanks to Mikael WANBERG
  • Ukranian thanks to Dmytro KOVALOV
  • Dutch thanks to Luk VANLANDUYT
  • Norwegian thanks to Paul LOE
  • Finnish thanks to Petteri HIETAVIRTA
  • Turkish thanks to Tayfun BILSEL
  • Greek thanks to Balaskas EUAGGELOS
  • Polish thanks to Slawomir BROWKIN

If someone is interested in translating Web File Browser in other languages (or in improving my rather approximative english) let me know.

History

  • Versions 0.1a, 0.2a and 0.3a were alpha versions not worth publishing...
  • Version 0.4b1 was first beta version.
  • Versions 0.4b2 and 0.4b3 fixed few bugs and added few sub-features
  • Versions 0.4b4, 0.4b5, 0.4b6 fixed few bugs and added trash can management
  • Version 0.4b7 added direct links to main directory and trash can and README file management
  • Version 0.4b8 fixed a few bugs, added file restore feature in trash can and added URL upload feature
  • Version 0.4b9 fixed a few bugs and added file aliasing feature
  • Version 0.4b10 added multilingual support
  • Version 0.4b11 fixed a few bugs regarding PHP warnings
  • Version 0.4b12 fixed issue with "register_globals", added search (thanks to Larry CHAFFIN for the idea) and download features, added images (thaks again Larry), added optionnal images, fixed few bugs
  • Version 0.4b13 reorganized PHP and generated HTML/Javascript code, added help messages in the status bar, added multiple file selection (also fixed few bugs)
  • Version 0.4b14 added profile management and other authentication methods, fixed some subtile bugs (thanks to Jean-Jacques LE MOUEL)

Disclaimer

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY;
without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
See the
GNU General Public License for more details.

License

This program is free software; you can redistribute it and/or modify it under the terms of
the GNU General Public License as published by the Free Software Foundation