N°7506 - Add method to check if a specific module is installed in iTop

core/restclient.class.inc.php

@@ -204,4 +204,31 @@ public static function GetFullSynchroDataSource(&$aSource, $iSourceId)
 
 		return $bResult;
 	}
+
+	/**
+	 * Check if the given module is installed in iTop
+	 * @param string $sName Name of the module to be found
+	 * @param bool $bRequired Whether to throw exceptions when module not found
+	 * @return bool True when the given module is installed, false otherwise
+	 * @throws Exception When the module is required but could not be found
+	 */
+	public function CheckModuleInstallation(string $sName, bool $bRequired = false): bool
+	{
+		try {
+			$aResults = static::Get('ModuleInstallation', ['name' => $sName], 'name,version');
+			if ($aResults['code'] != 0 || empty($aResults['objects'])) {
+				throw new Exception($aResults['message'], $aResults['code']);
+			}
+			$aObject = current($aResults['objects']);
+			Utils::Log(LOG_DEBUG, sprintf('iTop module %s version %s is installed.', $aObject['fields']['name'], $aObject['fields']['version']));
+		} catch (Exception $e) {
+			$sMessage = sprintf('%s iTop module %s is considered as not installed due to: %s', $bRequired ? 'Required' : 'Optional', $sName, $e->getMessage());
+			if ($bRequired) throw new Exception($sMessage, 0, $e);
+			else {
+				Utils::Log(LOG_INFO, $sMessage);
+				return false;
+			}
+		}
+		return true;
+	}
 }