{
"tool_response": {
"filePath": "\/var\/www\/dev.campus.systemische-tools.de\/src\/Infrastructure\/CodeAnalysis\/PhpFileParser.php",
"oldString": "namespace Infrastructure\\CodeAnalysis;\n\n\/\/ @responsibility: PHP-Datei-Strukturanalyse via Tokenizer\n\nfinal class PhpFileParser\n{\n use TokenNavigatorTrait;\n use UseStatementExtractorTrait;\n use InheritanceExtractorTrait;\n use ClassFunctionExtractorTrait;",
"newString": "namespace Infrastructure\\CodeAnalysis;\n\n\/**\n * @responsibility PHP-Datei-Strukturanalyse via Tokenizer\n *\n * @composition Nutzt Mixin-Pattern für Separation of Concerns:\n * - TokenNavigatorTrait: Token-Stream Navigation und Positionierung\n * - UseStatementExtractorTrait: use-Statement und Import-Map Extraktion\n * - InheritanceExtractorTrait: extends\/implements\/use-Trait Analyse\n * - ClassFunctionExtractorTrait: Methoden, Properties und Constructor-Dependencies\n *\n * @see TokenNavigatorTrait\n * @see UseStatementExtractorTrait\n * @see InheritanceExtractorTrait\n * @see ClassFunctionExtractorTrait\n *\/\nfinal class PhpFileParser\n{\n use TokenNavigatorTrait;\n use UseStatementExtractorTrait;\n use InheritanceExtractorTrait;\n use ClassFunctionExtractorTrait;",
"originalFile": "<?php\n\ndeclare(strict_types=1);\n\nnamespace Infrastructure\\CodeAnalysis;\n\n\/\/ @responsibility: PHP-Datei-Strukturanalyse via Tokenizer\n\nfinal class PhpFileParser\n{\n use TokenNavigatorTrait;\n use UseStatementExtractorTrait;\n use InheritanceExtractorTrait;\n use ClassFunctionExtractorTrait;\n\n \/** @var array<string, string> Maps short name to FQCN from use statements *\/\n private array $importMap = [];\n\n \/** @var string|null Current namespace *\/\n private ?string $currentNamespace = null;\n\n \/**\n * Parst eine PHP-Datei und extrahiert Metadaten inkl. Dependencies.\n *\n * @return array{\n * namespace: string|null,\n * classes: array<array{name: string, type: string, line: int}>,\n * functions: array<array{name: string, visibility: string|null, line: int}>,\n * uses: array<string>,\n * extends_class: string|null,\n * implements_interfaces: array<string>,\n * traits_used: array<string>,\n * constructor_deps: array<string>,\n * error: string|null\n * }\n *\/\n public function parse(string $filePath): array\n {\n $this->importMap = [];\n $this->currentNamespace = null;\n\n $result = [\n 'namespace' => null,\n 'classes' => [],\n 'functions' => [],\n 'uses' => [],\n 'extends_class' => null,\n 'implements_interfaces' => [],\n 'traits_used' => [],\n 'constructor_deps' => [],\n 'error' => null,\n ];\n\n if (!file_exists($filePath) || !is_readable($filePath)) {\n $result['error'] = 'Datei nicht lesbar';\n\n return $result;\n }\n\n $content = file_get_contents($filePath);\n if ($content === false) {\n $result['error'] = 'Datei konnte nicht gelesen werden';\n\n return $result;\n }\n\n try {\n $tokens = @token_get_all($content);\n } catch (\\Throwable $e) {\n $result['error'] = 'Token-Fehler: ' . $e->getMessage();\n\n return $result;\n }\n\n \/\/ First pass: Extract namespace and use statements for resolution\n $result['namespace'] = $this->extractNamespace($tokens);\n $this->currentNamespace = $result['namespace'];\n $result['uses'] = $this->extractUseStatements($tokens);\n\n \/\/ Build import map for FQCN resolution\n foreach ($result['uses'] as $fqcn) {\n $parts = explode('\\\\', $fqcn);\n $shortName = end($parts);\n $this->importMap[$shortName] = $fqcn;\n }\n\n \/\/ Second pass: Extract structural elements\n $result['classes'] = $this->extractClasses($tokens);\n $result['functions'] = $this->extractFunctions($tokens);\n\n \/\/ Third pass: Extract dependencies requiring resolution\n $result['extends_class'] = $this->extractExtends($tokens);\n $result['implements_interfaces'] = $this->extractImplements($tokens);\n $result['traits_used'] = $this->extractTraits($tokens);\n $result['constructor_deps'] = $this->extractConstructorDeps($tokens);\n\n return $result;\n }\n\n \/**\n * @param array<mixed> $tokens\n *\/\n private function extractNamespace(array $tokens): ?string\n {\n $namespace = '';\n $capturing = false;\n\n foreach ($tokens as $token) {\n if (is_array($token)) {\n if ($token[0] === T_NAMESPACE) {\n $capturing = true;\n\n continue;\n }\n\n if ($capturing) {\n if ($token[0] === T_NAME_QUALIFIED || $token[0] === T_STRING) {\n $namespace .= $token[1];\n } elseif ($token[0] === T_NS_SEPARATOR) {\n $namespace .= '\\\\';\n }\n }\n } elseif ($capturing && ($token === ';' || $token === '{')) {\n break;\n }\n }\n\n return $namespace !== '' ? $namespace : null;\n }\n\n \/**\n * Extract constructor parameter type hints (DI dependencies).\n *\n * @param array<mixed> $tokens\n * @return array<string>\n *\/\n private function extractConstructorDeps(array $tokens): array\n {\n $deps = [];\n $count = count($tokens);\n $braceDepth = 0;\n $inClass = false;\n\n for ($i = 0; $i < $count; $i++) {\n $token = $tokens[$i];\n\n if (!is_array($token)) {\n if ($token === '{') {\n $braceDepth++;\n } elseif ($token === '}') {\n $braceDepth--;\n if ($braceDepth === 0) {\n $inClass = false;\n }\n }\n\n continue;\n }\n\n if (in_array($token[0], [T_CLASS, T_TRAIT, T_ENUM], true)) {\n $inClass = true;\n\n continue;\n }\n\n \/\/ Look for T_FUNCTION with name __construct\n if ($token[0] !== T_FUNCTION) {\n continue;\n }\n\n \/\/ Check if it's __construct\n $funcName = $this->findNextString($tokens, $i);\n if ($funcName !== '__construct') {\n continue;\n }\n\n \/\/ Find opening parenthesis\n $parenStart = null;\n for ($j = $i + 1; $j < $count; $j++) {\n if ($tokens[$j] === '(') {\n $parenStart = $j;\n\n break;\n }\n }\n\n if ($parenStart === null) {\n continue;\n }\n\n \/\/ Extract type hints from parameters\n $parenDepth = 1;\n $lastType = null;\n\n for ($j = $parenStart + 1; $j < $count && $parenDepth > 0; $j++) {\n $paramToken = $tokens[$j];\n\n if ($paramToken === '(') {\n $parenDepth++;\n\n continue;\n }\n if ($paramToken === ')') {\n $parenDepth--;\n\n continue;\n }\n\n if (!is_array($paramToken)) {\n continue;\n }\n\n \/\/ Type hint tokens (skip built-in types)\n if (in_array($paramToken[0], [T_STRING, T_NAME_QUALIFIED, T_NAME_FULLY_QUALIFIED], true)) {\n $typeName = $paramToken[1];\n\n \/\/ Skip built-in types\n if (!$this->isBuiltInType($typeName)) {\n $lastType = $typeName;\n }\n }\n\n \/\/ Variable = end of parameter, save type if found\n if ($paramToken[0] === T_VARIABLE && $lastType !== null) {\n $deps[] = $this->resolveFqcn($lastType);\n $lastType = null;\n }\n }\n\n \/\/ Only process first constructor found\n break;\n }\n\n return array_unique($deps);\n }\n\n \/**\n * Resolve a short or qualified name to FQCN.\n *\/\n private function resolveFqcn(string $name): string\n {\n \/\/ Already fully qualified\n if (str_starts_with($name, '\\\\')) {\n return ltrim($name, '\\\\');\n }\n\n \/\/ Already contains namespace separator (qualified name)\n if (str_contains($name, '\\\\')) {\n return $name;\n }\n\n \/\/ Check import map\n if (isset($this->importMap[$name])) {\n return $this->importMap[$name];\n }\n\n \/\/ Default to current namespace + name\n if ($this->currentNamespace !== null) {\n return $this->currentNamespace . '\\\\' . $name;\n }\n\n return $name;\n }\n\n \/**\n * Check if a type name is a PHP built-in type.\n *\/\n private function isBuiltInType(string $type): bool\n {\n $builtIn = [\n 'int', 'float', 'bool', 'string', 'array', 'object', 'callable',\n 'iterable', 'void', 'null', 'mixed', 'never', 'true', 'false',\n 'self', 'static', 'parent',\n ];\n\n return in_array(strtolower($type), $builtIn, true);\n }\n}\n",
"structuredPatch": [
{
"oldStart": 4,
"oldLines": 8,
"newStart": 4,
"newLines": 20,
"lines": [
" ",
" namespace Infrastructure\\CodeAnalysis;",
" ",
"-\/\/ @responsibility: PHP-Datei-Strukturanalyse via Tokenizer",
"-",
"+\/**",
"+ * @responsibility PHP-Datei-Strukturanalyse via Tokenizer",
"+ *",
"+ * @composition Nutzt Mixin-Pattern für Separation of Concerns:",
"+ * - TokenNavigatorTrait: Token-Stream Navigation und Positionierung",
"+ * - UseStatementExtractorTrait: use-Statement und Import-Map Extraktion",
"+ * - InheritanceExtractorTrait: extends\/implements\/use-Trait Analyse",
"+ * - ClassFunctionExtractorTrait: Methoden, Properties und Constructor-Dependencies",
"+ *",
"+ * @see TokenNavigatorTrait",
"+ * @see UseStatementExtractorTrait",
"+ * @see InheritanceExtractorTrait",
"+ * @see ClassFunctionExtractorTrait",
"+ *\/",
" final class PhpFileParser",
" {",
" use TokenNavigatorTrait;"
]
}
],
"userModified": false,
"replaceAll": false
}
}