base_test.php

См. документацию.

<?php

abstract class CSecurityBaseTest
{
    const STATUS_FAILED = "failed";
    const STATUS_PASSED = "passed";
 
    protected $internalName = "BaseTest";
    protected $isDebug = false;
    protected $params = array();
    protected $tests = array();
    protected $detailErrors = array();

    public function getName()
    {
        return GetMessage("SECURITY_SITE_CHECKER_".$this->getInternalName()."_NAME");
    }

    public function checkRequirements($params = array())
    {
        return true;
    }

    public function check(array $params = array())
    {
        $this->initializeParams($params);
        $neededTests = self::getParam("needed_tests", null);
        if(is_string($neededTests) && $neededTests)
        {
            $neededTests = array($neededTests);
        }
 
        foreach($this->tests as $name => $test)
        {
            if($neededTests && !empty($neededTests) && !in_array($name, $neededTests, true))
                continue;
 
            if(isset($test["params"]) && is_array($test["params"]))
            {
                $testParams = $test["params"];
            }
            else
            {
                $testParams = array();
            }
 
            $result = call_user_func_array(array($this, $test["method"]), $testParams);
            if($result === self::STATUS_FAILED || $result === false)
            {
                if(isset($test["base_message_key"]) && $test["base_message_key"])
                {
                    if(isset($test["critical"]) && $test["critical"])
                    {
                        $critical = $test["critical"];
                    }
                    else
                    {
                        $critical = CSecurityCriticalLevel::LOW;
                    }
 
                    $this->addUnformattedDetailError($test["base_message_key"], $critical);
                }
            }
        }
 
 
        $result = array(
            'name' => $this->getName(),
            'problem_count' => count($this->getDetailErrors()),
            'errors' => $this->getDetailErrors(),
            'status' => !count($this->getDetailErrors())
        );
 
        return $result;
    }

    public function getInternalName()
    {
        return $this->internalName;
    }

    protected function initializeParams(array $params = array())
    {
        if(is_array($params) && !empty($params))
        {
            $this->params = $params;
        }
        $this->isDebug = (self::getParam("debug", false) === true);
    }

    protected function isRunOnWin()
    {
        return (mb_strtoupper(mb_substr(PHP_OS, 0, 3)) === "WIN");
    }

    protected static function getFilePerm($path)
    {
        if(!(is_dir($path) || is_file($path)))
            return false;
 
        return fileperms($path);
    }

    protected static function isWorldWritable($path)
    {
        return (self::getFilePerm($path) & 0x0002) > 0;
    }

    protected static function isWorldReadable($path)
    {
        return (self::getFilePerm($path) & 0x0004) > 0;
    }

    protected static function isWorldAccessible($path)
    {
        $perms = self::getFilePerm($path);
        return ($perms & 0x0004 > 0) || ($perms & 0x0002 > 0);
    }

    protected function getParam($name, $defaultValue = "")
    {
        if(isset($this->params[$name]))
        {
            return $this->params[$name];
        }
        else
        {
            return $defaultValue;
        }
    }

    protected function isDebug()
    {
        return $this->isDebug;
    }

    protected function getDetailErrors()
    {
        return $this->detailErrors;
    }

    protected static function getDetailText($baseMessageKey, array $placeholders = array())
    {
        return GetMessage($baseMessageKey."_DETAIL", $placeholders);
    }

    protected static function getRecommendationText($baseMessageKey, array $placeholders = array())
    {
        return GetMessage($baseMessageKey."_RECOMMENDATION", $placeholders);
    }

    protected static function getTitleText($baseMessageKey, array $placeholders = array())
    {
        return GetMessage($baseMessageKey, $placeholders);
    }

    protected function addDetailError($title, $critical, $detail, $recommendation = "", $additionalInfo = "")
    {
        $detailError = array(
            "title" => $title,
            "critical" => $critical,
            "detail" => $detail,
            "recommendation" => $recommendation,
            "additional_info" => $additionalInfo
        );
        $this->pushDetailError($detailError);
    }

    private function pushDetailError(array $error)
    {
        if(is_array($error) && !empty($error))
        {
            array_push($this->detailErrors, $error);
        }
        return $this;
    }

    protected function addUnformattedDetailError($baseMessageKey, $critical, $additionalInfo = "")
    {
        $detailError = self::formatDetailError($baseMessageKey, $critical, $additionalInfo);
        $this->pushDetailError($detailError);
        return $this;
    }

    protected static function formatDetailError($baseMessageKey, $critical, $additionalInfo = "")
    {
        return array(
                "title" => self::getTitleText($baseMessageKey),
                "critical" => $critical,
                "detail" => self::getDetailText($baseMessageKey),
                "recommendation" => self::getRecommendationText($baseMessageKey),
                "additional_info" => $additionalInfo
            );
    }

    protected static function removeDocumentRoot($path)
    {
        $path = removeDocRoot($path);
        return $path;
    }
}