PHP Yansıması
*************

.[perex]
[api:Nette\Utils\Reflection] PHP yansıması için yararlı işlevler içeren statik bir sınıftır. Amacı, yerel sınıflardaki kusurları düzeltmek ve PHP'nin farklı sürümlerindeki davranışları birleştirmektir.


Kurulum:

```shell
composer require nette/utils
```

Tüm örnekler aşağıdaki sınıf takma adının tanımlandığını varsayar:

```php
use Nette\Utils\Reflection;
```


areCommentsAvailable(): bool .[method]
--------------------------------------

Yansımanın PHPdoc yorumlarına erişimi olup olmadığını bulur. Opcode önbelleği nedeniyle yorumlar mevcut olmayabilir, örneğin [opcache.save-comments |https://www.php.net/manual/en/opcache.configuration.php#ini.opcache.save-comments] yönergesine bakınız.


expandClassName(string $name, ReflectionClass $context): string .[method]
-------------------------------------------------------------------------

Sınıfın `$name` adresini `$context` bağlamında, yani isim alanı ve tanımlı takma adları bağlamında tam isme genişletir. Böylece, `$context` gövdesinde yazılmış olsaydı PHP çözümleyicisinin `$name` 'u nasıl anlayacağını döndürür.

```php
namespace Foo;
use Bar;

class DemoClass
{
	// new Bar, new Baz
}

$context = new ReflectionClass(Foo\DemoClass::class);
Reflection::expandClassName('Bar', $context); // 'Bar'
Reflection::expandClassName('Baz', $context); // 'Foo\Baz'
```


getMethodDeclaringMethod(ReflectionMethod $method): ReflectionMethod .[method]
------------------------------------------------------------------------------

`$method` bildirimini içeren bir yöntemin yansımasını döndürür. Genellikle, her yöntem kendi bildirimidir, ancak yöntemin gövdesi trait içinde ve farklı bir ad altında da olabilir.

PHP gerçek bildirimi belirlemek için yeterli bilgi sağlamadığından, Nette **güvenilir** olması gereken kendi sezgisel yöntemlerini kullanır.

```php
trait DemoTrait
{
	function foo()
	{
	}
}


class DemoClass
{
	use DemoTrait {
		DemoTrait::foo as foo2;
	}
}


$method = new ReflectionMethod('DemoClass::foo2');
Reflection::getMethodDeclaringMethod($method); // ReflectionMethod('DemoTrait::foo')
```


getPropertyDeclaringClass(ReflectionProperty $prop): ReflectionClass .[method]
------------------------------------------------------------------------------

`$prop` özelliğinin bildirimini içeren bir sınıf veya özelliğin yansımasını döndürür. Özellik, özellik içinde de bildirilebilir.

PHP gerçek bildirimi belirlemek için yeterli bilgi sağlamadığından, Nette **güvenilir olmayan** kendi sezgisel yöntemlerini kullanır.

```php
trait DemoTrait
{
	public $foo;
}


class DemoClass
{
	use DemoTrait;
}

$prop = new ReflectionProperty(DemoClass::class, 'foo');
Reflection::getPropertyDeclaringClass($prop); // ReflectionClass('DemoTrait')
```


isBuiltinType(string $type): bool .[method deprecated]
------------------------------------------------------

`$type` PHP yerleşik türü olup olmadığını belirler. Aksi takdirde, sınıf adıdır.

```php
Reflection::isBuiltinType('string'); // true
Reflection::isBuiltinType('Foo');    // false
```

.[note]
[Nette\Utils\Validator::isBuiltinType() |validators#isBuiltinType] işlevini kullanın.


toString($reflection): string .[method]
---------------------------------------

Bir yansımayı insan tarafından okunabilir bir dizeye dönüştürür.

```php
$func = new ReflectionFunction('func');
echo Reflection::toString($func); // 'func()'

$class = new ReflectionClass('DemoClass');
echo Reflection::toString($class); // 'DemoClass'

$method = new ReflectionMethod('DemoClass', 'foo');
echo Reflection::toString($method); // 'DemoClass::foo()'

$param = new ReflectionParameter(['DemoClass', 'foo'], 'param');
echo Reflection::toString($param); // '$param in DemoClass::foo()'

$prop = new ReflectionProperty('DemoClass', 'foo');
echo Reflection::toString($prop); // 'DemoClass::$foo'
```