createForNewestSupportedVersion(); return $oParser->parse($sPhpContent); } /** * @param string $sModuleFilePath * @param \PhpParser\Node\Expr\Assign $oAssignation * * @return array|null * @throws \ModuleFileReaderException */ public function GetModuleInformationFromAddModuleCall(string $sModuleFilePath, \PhpParser\Node\Stmt\Expression $oExpression) : ?array { /** @var Assign $oAssignation */ $oAssignation = $oExpression->expr; if (false === ($oAssignation instanceof PhpParser\Node\Expr\StaticCall)) { return null; } /** @var PhpParser\Node\Expr\StaticCall $oAssignation */ if ("SetupWebPage" !== $oAssignation?->class?->name) { return null; } if ("AddModule" !== $oAssignation?->name?->name) { return null; } $aArgs = $oAssignation?->args; if (count($aArgs) != 3) { throw new ModuleFileReaderException("Not enough parameters when calling SetupWebPage::AddModule", 0, null, $sModuleFilePath); } $oModuleId = $aArgs[1]; if (false === ($oModuleId instanceof PhpParser\Node\Arg)) { throw new ModuleFileReaderException("2nd parameter to SetupWebPage::AddModule call issue: " . get_class($oModuleId), 0, null, $sModuleFilePath); } /** @var PhpParser\Node\Arg $oModuleId */ if (false === ($oModuleId->value instanceof PhpParser\Node\Scalar\String_)) { throw new ModuleFileReaderException("2nd parameter to SetupWebPage::AddModule not a string: " . get_class($oModuleId->value), 0, null, $sModuleFilePath); } $sModuleId = $oModuleId->value->value; $oModuleConfigInfo = $aArgs[2]; if (false === ($oModuleConfigInfo instanceof PhpParser\Node\Arg)) { throw new ModuleFileReaderException("3rd parameter to SetupWebPage::AddModule call issue: " . get_class($oModuleConfigInfo), 0, null, $sModuleFilePath); } /** @var PhpParser\Node\Arg $oModuleConfigInfo */ if (false === ($oModuleConfigInfo->value instanceof PhpParser\Node\Expr\Array_)) { throw new ModuleFileReaderException("3rd parameter to SetupWebPage::AddModule not an array: " . get_class($oModuleConfigInfo->value), 0, null, $sModuleFilePath); } $aModuleConfig=[]; $this->FillModuleInformationFromArray($oModuleConfigInfo->value, $aModuleConfig); if (! is_array($aModuleConfig)){ throw new ModuleFileReaderException("3rd parameter to SetupWebPage::AddModule not an array: " . get_class($oModuleConfigInfo->value), 0, null, $sModuleFilePath); } return [ $sModuleFilePath, $sModuleId, $aModuleConfig, ]; } public function FillModuleInformationFromArray(PhpParser\Node\Expr\Array_ $oArray, array &$aModuleInformation) : void { $iIndex=0; /** @var \PhpParser\Node\Expr\ArrayItem $oValue */ foreach ($oArray->items as $oArrayItem){ if ($oArrayItem->key instanceof PhpParser\Node\Scalar\String_) { //dictionnary $sKey = $oArrayItem->key->value; } else if ($oArrayItem->key instanceof \PhpParser\Node\Expr\ConstFetch) { //dictionnary $sKey = $this->EvaluateConstantExpression($oArrayItem->key); if (is_null($sKey)){ continue; } } else { //array $sKey = $iIndex++; } $oValue = $oArrayItem->value; if ($oValue instanceof PhpParser\Node\Expr\Array_) { $aSubConfig=[]; $this->FillModuleInformationFromArray($oValue, $aSubConfig); $aModuleInformation[$sKey]=$aSubConfig; continue; } try { $oEvaluatuedValue = $this->EvaluateExpression($oValue); } catch(ModuleFileReaderException $e){ //required to support legacy below dump dependency //'dependencies' => ['itop-config-mgmt/2.0.0'||'itop-structure/3.0.0'] continue; } $aModuleInformation[$sKey]=$oEvaluatuedValue; } } /** * @param string $sModuleFilePath * @param \PhpParser\Node\Stmt\If_ $oNode * * @return array|null * @throws \ModuleFileReaderException */ public function GetModuleInformationFromIf(string $sModuleFilePath, \PhpParser\Node\Stmt\If_ $oNode) : ?array { $bCondition = $this->EvaluateExpression($oNode->cond); if ($bCondition) { foreach ($oNode->stmts as $oSubNode) { if ($oSubNode instanceof \PhpParser\Node\Stmt\Expression) { $aModuleConfig = $this->GetModuleInformationFromAddModuleCall($sModuleFilePath, $oSubNode); if (!is_null($aModuleConfig)) { return $aModuleConfig; } } } return null; } if (! is_null($oNode->elseifs)) { foreach ($oNode->elseifs as $oElseIfSubNode) { /** @var \PhpParser\Node\Stmt\ElseIf_ $oElseIfSubNode */ $bCondition = $this->EvaluateExpression($oElseIfSubNode->cond); if ($bCondition) { return $this->GetModuleConfigurationFromStatement($sModuleFilePath, $oElseIfSubNode->stmts); } } } if (! is_null($oNode->else)) { return $this->GetModuleConfigurationFromStatement($sModuleFilePath, $oNode->else->stmts); } return null; } public function GetModuleConfigurationFromStatement(string $sModuleFilePath, array $aStmts) : ?array { foreach ($aStmts as $oSubNode) { if ($oSubNode instanceof \PhpParser\Node\Stmt\Expression) { $aModuleConfig = $this->GetModuleInformationFromAddModuleCall($sModuleFilePath, $oSubNode); if (!is_null($aModuleConfig)) { return $aModuleConfig; } } } return null; } public function EvaluateConstantExpression(\PhpParser\Node\Expr\ArrayItem|\PhpParser\Node\Expr\ConstFetch $oValue) : mixed { return $this->UnprotectedComputeBooleanExpression($oValue->name); } public function EvaluateClassConstantExpression(\PhpParser\Node\Expr\ClassConstFetch $oValue) : mixed { $sClassName = $oValue->class->name; $sProperty = $oValue->name->name; if (class_exists($sClassName)){ $class = new \ReflectionClass($sClassName); if (array_key_exists($sProperty, $class->getConstants())) { $oReflectionConstant = $class->getReflectionConstant($sProperty); if ($oReflectionConstant->isPublic()){ return $class->getConstant($sProperty); } } } if ('class' === $sProperty){ return $sClassName; } return null; } public function EvaluateStaticPropertyExpression(\PhpParser\Node\Expr\StaticPropertyFetch $oValue) : mixed { $sClassName = $oValue->class->name; $sProperty = $oValue->name->name; if (class_exists($sClassName)){ $class = new \ReflectionClass($sClassName); if (array_key_exists($sProperty, $class->getStaticProperties())) { $oReflectionProperty = $class->getProperty($sProperty); if ($oReflectionProperty->isPublic()){ return $class->getStaticPropertyValue($sProperty); } } } return null; } /** * @param string $sBooleanExpr * * @return mixed * @throws ModuleFileReaderException */ private function UnprotectedComputeBooleanExpression(string $sBooleanExpr) : mixed { try{ $bResult = null; @eval('$bResult = '.$sBooleanExpr.';'); return $bResult; } catch (Throwable $t) { throw new ModuleFileReaderException("Eval of '$sBooleanExpr' caused an error: ".$t->getMessage()); } } /** * @param string $sBooleanExpr * * @return bool * @throws ModuleFileReaderException */ public function EvaluateBooleanExpression(string $sBooleanExpr) : bool { $sPhpContent = <<ParsePhpCode($sPhpContent); $oExpr = $aNodes[0]; $oRes = $this->EvaluateExpression($oExpr->expr); return (bool) $oRes; } catch (Throwable $t) { throw new ModuleFileReaderException("Eval of '$sBooleanExpr' caused an error:".$t->getMessage()); } } private function GetMixedValueToString(mixed $oExpr) : string { if (false === $oExpr){ return "false"; } if (true === $oExpr){ return "true"; } return $oExpr; } private function EvaluateExpression(\PhpParser\Node\Expr $oExpression) : mixed { if ($oExpression instanceof \PhpParser\Node\Expr\BinaryOp){ $sExpr = sprintf("%s %s %s", $this->GetMixedValueToString($this->EvaluateExpression($oExpression->left)), $oExpression->getOperatorSigil(), $this->GetMixedValueToString($this->EvaluateExpression($oExpression->right)) ); //return $this->UnprotectedComputeBooleanExpression($sBooleanExpr);; return $this->UnprotectedComputeBooleanExpression($sExpr); } if ($oExpression instanceof \PhpParser\Node\Expr\BooleanNot){ return ! $this->EvaluateExpression($oExpression->expr); } if ($oExpression instanceof \PhpParser\Node\Expr\FuncCall){ return $this->EvaluateCallFunction($oExpression); } if ($oExpression instanceof \PhpParser\Node\Expr\StaticCall){ return $this->EvaluateStaticCallFunction($oExpression); } if ($oExpression instanceof \PhpParser\Node\Expr\ConstFetch){ return $this->EvaluateConstantExpression($oExpression); } if ($oExpression instanceof \PhpParser\Node\Expr\ClassConstFetch) { return $this->EvaluateClassConstantExpression($oExpression); } if ($oExpression instanceof \PhpParser\Node\Expr\StaticPropertyFetch) { return $this->EvaluateStaticPropertyExpression($oExpression); } return $oExpression->value; } private function EvaluateCallFunction(\PhpParser\Node\Expr\FuncCall $oFunct) : mixed { $sFunction = $oFunct->name->name; $aWhiteList = ["function_exists", "class_exists", "method_exists"]; if (! in_array($sFunction, $aWhiteList)){ throw new ModuleFileReaderException("FuncCall $sFunction not supported"); } $aArgs=[]; foreach ($oFunct->args as $arg){ /** @var \PhpParser\Node\Arg $arg */ $aArgs[]=$arg->value->value; } $oReflectionFunction = new ReflectionFunction($sFunction); return $oReflectionFunction->invoke(...$aArgs); } /** * @param \PhpParser\Node\Expr\StaticCall $oStaticCall * * @return mixed * @throws \ModuleFileReaderException * @throws \ReflectionException */ private function EvaluateStaticCallFunction(\PhpParser\Node\Expr\StaticCall $oStaticCall) : mixed { $sClassName = $oStaticCall->class->name; $sMethodName = $oStaticCall->name->name; $aWhiteList = ["SetupInfo::ModuleIsSelected"]; $sStaticCallDescription = "$sClassName::$sMethodName"; if (! in_array($sStaticCallDescription, $aWhiteList)){ throw new ModuleFileReaderException("StaticCall $sStaticCallDescription not supported"); } $aArgs=[]; foreach ($oStaticCall->args as $arg){ /** @var \PhpParser\Node\Arg $arg */ $aArgs[]=$arg->value->value; } $class = new \ReflectionClass($sClassName); $method = $class->getMethod($sMethodName); if (! $method->isPublic()){ throw new ModuleFileReaderException("StaticCall $sStaticCallDescription not public"); } return $method->invokeArgs(null, $aArgs); } }