README

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 bridge between phpMussel and PHPMailer, enabling phpMussel to utilise PHPMailer for two-factor authentication, email notification about blocked file uploads, etc.

composer require phpmussel/phpmailer

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));

$Web->scan();
$FrontEnd->view();

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

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).