|null $forms associated_forms entries ("formId[:path[:before|after]]") * @param list|null $grids associated_grids entries ("gridId[:columnId[:before|after]]") * @param list|null $apis associated_apis entries ("uriPath[:METHOD[,METHOD...]]") * * @return list translated warnings (empty when every target exists) */ public function check(?array $forms, ?array $grids, ?array $apis): array { return array_merge( $this->checkForms($forms ?? []), $this->checkGrids($grids ?? []), $this->checkApis($apis ?? []) ); } /** * @param list $entries * * @return list */ private function checkForms(array $entries): array { $warnings = []; foreach ($entries as $entry) { $formId = AssociationEntryParser::parseFormEntry($entry)['formId']; if ('' === $formId || $this->formCatalog->has($formId)) { continue; } $warnings[] = $this->translator->trans( 'No back-office form with id "%formId%" was detected — the placement will be ignored until such a form exists.', ['%formId%' => $formId], 'Admin.Advparameters.Notification' ); } return $warnings; } /** * @param list $entries * * @return list */ private function checkGrids(array $entries): array { $warnings = []; foreach ($entries as $entry) { ['gridId' => $gridId, 'columnId' => $columnId] = AssociationEntryParser::parseGridEntry($entry); if ('' === $gridId) { continue; } $grid = $this->gridCatalog->get($gridId); if (null === $grid) { $warnings[] = $this->translator->trans( 'No back-office grid with id "%gridId%" was detected — the placement will be ignored until such a grid exists.', ['%gridId%' => $gridId], 'Admin.Advparameters.Notification' ); continue; } if (null !== $columnId && !$this->gridHasColumn($grid, $columnId)) { $warnings[] = $this->translator->trans( 'The grid "%gridId%" has no column with id "%columnId%" — the extra column will be appended at the default position instead.', ['%gridId%' => $gridId, '%columnId%' => $columnId], 'Admin.Advparameters.Notification' ); } } return $warnings; } /** * @param list $entries * * @return list */ private function checkApis(array $entries): array { $warnings = []; foreach ($entries as $entry) { // Skip entries whose RAW path part is empty (e.g. ":GET"): parseApiEntry() would // normalize them to "/", which is not what the user targeted — same guard as // AssociationEntryParser::assertValidApiEntry(). $colonPos = strpos($entry, ':'); if ('' === trim(false !== $colonPos ? substr($entry, 0, $colonPos) : $entry)) { continue; } $path = AssociationEntryParser::parseApiEntry($entry)['path']; if ($this->apiEndpointCatalog->hasUriTemplate($path)) { continue; } $warnings[] = $this->translator->trans( 'No Admin API operation with URI template "%path%" was detected — the property will not be exposed until such an endpoint exists.', ['%path%' => $path], 'Admin.Advparameters.Notification' ); } return $warnings; } /** * @param array{columns: list} $grid */ private function gridHasColumn(array $grid, string $columnId): bool { foreach ($grid['columns'] as $column) { if ($column['id'] === $columnId) { return true; } } return false; } }