README

👁 v1: PHP >= 5.4 < 8.4
👁 v2: PHP >= 7.2 < 8.4
👁 v3: PHP >= 7.2
👁 License: GPL v2
👁 PRs Welcome

What is phpMussel?

An ideal solution for shared hosting environments, where it's often not possible to utilise or install conventional anti-virus protection solutions, phpMussel is a PHP script designed to detect trojans, viruses, malware and other threats within files uploaded to your system wherever the script is hooked, based on the signatures of ClamAV and others.

What's this repository for?

This provides a front-end administrative facility for phpMussel.

composer require phpmussel/frontend

Example:

<?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);
$FrontEnd = new \phpMussel\FrontEnd\FrontEnd($Loader, $Scanner);
$Web = new \phpMussel\Web\Web($Loader, $Scanner);
$Loader->Events->addHandler('sendMail', new \phpMussel\PHPMailer\Linker($Loader));

// Scans file uploads (execution terminates here if the scan finds anything).
$Web->scan();

// Fixes possible corrupted file upload names (Warning: modifies the content of $_FILES).
$Web->demojibakefier();

// Load the front-end.
$FrontEnd->view();

// Cleanup.
unset($Web, $FrontEnd, $Scanner, $Loader);

Screenshot: 👁 Screenshot

Documentation:

• English
• العربية
• Deutsch
• Español
• Français
• Bahasa Indonesia
• Italiano
• 日本語
• 한국어
• Nederlandse
• Português
• Русский
• اردو
• Tiếng Việt
• 中文（简体）
• 中文（傳統）

See also:

• phpMussel/phpMussel – The main phpMussel repository (you can get phpMussel versions prior to v3 from here).
• phpMussel/Core – phpMussel core (dedicated Composer version).
• phpMussel/CLI – phpMussel CLI-mode (dedicated Composer version).
• phpMussel/FrontEnd – phpMussel front-end (dedicated Composer version).
• phpMussel/Web – phpMussel upload handler (dedicated Composer version).
• phpMussel/Examples – Prebuilt examples for phpMussel (useful for users which don't want to use Composer to install phpMussel).
• phpMussel/plugin-boilerplates – This repository contains boilerplate code which can be used to create new plugins for phpMussel.
• phpMussel/Plugin-PHPMailer – Provides 2FA and email notifications support for phpMussel v3+.
• CONTRIBUTING.md – Contribution guidelines.

Last Updated: 1 July 2024 (2024.07.01).