Skip to content

Commit

Permalink
chore(release): 0.8.2
Browse files Browse the repository at this point in the history
  • Loading branch information
marcocesarato committed Feb 27, 2021
1 parent e3525cb commit ac62337
Show file tree
Hide file tree
Showing 5 changed files with 59 additions and 36 deletions.
42 changes: 26 additions & 16 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,15 +4,25 @@
All notable changes to this project will be documented in this file.
<!--- END HEADER -->

## [v0.8.1.241](https://github.com/marcocesarato/PHP-Antimalware-Scanner/compare/v0.8.1.236...vv0.8.1.241) (2021-01-17)
## [0.8.2](https://github.com/marcocesarato/PHP-Antimalware-Scanner/compare/v0.8.1.241...v0.8.2) (2021-02-27)


### Bug Fixes

* Silent mode and disable cache/checksum programmatically ([73cd76](https://github.com/marcocesarato/PHP-Antimalware-Scanner/commit/73cd76f59b0a5b418c614f4edcf4f9e1e1aa9fc5))
* Update autoloader ([2b61fd](https://github.com/marcocesarato/PHP-Antimalware-Scanner/commit/2b61fda2cf6d4d9d4b6ed2f0c754e5d678e35586))

---

## [0.8.1.241](https://github.com/marcocesarato/PHP-Antimalware-Scanner/compare/v0.8.1.236...vv0.8.1.241) (2021-01-17)

### Bug Fixes

* Minified report template ([aca0cf](https://github.com/marcocesarato/PHP-Antimalware-Scanner/commit/aca0cff8cbb13dfbadc87990019ed63cae67f5cf))

---

## [v0.8.1.236](https://github.com/marcocesarato/PHP-Antimalware-Scanner/compare/v0.8.0.234...vv0.8.1.236) (2021-01-11)
## [0.8.1.236](https://github.com/marcocesarato/PHP-Antimalware-Scanner/compare/v0.8.0.234...vv0.8.1.236) (2021-01-11)


### Features
Expand All @@ -21,7 +31,7 @@ All notable changes to this project will be documented in this file.

---

## [v0.8.0.234](https://github.com/marcocesarato/PHP-Antimalware-Scanner/compare/v0.7.5.177...vv0.8.0.234) (2021-01-10)
## [0.8.0.234](https://github.com/marcocesarato/PHP-Antimalware-Scanner/compare/v0.7.5.177...vv0.8.0.234) (2021-01-10)


### Features
Expand Down Expand Up @@ -60,7 +70,7 @@ All notable changes to this project will be documented in this file.

---

## [v0.7.5.177](https://github.com/marcocesarato/PHP-Antimalware-Scanner/compare/v0.7.4.147...vv0.7.5.177) (2020-12-31)
## [0.7.5.177](https://github.com/marcocesarato/PHP-Antimalware-Scanner/compare/v0.7.4.147...vv0.7.5.177) (2020-12-31)


### Features
Expand All @@ -87,7 +97,7 @@ All notable changes to this project will be documented in this file.

---

## [v0.7.4.147](https://github.com/marcocesarato/PHP-Antimalware-Scanner/compare/v0.7.3.133...vv0.7.4.147) (2020-12-27)
## [0.7.4.147](https://github.com/marcocesarato/PHP-Antimalware-Scanner/compare/v0.7.3.133...vv0.7.4.147) (2020-12-27)


### Features
Expand All @@ -102,7 +112,7 @@ All notable changes to this project will be documented in this file.

---

## [v0.7.3.133](https://github.com/marcocesarato/PHP-Antimalware-Scanner/compare/v0.7.2.125...vv0.7.3.133) (2020-12-24)
## [0.7.3.133](https://github.com/marcocesarato/PHP-Antimalware-Scanner/compare/v0.7.2.125...vv0.7.3.133) (2020-12-24)


### Features
Expand All @@ -117,7 +127,7 @@ All notable changes to this project will be documented in this file.

---

## [v0.7.2.125](https://github.com/marcocesarato/PHP-Antimalware-Scanner/compare/v0.7.2.123...vv0.7.2.125) (2020-10-25)
## [0.7.2.125](https://github.com/marcocesarato/PHP-Antimalware-Scanner/compare/v0.7.2.123...vv0.7.2.125) (2020-10-25)


### Bug Fixes
Expand All @@ -126,7 +136,7 @@ All notable changes to this project will be documented in this file.

---

## [v0.7.2.123](https://github.com/marcocesarato/PHP-Antimalware-Scanner/compare/v0.7.1.113...vv0.7.2.123) (2020-10-25)
## [0.7.2.123](https://github.com/marcocesarato/PHP-Antimalware-Scanner/compare/v0.7.1.113...vv0.7.2.123) (2020-10-25)


### Features
Expand All @@ -142,7 +152,7 @@ All notable changes to this project will be documented in this file.

---

## [v0.7.1.113](https://github.com/marcocesarato/PHP-Antimalware-Scanner/compare/v0.7.0.110...vv0.7.1.113) (2020-10-24)
## [0.7.1.113](https://github.com/marcocesarato/PHP-Antimalware-Scanner/compare/v0.7.0.110...vv0.7.1.113) (2020-10-24)


### Features
Expand All @@ -151,7 +161,7 @@ All notable changes to this project will be documented in this file.

---

## [v0.7.0.110](https://github.com/marcocesarato/PHP-Antimalware-Scanner/compare/v0.6.0.109...vv0.7.0.110) (2020-10-24)
## [0.7.0.110](https://github.com/marcocesarato/PHP-Antimalware-Scanner/compare/v0.6.0.109...vv0.7.0.110) (2020-10-24)


### Features
Expand All @@ -166,7 +176,7 @@ All notable changes to this project will be documented in this file.

---

## [v0.6.0.109](https://github.com/marcocesarato/PHP-Antimalware-Scanner/compare/v0.6.0.107...vv0.6.0.109) (2020-10-08)
## [0.6.0.109](https://github.com/marcocesarato/PHP-Antimalware-Scanner/compare/v0.6.0.107...vv0.6.0.109) (2020-10-08)


### Features
Expand All @@ -175,7 +185,7 @@ All notable changes to this project will be documented in this file.

---

## [v0.6.0.107](https://github.com/marcocesarato/PHP-Antimalware-Scanner/compare/v0.5.3.93...vv0.6.0.107) (2020-10-07)
## [0.6.0.107](https://github.com/marcocesarato/PHP-Antimalware-Scanner/compare/v0.5.3.93...vv0.6.0.107) (2020-10-07)


### Features
Expand All @@ -192,7 +202,7 @@ All notable changes to this project will be documented in this file.

---

## [v0.5.3.93](https://github.com/marcocesarato/PHP-Antimalware-Scanner/compare/v0.5.2.75...vv0.5.3.93) (2020-10-06)
## [0.5.3.93](https://github.com/marcocesarato/PHP-Antimalware-Scanner/compare/v0.5.2.75...vv0.5.3.93) (2020-10-06)


### Features
Expand All @@ -202,7 +212,7 @@ All notable changes to this project will be documented in this file.

---

## [v0.5.2.75](https://github.com/marcocesarato/PHP-Antimalware-Scanner/compare/v0.5.1.72...vv0.5.2.75) (2020-10-05)
## [0.5.2.75](https://github.com/marcocesarato/PHP-Antimalware-Scanner/compare/v0.5.1.72...vv0.5.2.75) (2020-10-05)


### Features
Expand All @@ -212,7 +222,7 @@ All notable changes to this project will be documented in this file.

---

## [v0.5.1.72](https://github.com/marcocesarato/PHP-Antimalware-Scanner/compare/0.5.0.71...vv0.5.1.72) (2020-10-05)
## [0.5.1.72](https://github.com/marcocesarato/PHP-Antimalware-Scanner/compare/0.5.0.71...vv0.5.1.72) (2020-10-05)


---
Expand All @@ -239,7 +249,7 @@ All notable changes to this project will be documented in this file.

---

## [v0.5.0.69](https://github.com/marcocesarato/PHP-Antimalware-Scanner/compare/0.5.0.68...vv0.5.0.69) (2020-01-30)
## [0.5.0.69](https://github.com/marcocesarato/PHP-Antimalware-Scanner/compare/0.5.0.68...vv0.5.0.69) (2020-01-30)


### Features
Expand Down
49 changes: 31 additions & 18 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@

<h1 align="center">PHP Antimalware Scanner</h1>

![Version](https://img.shields.io/badge/version-0.8.1-brightgreen?style=for-the-badge)
![Version](https://img.shields.io/badge/version-0.8.2-brightgreen?style=for-the-badge)
![Requirements](https://img.shields.io/badge/php-%3E%3D%205.5-4F5D95?style=for-the-badge)
![Code Style](https://img.shields.io/badge/code%20style-PSR-blue?style=for-the-badge)
![License](https://img.shields.io/github/license/marcocesarato/PHP-Antimalware-Scanner?style=for-the-badge)
Expand All @@ -18,20 +18,27 @@

PHP Antimalware Scanner is a free tool to scan PHP files and analyze your project to find any malicious code inside it.

It provides an interactive text terminal console interface to scan a file, or all files in a given directory (file paths can be also be managed using `--filter-paths` or `--ignore-paths`), and find PHP code files that seem contain malicious code.
When a probable malware is detected, will be asked what action to take (like add to whitelist, delete files, try clean infected code etc...).
It provides an interactive text terminal console interface to scan a file, or all files in a given directory (file paths
can be also be managed using `--filter-paths` or `--ignore-paths`), and find PHP code files that seem contain malicious
code. When a probable malware is detected, will be asked what action to take (like add to whitelist, delete files, try
clean infected code etc...).

The package can also scan the PHP files in a report mode (`--report|-r`), so without interact and outputting anything to the terminal console. In that case the results will stored in a report file in html (default) or txt format (`--report-format <format>`).
The package can also scan the PHP files in a report mode (`--report|-r`), so without interact and outputting anything to
the terminal console. In that case the results will stored in a report file in html (default) or txt
format (`--report-format <format>`).

This scanner can work on your own php projects and on a lot of others platform using the right combinations of configurations (ex. using `--lite|-l` flag can help to find less false positivity).
This scanner can work on your own php projects and on a lot of others platform using the right combinations of
configurations (ex. using `--lite|-l` flag can help to find less false positivity).

:warning: *Remember that you will be solely responsible for any damage to your computer system or loss of data that results from such activities.
You are solely responsible for adequate protection and backup of the data before execute the scanner.*
:warning: *Remember that you will be solely responsible for any damage to your computer system or loss of data that
results from such activities. You are solely responsible for adequate protection and backup of the data before execute
the scanner.*

### How to contribute

Have an idea? Found a bug? Please raise to [ISSUES](https://github.com/marcocesarato/PHP-Antimalware-Scanner/issues) or [PULL REQUEST](https://github.com/marcocesarato/PHP-Antimalware-Scanner/pulls).
Contributions are welcome and are greatly appreciated! Every little bit helps.
Have an idea? Found a bug? Please raise to [ISSUES](https://github.com/marcocesarato/PHP-Antimalware-Scanner/issues)
or [PULL REQUEST](https://github.com/marcocesarato/PHP-Antimalware-Scanner/pulls). Contributions are welcome and are
greatly appreciated! Every little bit helps.

## :blue_book: Requirements

Expand Down Expand Up @@ -61,16 +68,16 @@ Go on GitHub page and press on Releases tab or download the raw file from:

3. *(Optional)* Install as bin command (Unix Bash)

Run this command:
Run this command:

```sh
wget https://raw.githubusercontent.com/marcocesarato/PHP-Antimalware-Scanner/master/dist/scanner --no-check-certificate -O /usr/bin/awscan.phar && \
printf "#!/bin/bash\nphp /usr/bin/awscan.phar \$@" > /usr/bin/awscan && \
chmod u+x,g+x /usr/bin/awscan.phar && \
chmod u+x,g+x /usr/bin/awscan && \
export PATH=$PATH":/usr/bin"
```

Now you can run the scanner simply with this command: `awscan ./dir-to-scan -l...`

### Source
Expand Down Expand Up @@ -129,14 +136,17 @@ You could find some false positive during scanning. For this you can choice the
| --------------------------- | ------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| None (`default`) | :red_circle: | Search for all functions, exploits and malware signs without any restrictions |
| `--only-exploits` or `-e` | :orange_circle: | Search only for exploits definitions |
| `--lite` or `-l` | :yellow_circle: | Search for exploits with some restrictions and malware signs *(on Wordpress and others platform could detect less false positivity)* |
| `--only-functions` or `-f` | :yellow_circle: | Search only for functions *(on some obfuscated code functions couldn't be detected)* |
| `--only-signatures` or `-s` | :green_circle: | Search only for malware signatures *(could be a good solution for Wordpress and others platform to detect less false positivity)* |
| `--lite` or `-l` | :yellow_circle: | Search for exploits with some restrictions and malware signs *(on
Wordpress and others platform could detect less false positivity)* |
| `--only-functions` or `-f` | :yellow_circle: | Search only for functions *(on some obfuscated code functions
couldn't be detected)* |
| `--only-signatures` or `-s` | :green_circle: | Search only for malware signatures *(could be a good solution for
Wordpress and others platform to detect less false positivity)* |
### Suggestions
If you are running the scanner on a Wordpress project or other popular platform use `--only-signatures` or `--lite` flag for have check with less false positive but
this could miss some dangerous exploits like `nano`.
If you are running the scanner on a Wordpress project or other popular platform use `--only-signatures` or `--lite` flag
for have check with less false positive but this could miss some dangerous exploits like `nano`.
#### Examples:
Expand All @@ -147,7 +157,8 @@ php -d disable_functions='' scanner -l
## Detection Options
When a malware is detected you will have the following choices (except when scanner is running in report mode `--report`):
When a malware is detected you will have the following choices (except when scanner is running in report
mode `--report`):
- Delete file [`--auto-delete`]
- Move to quarantine `(move to ./scanner-quarantine)` [`--auto-quarantine`]
Expand All @@ -162,6 +173,7 @@ When a malware is detected you will have the following choices (except when scan
## :computer: Usage
### Command line
```
Arguments:
Expand Down Expand Up @@ -290,4 +302,5 @@ object(stdClass) (7) {
![Screen Report](images/screenshot_report.png)

### Interactive CLI

![Screen Full](images/screenshot_full.png)
Binary file modified dist/scanner
Binary file not shown.
2 changes: 1 addition & 1 deletion dist/version
Original file line number Diff line number Diff line change
@@ -1 +1 @@
0.8.1
0.8.2
2 changes: 1 addition & 1 deletion src/Scanner.php
Original file line number Diff line number Diff line change
Expand Up @@ -48,7 +48,7 @@ class Scanner
*
* @var string
*/
public static $version = '0.8.1';
public static $version = '0.8.2';

/**
* Root path.
Expand Down

0 comments on commit ac62337

Please sign in to comment.