fileManager = $fileManager; $this->dataCache = $dataCache; $this->resourceReader = $resourceReader; $this->useCache = $useCache; $this->module = new Module($this->fileManager, $this->dataCache, $useCache); } private function getMetadataHelper(): Helper { if (!isset($this->metadataHelper)) { $this->metadataHelper = new Helper($this); } return $this->metadataHelper; } /** * Init metadata. */ public function init(bool $reload = false): void { if (!$this->useCache) { $reload = true; } if ($this->dataCache->has($this->cacheKey) && !$reload) { $this->data = $this->dataCache->get($this->cacheKey); return; } $this->clearVars(); $objData = $this->getAllObjects(false, $reload); $this->data = Util::objectToArray($objData); if ($this->useCache) { $this->dataCache->store($this->cacheKey, $this->data); } } /** * Get metadata array. * * @return array */ private function getData(): array { if (empty($this->data) || !is_array($this->data)) { $this->init(); } return $this->data; } /** * Get metadata by key. * * @param mixed string|array $key * @param mixed $default * * @return mixed */ public function get($key = null, $default = null) { $result = Util::getValueByKey($this->getData(), $key, $default); return $result; } /** * Get all metadata. * * @param $isJSON * @param bool $reload * * @return json|array */ public function getAll(bool $isJSON = false, bool $reload = false) { if ($reload) { $this->init($reload); } if ($isJSON) { return Json::encode($this->data); } return $this->data; } private function objInit(bool $reload = false): void { if (!$this->useCache) { $reload = true; } if ($this->dataCache->has($this->objCacheKey) && !$reload) { $this->objData = $this->dataCache->get($this->objCacheKey); return; } $this->objData = $this->resourceReader->read('metadata', ResourceReaderParams::create()); $this->objData = $this->addAdditionalFieldsObj($this->objData); if ($this->useCache) { $this->dataCache->store($this->objCacheKey, $this->objData); } } private function getObjData(bool $reload = false): object { if (!isset($this->objData) || $reload) { $this->objInit($reload); } return $this->objData; } /** * Get metadata with StdClass items. * * @param mixed string|array $key * @param mixed $default * * @return mixed */ public function getObjects($key = null, $default = null) { $objData = $this->getObjData(); return Util::getValueByKey($objData, $key, $default); } public function getAllObjects($isJSON = false, $reload = false) { $objData = $this->getObjData($reload); if ($isJSON) { return Json::encode($objData); } return $objData; } public function getAllForFrontend(): object { $data = $this->getAllObjects(); $frontendHiddenPathList = $this->get(['app', 'metadata', 'frontendHiddenPathList'], []); foreach ($frontendHiddenPathList as $row) { $this->removeDataByPath($row, $data); } return $data; } private function removeDataByPath($row, &$data): void { $p = &$data; $path = [&$p]; foreach ($row as $i => $item) { if (is_array($item)) { break; } if ($item === '__ANY__') { foreach (get_object_vars($p) as &$v) { $this->removeDataByPath( array_slice($row, $i + 1), $v ); } return; } if (!property_exists($p, $item)) { break; } if ($i == count($row) - 1) { unset($p->$item); $o = &$p; for ($j = $i - 1; $j > 0; $j--) { if (is_object($o) && !count(get_object_vars($o))) { $o = &$path[$j]; $k = $row[$j]; unset($o->$k); } else { break; } } } else { $p = &$p->$item; $path[] = &$p; } } } private function addAdditionalFieldsObj($data) { if (!isset($data->entityDefs)) { return $data; } $fieldDefinitionList = Util::objectToArray($data->fields); foreach (get_object_vars($data->entityDefs) as $entityType => $entityDefsItem) { if (isset($data->entityDefs->$entityType->collection)) { $collectionItem = $data->entityDefs->$entityType->collection; if (isset($collectionItem->orderBy)) { $collectionItem->sortBy = $collectionItem->orderBy; } else if (isset($collectionItem->sortBy)) { $collectionItem->orderBy = $collectionItem->sortBy; } if (isset($collectionItem->order)) { $collectionItem->asc = $collectionItem->order === 'asc' ? true : false; } else if (isset($collectionItem->asc)) { $collectionItem->order = $collectionItem->asc === true ? 'asc' : 'desc'; } } if (!isset($entityDefsItem->fields)) { continue; } foreach (get_object_vars($entityDefsItem->fields) as $field => $fieldDefsItem) { $additionalFields = $this->getMetadataHelper()->getAdditionalFieldList( $field, Util::objectToArray($fieldDefsItem), $fieldDefinitionList ); if (!$additionalFields) { continue; } foreach ($additionalFields as $subFieldName => $subFieldParams) { if (isset($entityDefsItem->fields->$subFieldName)) { $data->entityDefs->$entityType->fields->$subFieldName = DataUtil::merge( Util::arrayToObject($subFieldParams), $entityDefsItem->fields->$subFieldName ); } else { $data->entityDefs->$entityType->fields->$subFieldName = Util::arrayToObject($subFieldParams); } } } } return $data; } /** * Get metadata definition in custom directory. * * @param string|array $key * @param mixed $default * * @return object */ public function getCustom($key1, $key2, $default = null) { $filePath = $this->customPath . "/{$key1}/{$key2}.json"; $fileContent = $this->fileManager->getContents($filePath); if ($fileContent) { return Json::decode($fileContent); } return $default; } /** * Set and save metadata in custom directory. * The data is not merging with existing data. Use getCustom() to get existing data. * * @param string $key1 * @param string $key2 * @param array|object $data */ public function saveCustom(string $key1, string $key2, $data): void { if (is_object($data)) { foreach ($data as $key => $item) { if ($item == new StdClass()) { unset($data->$key); } } } $filePath = $this->customPath . "/{$key1}/{$key2}.json"; $changedData = Json::encode($data, JSON_PRETTY_PRINT | JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES); $this->fileManager->putContents($filePath, $changedData); $this->init(true); } /** * Set Metadata data. */ public function set(string $key1, string $key2, $data): void { if (is_array($data)) { foreach ($data as $key => $item) { if (is_array($item) && empty($item)) { unset($data[$key]); } } } $newData = [ $key1 => [ $key2 => $data, ], ]; $this->changedData = Util::merge($this->changedData, $newData); $this->data = Util::merge($this->getData(), $newData); $this->undelete($key1, $key2, $data); } /** * Unset some fields and other stuff in metadata. * * @param array|string $unsets Example: `fields.name`. */ public function delete(string $key1, string $key2, $unsets = null): void { if (!is_array($unsets)) { $unsets = (array) $unsets; } switch ($key1) { case 'entityDefs': //unset related additional fields, e.g. a field with "address" type $fieldDefinitionList = $this->get('fields'); $unsetList = $unsets; foreach ($unsetList as $unsetItem) { if (preg_match('/fields\.([^\.]+)/', $unsetItem, $matches) && isset($matches[1])) { $fieldName = $matches[1]; $fieldPath = [$key1, $key2, 'fields', $fieldName]; $additionalFields = $this->getMetadataHelper()->getAdditionalFieldList( $fieldName, $this->get($fieldPath, []), $fieldDefinitionList ); if (is_array($additionalFields)) { foreach ($additionalFields as $additionalFieldName => $additionalFieldParams) { $unsets[] = 'fields.' . $additionalFieldName; } } } } break; } $normalizedData = [ '__APPEND__', ]; $metadataUnsetData = []; foreach ($unsets as $unsetItem) { $normalizedData[] = $unsetItem; $metadataUnsetData[] = implode('.', [$key1, $key2, $unsetItem]); } $unsetData = [ $key1 => [ $key2 => $normalizedData ] ]; $this->deletedData = Util::merge($this->deletedData, $unsetData); $this->deletedData = Util::unsetInArrayByValue('__APPEND__', $this->deletedData, true); $this->data = Util::unsetInArray($this->getData(), $metadataUnsetData, true); } private function undelete($key1, $key2, $data): void { if (isset($this->deletedData[$key1][$key2])) { foreach ($this->deletedData[$key1][$key2] as $unsetIndex => $unsetItem) { $value = Util::getValueByKey($data, $unsetItem); if (isset($value)) { unset($this->deletedData[$key1][$key2][$unsetIndex]); } } } } /** * Clear not saved changes. */ public function clearChanges(): void { $this->changedData = []; $this->deletedData = []; $this->init(true); } /** * Save changes. */ public function save(): bool { $path = $this->customPath; $result = true; if (!empty($this->changedData)) { foreach ($this->changedData as $key1 => $keyData) { foreach ($keyData as $key2 => $data) { if (empty($data)) { continue; } $filePath = $path . "/{$key1}/{$key2}.json"; $result &= $this->fileManager->mergeJsonContents($filePath, $data); } } } if (!empty($this->deletedData)) { foreach ($this->deletedData as $key1 => $keyData) { foreach ($keyData as $key2 => $unsetData) { if (empty($unsetData)) { continue; } $filePath = $path . "/{$key1}/{$key2}.json"; $rowResult = $this->fileManager->unsetJsonContents($filePath, $unsetData); if (!$rowResult) { throw new Error( "Metadata items {$key1}.{$key2} can be deleted for custom code only." ); } $result &= $rowResult; } } } if (!$result) { throw new Error("Error while saving metadata. See log file for details."); } $this->clearChanges(); return (bool) $result; } private function loadModuleList(): void { $this->moduleList = $this->module->getOrderedList(); } /** * Get a module list. * * @return string[] */ public function getModuleList(): array { if (!isset($this->moduleList)) { $this->loadModuleList(); } return $this->moduleList; } /** * Get a module name a scope belongs to. */ public function getScopeModuleName(string $scopeName): ?string { return $this->get(['scopes', $scopeName, 'module']); } private function clearVars(): void { $this->data = null; $this->moduleList = null; } }