Assets Yapılandırması
*********************

.[perex]
Nette Assets için yapılandırma seçeneklerine genel bakış.


```neon
assets:
	# göreli mapper yollarını çözmek için temel yol
	basePath: ...            # (string) varsayılan %wwwDir%

	# göreli mapper URL'lerini çözmek için temel URL
	baseUrl: ...             # (string) varsayılan %baseUrl%

	# varlık sürümlemesi küresel olarak etkinleştirilsin mi?
	versioning: ...           # (bool) varsayılan true

	# varlık mapper'larını tanımlar
	mapping: ...             # (array) varsayılan 'assets' yolu
```

`basePath`, mapper'lardaki göreli yolları çözmek için varsayılan dosya sistemi dizinini belirler. Varsayılan olarak web dizinini (`%wwwDir%`) kullanır.

`baseUrl`, mapper'lardaki göreli URL'leri çözmek için varsayılan URL önekini belirler. Varsayılan olarak kök URL'yi (`%baseUrl%`) kullanır.

`versioning` seçeneği, önbellek geçersizleştirme için varlık URL'lerine sürüm parametreleri eklenip eklenmeyeceğini küresel olarak denetler. Tek tek mapper'lar bu ayarı geçersiz kılabilir.


Mapper'lar
----------

Mapper'lar üç şekilde yapılandırılabilir: basit dize yazımı, ayrıntılı dizi yazımı ya da bir servis olarak (`ClassName(...)` veya `@serviceName()` varlık yazımıyla).

Bir mapper tanımlamanın en basit yolu:

```neon
assets:
	mapping:
		default: assets     # %wwwDir%/assets/ için dosya sistemi mapper'ı oluşturur
		images: img         # %wwwDir%/img/ için dosya sistemi mapper'ı oluşturur
		scripts: js         # %wwwDir%/js/ için dosya sistemi mapper'ı oluşturur
```

Her mapper şunları yapan bir `FilesystemMapper` oluşturur:
- Dosyaları `%wwwDir%/<path>` içinde arar
- `%baseUrl%/<path>` gibi URL'ler üretir
- Küresel sürümleme ayarını kalıtır


Daha fazla denetim için ayrıntılı yazımı kullanın:

```neon
assets:
	mapping:
		images:
			# dosyaların saklandığı dizin
			path: ...                    # (string) isteğe bağlı, varsayılan temel yol (basePath)

			# üretilen bağlantılar için URL öneki
			url: ...                     # (string) isteğe bağlı, varsayılan path

			# bu mapper için sürümleme etkinleştirilsin mi?
			versioning: ...              # (bool) isteğe bağlı, küresel ayarı kalıtır

			# dosyaları ararken uzantı(lar) otomatik eklensin
			extension: ...               # (string|array) isteğe bağlı, varsayılan null
```

Yapılandırma değerlerinin nasıl çözüldüğünü anlamak:

Yol çözümü:
   - Göreli yollar `basePath` değerinden çözülür (`basePath` ayarlanmamışsa `%wwwDir%` değerinden)
   - Mutlak yollar olduğu gibi kullanılır

URL çözümü:
   - Göreli URL'ler `baseUrl` değerinden çözülür (`baseUrl` ayarlanmamışsa `%baseUrl%` değerinden)
   - Mutlak URL'ler (şemalı ya da `//` ile başlayan) olduğu gibi kullanılır (`//` ile başlayan bir URL şemasını `baseUrl` değerinden alır)
   - `url` belirtilmemişse `path` değeri kullanılır


```neon
assets:
	basePath: /var/www/project/www
	baseUrl: https://example.com/assets

	mapping:
		# Göreli yol ve URL
		images:
			path: img                    # Şuna çözülür: /var/www/project/www/img
			url: images                  # Şuna çözülür: https://example.com/assets/images

		# Mutlak yol ve URL
		uploads:
			path: /var/shared/uploads    # Olduğu gibi kullanılır: /var/shared/uploads
			url: https://cdn.example.com # Olduğu gibi kullanılır: https://cdn.example.com

		# Yalnızca path belirtilmiş
		styles:
			path: css                    # Yol: /var/www/project/www/css
										 # URL: https://example.com/assets/css
```


