README.md

simple-file-manager
===================

A Simple PHP file manager.  The code is a single php file.  

Just copy `index.php` to a folder on your webserver.  

## Why it is good

- Single file, there are no images, or css folders.  
- Ajax based so it is fast, but doesn't break the back button
- Allows drag and drop file uploads if the folder is writable by the webserver (`chmod 777 your/folder`)
- Suits my aesthetics.  More like Dropbox, and less like Windows Explorer
- Works with Unicode file names
- The interface is usable from an iPad
- XSRF protection, and an optional password.

## Do not allow uploads on the public web

If you allow uploads on the public web, it is only a matter of time before your server is hosting and serving very illegal content. Any of the following options will prevent this:
 - Don't make the folder writable by the webserver `chmod 775`
 - Set `$allow_upload = false`
 - Use a password `$PASSWORD = 'some password'`
 - Use a `.htaccess` file with Apache, or `auth_basic` for nginx
 - Only use this on a private network

 HT: [@beardog108](https://github.com/beardog108)

## Screenshot

![Screenshot](https://raw.github.com/jcampbell1/simple-file-manager/master/screenshot.png "Screenshot")
Initial commit 2013-10-18 19:39:27 -07:00			`simple-file-manager`
			`===================`

			`A Simple PHP file manager. The code is a single php file.`
initial commit 2013-10-18 22:53:53 -04:00
tweaked the readme 2017-02-22 13:53:34 -05:00			Just copy `index.php` to a folder on your webserver.
initial commit 2013-10-18 22:53:53 -04:00
adding screenshot to markdown 2013-10-18 23:02:16 -04:00			`## Why it is good`
initial commit 2013-10-18 22:53:53 -04:00
			`- Single file, there are no images, or css folders.`
			`- Ajax based so it is fast, but doesn't break the back button`
tweaked the readme 2017-02-22 13:53:34 -05:00			- Allows drag and drop file uploads if the folder is writable by the webserver (`chmod 777 your/folder`)
fix spelling error 2013-10-19 00:09:34 -04:00			`- Suits my aesthetics. More like Dropbox, and less like Windows Explorer`
initial commit 2013-10-18 22:53:53 -04:00			`- Works with Unicode file names`
			`- The interface is usable from an iPad`
Adding a word of warning about allowing uploads on the public web 2017-02-22 13:06:15 -05:00			`- XSRF protection, and an optional password.`

			`## Do not allow uploads on the public web`

			`If you allow uploads on the public web, it is only a matter of time before your server is hosting and serving very illegal content. Any of the following options will prevent this:`
			- Don't make the folder writable by the webserver `chmod 775`
			- Set `$allow_upload = false`
			- Use a password `$PASSWORD = 'some password'`
			- Use a `.htaccess` file with Apache, or `auth_basic` for nginx
			`- Only use this on a private network`

			`HT: [@beardog108](https://github.com/beardog108)`
adding screenshot to markdown 2013-10-18 23:02:16 -04:00
			`## Screenshot`

			`![Screenshot](https://raw.github.com/jcampbell1/simple-file-manager/master/screenshot.png "Screenshot")`