Interface PHPStan\Analyser\DependencyTracker

The interface DependencyTracker can be typehinted in 2nd parameter of Rule::processNode() and Collector::processNode(), and in the Scope parameter of dynamic return type extensions, dynamic throw type extensions, expression type resolver extensions, parameter out type extensions, parameter closure type extensions, parameter closure this extensions and type-specifying extensions:

/**
 * @param Scope&DependencyTracker $scope
 *\/
public function processNode(Node $node, Scope $scope): array

The intersection goes to the PHPDoc: the native parameter type stays Scope, which is what the interfaces declare once PHPStan is downgraded for older PHP versions.

It tracks what the analysis of the current file depends on besides the analysed code, so that the result cache re-analyses the file when that changes - see ResultCacheValueExtension. In a rule for CollectedDataNode, it tracks what the errors of the rule depend on: with the reuseCollectedDataRuleErrors feature toggle, the result cache reuses the errors of such a rule while its collected data and the tracked values stay the same. A rule that does not call get() on the node runs every time.

Extensions that get no Scope because they describe a class - class reflection extensions - use DeclarationDependencyTracker instead.

PHPStan\Analyser\DependencyTracker
- PHPStan\Analyser\MutatingScope implements Scope, NodeCallbackInvoker, CollectedDataEmitter, DependencyTracker
  - PHPStan\Analyser\NodeCallbackScope

Located at src/Analyser/DependencyTracker.php

Methods
`public`	`trackValueDependency(class-string<ResultCacheValueExtension> $extensionClass, string $key): void` The analysis of the current file depends on the value $extensionClass gives for $key. The analysis of the current file depends on the value $extensionClass gives for $key.	#
`public`	`trackFileDependency(string $file): void` The analysis of the current file depends on the contents of $file - a data file, a template, a docblock in another PHP file - that is read on its own, without PHPStan knowing about it. The current file is then re-analysed whenever $file is created, changed in any way, or deleted. The analysis of the current file depends on the contents of $file - a data file, a template, a docblock in another PHP file - that is read on its own, without PHPStan knowing about it. The current file is then re-analysed whenever $file is created, changed in any way, or deleted. The path should be absolute. The file does not have to exist.	#
`public`	`trackDirectoryDependency(string $directory, string $pattern = ''): void` The analysis of the current file depends on the files in $directory, recursively, whose names match $pattern (fnmatch() syntax, like ".php" or "Pest.php") - a directory scanned for configuration files, templates or migrations. The current file is then re-analysed whenever such a file is created, changed in any way, deleted or renamed, or the directory itself is created or deleted. The analysis of the current file depends on the files in $directory, recursively, whose names match $pattern (fnmatch() syntax, like "*.php" or "Pest.php") - a directory scanned for configuration files, templates or migrations. The current file is then re-analysed whenever such a file is created, changed in any way, deleted or renamed, or the directory itself is created or deleted.	#
`public`	`trackClassDependency(string $className): void` The analysis of the current file depends on the class $className as if the code referenced it - a class named in a string, in a PHPDoc tag PHPStan does not resolve, or in a configuration file. The current file is then re-analysed when the class or one of its parents, interfaces or traits changes what it declares (signatures and PHPDocs, not method bodies), and when the class is created, deleted or moved to another file. The analysis of the current file depends on the class $className as if the code referenced it - a class named in a string, in a PHPDoc tag PHPStan does not resolve, or in a configuration file. The current file is then re-analysed when the class or one of its parents, interfaces or traits changes what it declares (signatures and PHPDocs, not method bodies), and when the class is created, deleted or moved to another file.	#

Namespaces

Classes

Interfaces

Exceptions

Interface PHPStan\Analyser\DependencyTracker