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 the ability to utilise phpMussel as an interactive CLI-mode application.

composer require phpmussel/cli

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);
$CLI = new \phpMussel\CLI\CLI($Loader, $Scanner);

unset($CLI, $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: 30 March 2025 (2025.03.30).