Skip to content

Commit

Permalink
Update README.
Browse files Browse the repository at this point in the history
  • Loading branch information
Maikuolan committed Jul 6, 2020
1 parent bccb064 commit 4716d19
Showing 1 changed file with 43 additions and 45 deletions.
88 changes: 43 additions & 45 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,59 +11,57 @@ An ideal solution for shared hosting environments, where it's often not possible
---


### Features:
- Licensed as [GNU General Public License version 2.0](https://github.com/phpMussel/phpMussel/blob/v2/LICENSE.txt) (GPLv2).
- Easy to install, easy to customise, easy to use.
- Works for any system with PHP+PCRE installed, regardless of OS (PHP+PCRE required).
- Fully configurable based on your needs.
- Ideal solution for shared hosting services.
- Ideal solution for forum systems in need of file upload protection.
- Does NOT require shell access.
- Does NOT require administrative privileges.
- CLI mode available.
- Good, strong, stable support base.
### What's this repository for?

---
This provides automatic file upload scanning to your website.

```
composer require phpmussel/web
```

### Documentation:
- **[English](https://github.com/phpMussel/Docs/blob/master/readme.en.md)**
- **[العربية](https://github.com/phpMussel/Docs/blob/master/readme.ar.md)**
- **[Deutsch](https://github.com/phpMussel/Docs/blob/master/readme.de.md)**
- **[Español](https://github.com/phpMussel/Docs/blob/master/readme.es.md)**
- **[Français](https://github.com/phpMussel/Docs/blob/master/readme.fr.md)**
- **[Bahasa Indonesia](https://github.com/phpMussel/Docs/blob/master/readme.id.md)**
- **[Italiano](https://github.com/phpMussel/Docs/blob/master/readme.it.md)**
- **[日本語](https://github.com/phpMussel/Docs/blob/master/readme.ja.md)**
- **[한국어](https://github.com/phpMussel/Docs/blob/master/readme.ko.md)**
- **[Nederlandse](https://github.com/phpMussel/Docs/blob/master/readme.nl.md)**
- **[Português](https://github.com/phpMussel/Docs/blob/master/readme.pt.md)**
- **[Русский](https://github.com/phpMussel/Docs/blob/master/readme.ru.md)**
- **[اردو](https://github.com/phpMussel/Docs/blob/master/readme.ur.md)**
- **[Tiếng Việt](https://github.com/phpMussel/Docs/blob/master/readme.vi.md)**
- **[中文(简体)](https://github.com/phpMussel/Docs/blob/master/readme.zh.md)**
- **[中文(傳統)](https://github.com/phpMussel/Docs/blob/master/readme.zh-tw.md)**

[\[CONTRIBUTING.md\] **Want to help?**](https://github.com/phpMussel/.github/blob/master/CONTRIBUTING.md)

[\[PEOPLE.md\] **Learn about the people behind phpMussel.**](https://github.com/phpMussel/.github/blob/master/PEOPLE.md)
__*Example:*__
```PHP
<?php
// Path to vendor directory.
$Vendor = __DIR__ . DIRECTORY_SEPARATOR . 'vendor';

---
// Composer's autoloader.
require $Vendor . DIRECTORY_SEPARATOR . 'autoload.php';

$Loader = new \phpMussel\Core\Loader();
$Scanner = new \phpMussel\Core\Scanner($Loader);
$Web = new \phpMussel\Web\Web($Loader, $Scanner);

$Web->scan();

unset($Web, $Scanner, $Loader);

?><html>
<form enctype="multipart/form-data" name="upload" action="" method="post">
<div class="spanner">
<input type="file" name="upload_test[]" value="" />
<input type="submit" value="OK" />
</div>
</form>
</html>
```

*(And, after using that form to try uploading `ascii_standard_testfile.txt`, a benign sample provided for the sole purpose of testing phpMussel)…*

### Current major version development status:
__*Screenshot:*__
![Screenshot](https://raw.githubusercontent.com/phpMussel/extras/master/screenshots/web-v3.0.0-alpha2.png)

⬇Stage reached⬇ ➡Major version➡ | v0 | v1-v2 | v3
:--|:-:|:-:|:-:
Pre-Alpha<em><br />- Exploring early concepts/ideas. No code written/available yet.</em> | ✔ | ✔ | ✔
Alpha<em><br />- Branched, but unstable. Not production-ready (high risk if used).</em> | ✔ | ✔ | ✔
Beta<em><br />- Branched, but unstable. Not production-ready (low risk if used).</em> | ✔ | ✔
Stable<em><br />- First production-ready version has been tagged/released.</em> | ✔ | ✔
Mature<em><br />- Multiple stable versions/releases exist.</em> | ✔ | ✔
Locked<em><br />- Still maintained, but new features won't be implemented anymore.</em> | ✔
EoL/Dead<em><br />- Not maintained anymore. If possible, stop using, and update ASAP.</em> | ✔
#### See also:
- [phpMussel/phpMussel](https://github.com/phpMussel/phpMussel) – The main phpMussel repository (you can get phpMussel versions prior to v3 from here).
- [phpMussel/Core](https://github.com/phpMussel/Core) – phpMussel core (dedicated Composer version).
- [phpMussel/CLI](https://github.com/phpMussel/CLI) – phpMussel CLI-mode (dedicated Composer version).
- [phpMussel/FrontEnd](https://github.com/phpMussel/FrontEnd) – phpMussel front-end (dedicated Composer version).
- [phpMussel/Web](https://github.com/phpMussel/Web) – phpMussel upload handler (dedicated Composer version).
- [phpMussel/Examples](https://github.com/phpMussel/Examples) – Prebuilt examples for phpMussel (useful for users which don't want to use Composer to install phpMussel).
- [phpMussel/plugin-boilerplates](https://github.com/phpMussel/plugin-boilerplates) – This repository contains boilerplate code which can be used to create new plugins for phpMussel.
- [phpMussel/Plugin-PHPMailer](https://github.com/phpMussel/Plugin-PHPMailer) – Provides 2FA and email notifications support for phpMussel v3+.

---


Last Updated: 10 June 2020 (2020.06.10).
Last Updated: 6 July 2020 (2020.07.06).

0 comments on commit 4716d19

Please sign in to comment.