Ubuntu

contains($cacheId)) { /** @var Capability[] $capabilities */ $capabilities = []; /** * Triggered to add new capabilities. * * **Example** * * public function addCapabilities(&$capabilities) * { * $capabilities[] = new MyNewCapability(); * } * * @param Capability[] $reports An array of reports * @internal */ Piwik::postEvent('Access.Capability.addCapabilities', array(&$capabilities)); /** * Triggered to filter / restrict capabilities. * * **Example** * * public function filterCapabilities(&$capabilities) * { * foreach ($capabilities as $index => $capability) { * if ($capability->getId() === 'tagmanager_write') {} * unset($capabilities[$index]); // remove the given capability * } * } * } * * @param Capability[] $reports An array of reports * @internal */ Piwik::postEvent('Access.Capability.filterCapabilities', array(&$capabilities)); $capabilities = \array_values($capabilities); $this->checkCapabilityIds($capabilities); $cache->save($cacheId, $capabilities); return $capabilities; } /** @var Capability[] */ return $cache->fetch($cacheId); } /** * @throws Exception */ public function getCapability(string $capabilityId) : ?\Piwik\Access\Capability { foreach ($this->getAllCapabilities() as $capability) { if ($capabilityId === $capability->getId()) { return $capability; } } return null; } /** * @return string[] * @throws Exception */ public function getAllCapabilityIds() : array { $ids = array(); foreach ($this->getAllCapabilities() as $capability) { $ids[] = $capability->getId(); } return $ids; } /** * @throws Exception */ public function isValidCapability(string $capabilityId) : bool { $capabilities = $this->getAllCapabilityIds(); return \in_array($capabilityId, $capabilities, \true); } /** * @throws Exception */ public function checkValidCapability(string $capabilityId) : void { if (!$this->isValidCapability($capabilityId)) { $capabilities = $this->getAllCapabilityIds(); throw new \Exception(Piwik::translate("UsersManager_ExceptionAccessValues", implode(", ", $capabilities))); } } /** * @param Capability[] $capabilities * @throws Exception */ private function checkCapabilityIds(array $capabilities) : void { foreach ($capabilities as $capability) { $id = $capability->getId(); if (preg_match('/[^a-zA-Z0-9_-]/', $id)) { throw new \Exception("Capability with invalid ID found: '{$id}'. Valid characters are 'a-zA-Z0-9_-'."); } } } }