Nette Bootstrap
***************
.[perex]
Tek tek Nette bileşenleri yapılandırma dosyalarıyla ayarlanır. Bu dosyaların nasıl yükleneceğini göstereceğiz.
.[tip]
Framework'ün tamamını kullanıyorsanız başka bir şey yapmanıza gerek yok. Projenizde yapılandırma dosyaları için hazır bir `config/` dizini vardır ve onların yüklenmesini [uygulama yükleyicisi |application:bootstrapping#DI konteynerinin yapılandırması] üstlenir. Bu yazı, yalnızca tek bir Nette kütüphanesini kullanan ve yapılandırma dosyalarından yararlanmak isteyen kullanıcılar içindir.
Yapılandırma dosyaları genellikle [NEON biçiminde|neon:format] yazılır ve onları [biçimi destekleyen düzenleyicilerde |tools:ide] düzenlemek en iyisidir. Onları, nesnelerin nasıl **oluşturulacağı ve yapılandırılacağı** yönergeleri olarak düşünebilirsiniz. Böylece bir yapılandırmayı yüklemenin sonucu, kullanmak istediğiniz diğer nesneleri istendiğinde oluşturan bir nesne olan factory olacaktır. Örneğin bir veritabanı bağlantısı vb.
Bu factory'ye *dependency injection container* (DI container) da denir ve ayrıntılarla ilgileniyorsanız [dependency injection |dependency-injection:] bölümünü okuyun.
Yapılandırmanın yüklenmesini ve container'ın oluşturulmasını [api:Nette\Bootstrap\Configurator] sınıfı üstlenir, dolayısıyla önce onun `nette/bootstrap` paketini kuralım:
```shell
composer require nette/bootstrap
```
Ve `Configurator` sınıfının bir örneğini oluşturalım. Üretilen DI container diske önbelleklendiğinden, onun kaydedileceği dizinin yolunu ayarlamanız gerekir:
```php
$configurator = new Nette\Bootstrap\Configurator;
$configurator->setTempDirectory(__DIR__ . '/temp');
```
Linux ya da macOS'ta `temp/` dizini için [yazma izinlerini |nette:troubleshooting#Dizin İzinlerini Ayarlama] ayarlayın.
Şimdi yapılandırma dosyalarının kendisine geliyoruz. Onları `addConfig()` ile yükleriz:
```php
$configurator->addConfig(__DIR__ . '/database.neon');
```
Daha fazla yapılandırma dosyası eklemek isterseniz, `addConfig()` fonksiyonunu birden çok kez çağırabilirsiniz. Dosyalarda aynı anahtarlara sahip öğeler bulunursa, onların üzerine yazılır (diziler söz konusuysa [birleştirilir |dependency-injection:configuration#Birleştirme]). Sonradan eklenen dosyanın önceliği öncekinden yüksektir.
Son adım DI container'ı oluşturmaktır:
```php
$container = $configurator->createContainer();
```
Ve bu bizim için istenen nesneleri oluşturacak. Örneğin [Nette Database|database:configuration] için yapılandırmayı kullanıyorsanız, ondan veritabanı bağlantıları oluşturmasını isteyebilirsiniz:
```php
$db = $container->getByType(Nette\Database\Connection::class);
// ya da
$explorer = $container->getByType(Nette\Database\Explorer::class);
// ya da birden çok bağlantı oluşturulurken
$db = $container->getByName('database.main.connection');
```
Ve artık veritabanıyla çalışabilirsiniz!
Geliştirme Kipi ile Üretim Kipi
-------------------------------
Geliştirme kipinde, yapılandırma dosyaları her değiştiğinde container otomatik güncellenir. Üretim kipinde yalnızca bir kez üretilir ve değişiklikler denetlenmez. Böylece geliştirme kipi programcının en üst düzey rahatlığını hedeflerken, üretim kipi başarıma ve üretime dağıtıma odaklanır.
Kip seçimi otomatik algılamayla yapılır, dolayısıyla genellikle hiçbir şeyi yapılandırmaya ya da elle değiştirmeye gerek yoktur. Uygulama localhost üzerinde çalışıyorsa (yani IP adresi `127.0.0.1` ya da `::1` ise) ve hiçbir vekil sunucu (yani onun HTTP başlığı) yoksa kip geliştirmedir. Aksi hâlde üretim kipinde çalışır.
Geliştirme kipini başka durumlarda da, örneğin belirli bir IP adresinden erişen programcılar için etkinleştirmek istersek `setDebugMode()` kullanırız:
```php
$configurator->setDebugMode('23.75.345.200');
// bir IP adresleri dizisi de belirtilebilir
```
IP adresini bir çerezle birleştirmenizi güçlü biçimde öneririz. `nette-debug` çerezinde gizli bir token saklayın, örneğin `secret1234`. Böylece geliştirme kipini, belirli bir IP adresinden erişen ve çerezinde anılan token da bulunan programcılar için etkinleştirirsiniz:
```php
$configurator->setDebugMode('secret1234@23.75.345.200');
```
Geliştirme kipini, localhost için bile tümüyle kapatabiliriz:
```php
$configurator->setDebugMode(false);
```
Parametreler
------------
Yapılandırma dosyalarında, [`parameters` bölümünde |dependency-injection:configuration#Parametreler] tanımlanan parametreleri de kullanabilirsiniz.
Onlar `addDynamicParameters()` metoduyla dışarıdan da eklenebilir:
```php
$configurator->addDynamicParameters([
'remoteIp' => $_SERVER['REMOTE_ADDR'],
]);
```
`remoteIp` parametresine yapılandırmada `%remoteIp%` yazımıyla başvurulabilir.
Daha yeni bir sürüme yükseltiyorsanız [yükseltme |upgrading] sayfasına bakın.
Nette Bootstrap
Tek tek Nette bileşenleri yapılandırma dosyalarıyla ayarlanır. Bu dosyaların nasıl yükleneceğini
göstereceğiz.
Framework'ün tamamını kullanıyorsanız başka bir şey yapmanıza gerek yok. Projenizde yapılandırma
dosyaları için hazır bir config/ dizini vardır ve onların yüklenmesini uygulama yükleyicisi üstlenir.
Bu yazı, yalnızca tek bir Nette kütüphanesini kullanan ve yapılandırma dosyalarından yararlanmak isteyen kullanıcılar
içindir.
Yapılandırma dosyaları genellikle NEON biçiminde yazılır ve onları biçimi destekleyen düzenleyicilerde düzenlemek en iyisidir. Onları, nesnelerin
nasıl oluşturulacağı ve yapılandırılacağı yönergeleri olarak düşünebilirsiniz. Böylece bir yapılandırmayı
yüklemenin sonucu, kullanmak istediğiniz diğer nesneleri istendiğinde oluşturan bir nesne olan factory olacaktır. Örneğin
bir veritabanı bağlantısı vb.
Bu factory'ye dependency injection container (DI container) da denir ve ayrıntılarla ilgileniyorsanız dependency injection bölümünü okuyun.
Yapılandırmanın yüklenmesini ve container'ın oluşturulmasını Nette\Bootstrap\Configurator sınıfı
üstlenir, dolayısıyla önce onun nette/bootstrap paketini kuralım:
composer require nette/bootstrap
Ve Configurator sınıfının bir örneğini oluşturalım. Üretilen DI container diske önbelleklendiğinden,
onun kaydedileceği dizinin yolunu ayarlamanız gerekir:
$configurator = new Nette\Bootstrap\Configurator;
$configurator->setTempDirectory(__DIR__ . '/temp');
Linux ya da macOS'ta temp/ dizini için yazma izinlerini ayarlayın.
Şimdi yapılandırma dosyalarının kendisine geliyoruz. Onları addConfig() ile yükleriz:
$configurator->addConfig(__DIR__ . '/database.neon');
Daha fazla yapılandırma dosyası eklemek isterseniz, addConfig() fonksiyonunu birden çok kez
çağırabilirsiniz. Dosyalarda aynı anahtarlara sahip öğeler bulunursa, onların üzerine yazılır (diziler söz konusuysa birleştirilir). Sonradan eklenen dosyanın
önceliği öncekinden yüksektir.
Son adım DI container'ı oluşturmaktır:
$container = $configurator->createContainer();
Ve bu bizim için istenen nesneleri oluşturacak. Örneğin Nette
Database için yapılandırmayı kullanıyorsanız, ondan veritabanı bağlantıları oluşturmasını isteyebilirsiniz:
$db = $container->getByType(Nette\Database\Connection::class);
// ya da
$explorer = $container->getByType(Nette\Database\Explorer::class);
// ya da birden çok bağlantı oluşturulurken
$db = $container->getByName('database.main.connection');
Ve artık veritabanıyla çalışabilirsiniz!
Geliştirme Kipi ile Üretim Kipi
Geliştirme kipinde, yapılandırma dosyaları her değiştiğinde container otomatik güncellenir. Üretim kipinde yalnızca
bir kez üretilir ve değişiklikler denetlenmez. Böylece geliştirme kipi programcının en üst düzey rahatlığını
hedeflerken, üretim kipi başarıma ve üretime dağıtıma odaklanır.
Kip seçimi otomatik algılamayla yapılır, dolayısıyla genellikle hiçbir şeyi yapılandırmaya ya da elle değiştirmeye
gerek yoktur. Uygulama localhost üzerinde çalışıyorsa (yani IP adresi 127.0.0.1 ya da ::1 ise) ve
hiçbir vekil sunucu (yani onun HTTP başlığı) yoksa kip geliştirmedir. Aksi hâlde üretim kipinde çalışır.
Geliştirme kipini başka durumlarda da, örneğin belirli bir IP adresinden erişen programcılar için etkinleştirmek
istersek setDebugMode() kullanırız:
$configurator->setDebugMode('23.75.345.200');
// bir IP adresleri dizisi de belirtilebilir
IP adresini bir çerezle birleştirmenizi güçlü biçimde öneririz. nette-debug çerezinde gizli bir token
saklayın, örneğin secret1234. Böylece geliştirme kipini, belirli bir IP adresinden erişen ve çerezinde anılan
token da bulunan programcılar için etkinleştirirsiniz:
$configurator->setDebugMode('secret1234@23.75.345.200');
Geliştirme kipini, localhost için bile tümüyle kapatabiliriz:
$configurator->setDebugMode(false);
Parametreler
Yapılandırma dosyalarında, parameters bölümünde
tanımlanan parametreleri de kullanabilirsiniz.
Onlar addDynamicParameters() metoduyla dışarıdan da eklenebilir:
$configurator->addDynamicParameters([
'remoteIp' => $_SERVER['REMOTE_ADDR'],
]);
remoteIp parametresine yapılandırmada %remoteIp% yazımıyla başvurulabilir.
Daha yeni bir sürüme yükseltiyorsanız yükseltme
sayfasına bakın.