fix(ticket): flatten TicketRepository traits to PSR-4-visible paths
TicketRepository fatalled on /user/tickets/ with "Trait AKSRT\Ticket\TicketQuery not found". src/ classes load only via Composer PSR-4 (AKSRT\ => src/) — there is no bootstrap require list for them — so the autoloader resolved the traits by namespace to src/Ticket/TicketQuery.php and src/Ticket/TicketStatus.php. Both files actually sat in src/Ticket/TicketRepository-traits/, one level deeper, and were therefore invisible: PHP hit the `use` statement with no trait declared and died the moment the repository compiled. The nested directory name imitated the old inc/classes/**/*-traits/ layout, which only worked because inc/bootstrap.php carried an explicit require_once for every one of those files. No such mechanism exists under src/. Move both traits up to sit flat as siblings of the class that uses them — the same shape as GlobalControllerPart1, ModerationPart1 and the rest of src/. No code changes inside the traits; their namespace was already correct. Add tools/audit-psr4-paths.php, which checks every symbol under src/ against the path Composer maps it to and exits 1 on mismatch. It flags this exact layout, so the nesting cannot come back unnoticed. Document it in CLAUDE.md next to the existing admin-contract audit. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
This commit is contained in:
1 parent
dbb7de41e9
commit
ffd8d7d1b7
4 files changed
+78
No files matched your search
File renamed without changes.
@@ -133,6 +133,8 @@ final class TicketRepository {
|
||||
|
||||
/* ------------------------------------------------------------------ *
|
||||
* 状态机(对外入口,内部规则在 TicketStatus trait)
|
||||
*
|
||||
* Trait 必须与宿主类同级平铺:PSR-4 按命名空间寻址,不解析子目录。
|
||||
* ------------------------------------------------------------------ */
|
||||
|
||||
/**
|
||||
|
||||
File renamed without changes.
@@ -0,0 +1,76 @@
|
||||
<?php
|
||||
/**
|
||||
* PSR-4 path audit — every symbol under src/ must sit at the path Composer maps.
|
||||
*
|
||||
* Catches the fatal "Trait ... not found" class of bug: a trait (or class) nested
|
||||
* in a `*-traits/` subdirectory is invisible to PSR-4, which resolves by
|
||||
* namespace alone and never scans subdirectories. src/ classes load via
|
||||
* `AKSRT\ => src/` (composer.json) — no bootstrap require list — so a misplaced
|
||||
* file loads nowhere and fatals the moment its host class compiles.
|
||||
*
|
||||
* Usage (from theme root):
|
||||
* php tools/audit-psr4-paths.php
|
||||
*
|
||||
* Exit 1 on hard errors.
|
||||
*/
|
||||
|
||||
declare(strict_types=1);
|
||||
|
||||
$themeRoot = dirname(__DIR__);
|
||||
$srcRoot = $themeRoot . '/src';
|
||||
$prefix = 'AKSRT';
|
||||
|
||||
$rii = new RecursiveIteratorIterator(
|
||||
new RecursiveDirectoryIterator($srcRoot, FilesystemIterator::SKIP_DOTS)
|
||||
);
|
||||
|
||||
$files = [];
|
||||
foreach ($rii as $file) {
|
||||
if ($file->isFile() && strtolower($file->getExtension()) === 'php') {
|
||||
$files[] = $file->getPathname();
|
||||
}
|
||||
}
|
||||
sort($files);
|
||||
|
||||
$problems = [];
|
||||
foreach ($files as $path) {
|
||||
$src = (string) file_get_contents($path);
|
||||
|
||||
if (!preg_match('/^\s*namespace\s+([^;]+);/m', $src, $nsMatch)) {
|
||||
continue;
|
||||
}
|
||||
$namespace = trim($nsMatch[1]);
|
||||
if (!str_starts_with($namespace, $prefix . '\\')) {
|
||||
continue;
|
||||
}
|
||||
|
||||
if (!preg_match('/^\s*(?:final\s+|abstract\s+|readonly\s+)*(?:class|interface|trait|enum)\s+(\w+)/m', $src, $symMatch)) {
|
||||
continue;
|
||||
}
|
||||
$symbol = $symMatch[1];
|
||||
|
||||
$relative = str_replace('\\', '/', substr($namespace, strlen($prefix)));
|
||||
$expected = str_replace('//', '/', $srcRoot . $relative . '/' . $symbol . '.php');
|
||||
|
||||
if (realpath($expected) !== realpath($path)) {
|
||||
$problems[] = sprintf(
|
||||
"%s declares %s\\%s -> expected %s",
|
||||
str_replace('\\', '/', substr($path, strlen($srcRoot) + 1)),
|
||||
$namespace,
|
||||
$symbol,
|
||||
str_replace('\\', '/', substr($expected, strlen($srcRoot) + 1))
|
||||
);
|
||||
}
|
||||
}
|
||||
|
||||
foreach ($problems as $problem) {
|
||||
fwrite(STDERR, '[error] ' . $problem . PHP_EOL);
|
||||
}
|
||||
fwrite(STDERR, sprintf(
|
||||
'scanned=%d errors=%d%s',
|
||||
count($files),
|
||||
count($problems),
|
||||
PHP_EOL
|
||||
));
|
||||
|
||||
exit($problems === [] ? 0 : 1);
|
||||
Reference in new issue
Block a user