classes/class.ilVirusScanner.php

Go to the documentation of this file.

<?php
/*
        +-----------------------------------------------------------------------------+
        | ILIAS open source                                                           |
        +-----------------------------------------------------------------------------+
        | Copyright (c) 1998-2001 ILIAS open source, University of Cologne            |
        |                                                                             |
        | This program is free software; you can redistribute it and/or               |
        | modify it under the terms of the GNU General Public License                 |
        | as published by the Free Software Foundation; either version 2              |
        | of the License, or (at your option) any later version.                      |
        |                                                                             |
        | This program is distributed in the hope that it will be useful,             |
        | but WITHOUT ANY WARRANTY; without even the implied warranty of              |
        | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the               |
        | GNU General Public License for more details.                                |
        |                                                                             |
        | You should have received a copy of the GNU General Public License           |
        | along with this program; if not, write to the Free Software                 |
        | Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA. |
        +-----------------------------------------------------------------------------+
*/


class ilVirusScanner
{
        var $type;
        
        var $scanZipFiles;

        var $scanCommand;

        var $cleanCommand;

        var $scanFilePath;

        var $scanFileOrigName;

        var $cleanFilePath;

        var $cleanFileOrigName;

        var $scanFileIsInfected;

        var $cleanFileIsCleaned;

        var $scanResult;
        
        var $cleanResult;
        
        var $ilias;

        var $lng;

        var $log;

        function ilVirusScanner($a_scancommand, $a_cleancommand)
        {
                global $ilias, $lng, $log;

                $this->ilias = & $ilias;
                $this->lng = & $lng;
                $this->log = & $log;
                $this->scanCommand = $a_scancommand;
                $this->cleanCommand = $a_cleancommand;
                
                $this->type = "simulate";
                $this->scanZipFiles = false;
        }

        function scanFile($a_filepath, $a_origname = "")
        {
                // This function needs to be redefined in child classes.
                // It should:
                // - call the external scanner for a_filepath
                // - set scanFilePath to a_filepath
                // - set scanFileOrigName to a_origname
                // - set scanFileIsInfected according the scan result
                // - set scanResult to the scanner output message
                // - call logScanResult() if file is infected
                // - return the output message, if file is infected
                // - return an empty string, if file is not infected
                
                $this->scanFilePath = $a_filepath;
                $this->scanFileOrigName = $a_origname;
                
                if ($a_origname == "infected.txt" or $a_origname == "cleanable.txt")
                {
                        $this->scanFileIsInfected = true;
                        $this->scanResult =
                                "FILE INFECTED: [". $a_filepath. "] (VIRUS: simulated)";
                        $this->logScanResult();
                        return $this->scanResult;
                }
                else
                {
                        $this->scanFileIsInfected = false;
                        $this->scanResult = "";
                        return "";
                }
        }
        
        
        function cleanFile($a_filepath, $a_origname = "")
        {
                // This function needs to be redefined in child classes
                // It should:
                // - call the external cleaner
                // - set cleanFilePath to a_filepath
                // - set cleanFileOrigName to a_origname
                // - set cleanFileIsCleaned according the clean result
                // - set cleanResult to the cleaner output message
                // - call logCleanResult in any case
                // - return the output message, if file is cleaned
                // - return an empty string, if file is not cleaned

                $this->cleanFilePath = $a_filepath;
                $this->cleanFileOrigName = $a_origname;

                if ($a_origname == "cleanable.txt")
                {
                        $this->cleanFileIsCleaned = true;
                        $this->cleanResult =
                                "FILE CLEANED: [". $a_filepath. "] (VIRUS: simulated)";
                        $this->logCleanResult();
                        return $this->cleanResult;
                }
                else
                {
                        $this->cleanFileIsCleaned = false;
                        $this->cleanResult =
                                "FILE NOT CLEANED: [". $a_filepath. "] (VIRUS: simulated)";
                        $this->logCleanResult();
                        return "";
                }
        }
        
        function fileCleaned()
        {
                return $this->cleanFileIsCleaned;
        }
        
        function logScanResult()
        {
                $mess = "Virus Scanner (". $this->type. ")";
                if ($this->scanFileOrigName)
                {
                        $mess .= " (File " . $this->scanFileOrigName . ")";
                }
                $mess .= ": " . ereg_replace("(\r|\n)+", "; ", $this->scanResult);

                $this->log->write($mess);
        }
        
        function logCleanResult()
        {
                $mess = "Virus Cleaner (". $this->type. ")";
                if ($this->cleanFileOrigName)
                {
                        $mess .= " (File ". $this->cleanFileOrigName. ")";
                }
                $mess .= ": " . ereg_replace("(\r|\n)+", "; ", $this->cleanResult);

                $this->log->write($mess);
        }

        function getScanResult()
        {
                return $this->scanResult;
        }
        
        function getCleanResult()
        {
                return $this->cleanResult;
        }

        function getScanMessage()
        {
                if ($this->scanFileIsInfected)
                {
                        $ret = sprintf($this->lng->txt("virus_infected"), $this->scanFileOrigName);
                }
                else
                {
                        $ret = sprintf($this->lng->txt("virus_not_infected"),$this->scanFileOrigName);
                }
                
                if ($this->scanResult)
                {
                        $ret .= " ". $this->lng->txt("virus_scan_message")
                                 . "<br />"
                                 . str_replace($this->scanFilePath, $this->scanFileOrigName,
                                                                nl2br($this->scanResult));
                }
                return $ret;
        }

        function getCleanMessage()
        {
                if ($this->cleanFileIsCleaned)
                {
                        $ret = sprintf($this->lng->txt("virus_cleaned"), $this->cleanFileOrigName);
                }
                else
                {
                        $ret = sprintf($this->lng->txt("virus_not_cleaned"),$this->cleanFileOrigName);
                }

                if ($this->cleanResult)
                {
                        $ret .= " ". $this->lng->txt("virus_clean_message")
                                 . "<br />"
                                 . str_replace($this->cleanFilePath, $this->cleanFileOrigName,
                                                                nl2br($this->cleanResult));
                }
                return $ret;
        }
        
        function getScanZipFiles()
        {
                return $this->scanZipFiles;
        }
}
?>