Extension for custom tags

Offen

#178 erstellt am 10.2.2023 1 Kommentar 0 Reaktionen 0 zugewiesene Personen Auf GitHub ansehen

Dieses Issue hat noch niemand übernommen.

Bewertung

Schwierigkeit: 4/5
Geschätzter Aufwand: 3-5 Tage
Anfängerfreundlichkeit: 38/100

Issue-Typ: Feature
Klarheit: Muss geklärt werden
Aktivitätsstatus: Aktiv
Tech-Stack: php
Bereich: devtools

Rechercherichtung

Start by tracing how PhpDoc input containing custom tags is parsed and where it currently fails before reaching TypeNodeResolverExtension. Define the parser and extension behavior needed for tuple and shape tags, then verify that those tags reach the extension's resolve call without breaking existing PhpDoc parsing.

Vom Indexierungsmodell aus dem Issue-Text verfasst.

Beschreibung

Description

It would be cool to see the extension for custom tags.

We have our own tags that describe Array shapes as in PhpStan:

/**
 * @param tuple(T1, T2, ..., Tn) $tuple
 * @param shape(k1:T1, k2:T2, ..., kn:Tn) $shape
 */

Why?

I want to make an extension for PhpStan, which through TypeNodeResolverExtension, would be able to tell what type is here.

Problem

At the moment, the problem occurs while parsing a PhpDoc and does not reach the resolve call of TypeNodeResolverExtension.

Vorherrschende Sprache: PHP
Sterne: 1.5k
Forks: 78
Ø Merge: 9 Std. 5 Min.
Gemergte PRs (30 T.): 5

Beitragsleitfaden

Für dieses Repository ist kein Beitragsleitfaden indexiert

Erste Schritte

Lesen Sie das ganze Issue und danach den Beitragsleitfaden des Projekts.
Schreiben Sie ins Issue, dass Sie es übernehmen — das erspart doppelte Arbeit.
Forken Sie das Repository und arbeiten Sie in einem Branch.
Öffnen Sie einen Pull Request, der die Issue-Nummer nennt.

Mehr aus phpstan/phpdoc-parser

Printer drops the `*` prefix on continuation lines of a changed multi-line PhpDocTextNode Offen

Schwierigkeit 3/5 1-2 Tage Anfängerfreundlichkeit 68/100

phpstan/phpdoc-parser#317 · Erstellt am 07.9.2026
support for class-string-map<T of Foo> Offen

Schwierigkeit 5/5 Über eine Woche Anfängerfreundlichkeit 25/100

phpstan/phpdoc-parser#281 · 2 Kommentare · 1 Reaktion · Erstellt am 22.12.2025
stdClass|Iterator&Throwable is parsed as stdClass|Iterator Offen

Schwierigkeit 4/5 3-5 Tage Anfängerfreundlichkeit 35/100

phpstan/phpdoc-parser#271 · 1 Kommentar · 1 Reaktion · Erstellt am 27.3.2025
Comment not allowed in @phpstan-type Offen

Schwierigkeit 3/5 1-2 Tage Anfängerfreundlichkeit 35/100

phpstan/phpdoc-parser#219 · Erstellt am 08.11.2023
"New in initializers" breaks in docblock Offen

Schwierigkeit 3/5 1-2 Tage Anfängerfreundlichkeit 42/100

phpstan/phpdoc-parser#173 · 1 Kommentar · Erstellt am 22.12.2022

Alle Issues in phpstan/phpdoc-parser