Repository navigation
Blade : résoudre les vues vers le fichier réel et relier les contrôleurs #4
Description
Context
L'extracteur Blade relie les templates entre eux, mais :
- les cibles de
@extends('layouts.app')deviennent un nœudlayouts/appqui n'est pas le fichier réelresources/views/layouts/app.blade.php; - l'appel
view('admin.invoices.show')côté contrôleur ne crée aucun lien.
Constaté sur ClientXCMS (350 templates Blade).
User story
En tant qu'agent qui modifie une vue Blade, je veux savoir quels contrôleurs la rendent, afin de mesurer l'impact sur les pages.
Acceptance criteria
-
@extends,@includepointent vers le nœud du fichier réel sous le dossier de vues - Lien contrôleur -> vue pour
view('...'),View::make('...'),response()->view('...') - Nom de vue dynamique : aucun lien
- Tests de régression qui échouent avant le correctif
Hints
graphify/extractors/blade.py:26et suivantes :tgt.replace(".", "/")sans résolution de dossier
Hors scope
- Vues des addons (cf. issue liens symboliques)
Activity
alexwrite commentedon Oct 11, 2026
Prise en charge (worktree
templates, branchefix/blade-view-resolution, empilée sur la branche Twig de #19 : le mécanisme « appel PHP qui rend un template » est commun aux deux et n'est écrit qu'une fois).Périmètre de fichiers visé :
graphify/extractors/blade.pygraphify/extractors/php_views.py(ajout du moteur Blade :view(),View::make(),response()->view())tests/test_languages.pyou test dédié, fixtures neutresApproche :
@extends/@includerésolus sousresources/views(chemin par défaut de Laravel), lien vers le nœud du fichier réel ; nom dynamique ou espace de nomspkg::vue: aucun lien vers un fichier.alexwrite commentedon Oct 11, 2026
Fait
@extendset@includepointent vers le nœud du fichier réel sousresources/viewsau lieu d'un nœud fantômelayouts/app: sur ClientXCMS, 120extendset 469includesdésormais liés au bon fichier (0 avant).renderspourview('...'),View::make('...'),response()->view('...'): 59 liens sur ClientXCMS (0 avant).paquet::vueou vue absente : aucun lien vers un fichier.Comment
graphify/extractors/blade.py:_views_root,resolve_blade_name,add_view_ref(arête marquéetarget_file, sans nœud fantôme ; une inclusion répétée donne une seule arête).graphify/extractors/php_views.py:_is_laravel_view_callet moteurbladedans la table des résolveurs, même mécanisme que Twig.graphify/cache.py: schéma du cache AST 9 vers 10.tests/test_blade_extractor.py(2 tests) ettests/fixtures/laravel_views/.Pourquoi ce choix
FileViewFinderde Laravel (laravel/framework v12.69.2,FileViewFinder.php:43pour l'ordre des extensions,:149pour les points changés en/), sous le chemin par défautresources/views(config/view.php).View::addLocation) ne sont pas devinés : le thème actif n'est pas connu statiquement. Alternative écartée : chercher aussi dansresources/themes/default/views, qui lierait à un thème qui n'est peut-être pas celui en service.Apprentissages
mass-actions/etmass_actions/coexistent dans ClientXCMS et donnent le même identifiant : la désambiguïsation les sépare, et le marquagetarget_fileenvoie bien chaque@includevers le bon des deux (23 inclusions vérifiées).view()en commentaire n'est pas relié, ce qu'une recherche par expression régulière aurait compté à tort (60 attendus par regex, 59 réels).Faiblesses restantes
view()de ClientXCMS visent une vue présente seulement dans le thème : pas de lien, par construction. Suivi : Vues : chemins ajoutés à l'exécution et Twig configuré dans twig.yaml non modélisés #38.@includeIf,@includeWhen,@each,@component,<x-...>non extraits : Blade : extraire @includeIf, @includeWhen, @each, @component et <x-...> #37.View::makeest reconnu par le nom courtView: une classe maison homonyme serait prise, bornée par l'exigence d'un fichier de vue existant.affectedne suit pasincludesnirenders: affected : suivre les liens includes et renders des templates #36.Quality
7552 passed, 14 skipped(suite complète)0 errorssurblade.pyetphp_views.pyruff check .sans erreurMerge: Blade views resolve to real files, controllers render them (#4)