File: AnnotationReader.php

package info (click to toggle)
mediawiki 1%3A1.43.3%2Bdfsg-1
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid, trixie
  • size: 417,464 kB
  • sloc: php: 1,062,949; javascript: 664,290; sql: 9,714; python: 5,458; xml: 3,489; sh: 1,131; makefile: 64
file content (38 lines) | stat: -rw-r--r-- 935 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
<?php

namespace Wikimedia\DebugInfo;

/**
 * Utility class for reading doc comment annotations
 *
 * @since 1.40
 */
class AnnotationReader {
	/** @var bool[] */
	private static $cache = [];

	/**
	 * Determine whether a ReflectionProperty has a specified annotation
	 *
	 * @param \ReflectionProperty $property
	 * @param string $annotationName
	 * @return bool
	 */
	public static function propertyHasAnnotation(
		\ReflectionProperty $property,
		string $annotationName
	) {
		$cacheKey = "$annotationName@{$property->class}::{$property->name}";
		if ( !isset( self::$cache[$cacheKey] ) ) {
			$comment = $property->getDocComment();
			if ( $comment === false ) {
				self::$cache[$cacheKey] = false;
			} else {
				$encAnnotation = preg_quote( $annotationName, '!' );
				self::$cache[$cacheKey] =
					(bool)preg_match( "!^[ \t]*(/\*\*|\*)[ \t]*@$encAnnotation\b!im", $comment );
			}
		}
		return self::$cache[$cacheKey];
	}
}