Özel Mapper'lar
---------------

Özel mapper'lar için, var olan bir servise `@serviceName` ile başvurun ya da onu doğrudan `ClassName(arguments)` veya yalın bir sınıf adıyla tanımlayın:

```neon
services:
	s3mapper: App\Assets\S3Mapper(%s3.bucket%)

assets:
	mapping:
		cloud: @s3mapper
		database: App\Assets\DatabaseMapper(@database.connection)
```


Vite Mapper
-----------

Vite mapper yalnızca `type: vite` eklemenizi gerektirir. Yapılandırma seçeneklerinin tam listesi şudur:

```neon
assets:
	mapping:
		default:
			# mapper tipi (Vite için gereklidir)
			type: vite                # (string) gerekli, 'vite' olmalıdır

			# Vite derleme çıktı dizini
			path: ...                 # (string) isteğe bağlı, varsayılan temel yol (basePath)

			# derlenmiş varlıklar için URL öneki
			url: ...                  # (string) isteğe bağlı, varsayılan path

			# Vite manifest dosyasının konumu
			manifest: ...             # (string) isteğe bağlı, path'e göreli, varsayılan <path>/.vite/manifest.json

			# Vite dev sunucusu yapılandırması
			devServer: ...            # (bool|string) isteğe bağlı, varsayılan true

			# public dizinindeki dosyalar için sürümleme
			versioning: ...           # (bool) isteğe bağlı, küresel ayarı kalıtır

			# public dizinindeki dosyalar için otomatik uzantı
			extension: ...            # (string|array) isteğe bağlı, varsayılan null
```

`devServer` seçeneği, varlıkların geliştirme sırasında nasıl yükleneceğini denetler:

- `true` (varsayılan) - Çalışan bir Vite dev sunucusunu otomatik algılar (Nette Vite eklentisinin derleme dizininde oluşturduğu `.vite/nette.json` dosyası aracılığıyla). Dev sunucusu çalışıyorsa **ve uygulamanız hata ayıklama kipindeyse**, varlıklar hot module replacement desteğiyle ondan yüklenir. Dev sunucusu çalışmıyorsa, varlıklar public dizinindeki derlenmiş dosyalardan yüklenir.
- `false` - Dev sunucusu entegrasyonunu tümüyle kapatır. Varlıklar her zaman derlenmiş dosyalardan yüklenir.
- Özel URL (örneğin `https://localhost:5173`) - Dev sunucusu URL'sini protokol ve port dahil elle belirtin. Dev sunucusu farklı bir host ya da portta çalışıyorsa yararlıdır. Otomatik algılamada olduğu gibi yalnızca hata ayıklama kipinde geçerlidir; üretimde her zaman derlenmiş dosyalar kullanılır.

`versioning` ve `extension` seçenekleri yalnızca Vite'ın public dizinindeki, Vite tarafından işlenmeyen dosyalar için geçerlidir.


Elle Yapılandırma
-----------------

Nette DI kullanmıyorsanız mapper'ları elle yapılandırın:

```php
use Nette\Assets\Registry;
use Nette\Assets\FilesystemMapper;
use Nette\Assets\ViteMapper;

$registry = new Registry;

// Dosya sistemi mapper'ı ekle
$registry->addMapper('images', new FilesystemMapper(
	baseUrl: 'https://example.com/img',
	basePath: __DIR__ . '/www/img',
	extensions: ['webp', 'jpg', 'png'],
	versioning: true,
));

// Vite mapper ekle
$registry->addMapper('app', new ViteMapper(
	baseUrl: '/build',
	basePath: __DIR__ . '/www/build',
	manifestPath: __DIR__ . '/www/build/.vite/manifest.json',
	devServer: 'https://localhost:5173',
));
```

Kayıtlı herhangi bir mapper'ı `getMapper()` metoduyla adına göre de alabilirsiniz:

```php
$mapper = $registry->getMapper('images');   // kayıtlı mapper'ı döndürür
$default = $registry->getMapper();           // 'default' mapper'ı döndürür
```