Kullanım tekniği XenForo config.php Dosyası - Kapsamlı Rehber

[WindowsWindows doğrulanmış üyedir.]

XenForo config.php Dosyası - Kapsamlı Rehber

---

Merhaba arkadaşlar,

Bugün XenForo'nun kalbi sayılabilecek config.php dosyasından bahsedeceğim. Birçoğunuz kurulum sırasında bu dosyayla karşılaşmışsınızdır ama içerisinde neler olduğunu tam olarak bilmeyebilirsiniz. Gelin birlikte inceleyelim.

---

config.php Nerede Bulunur?

XenForo'nun veritabanı bağlantı bilgileri src/config.php dosyasında saklanır.

XenForo'yu nasıl kurduğunuza bağlı olarak:

• Manuel kurulum: src/config.php-default dosyasının içeriğini kopyalayarak kendiniz oluşturabilirsiniz
• Otomatik kurulum: Installer sizin için otomatik olarak oluşturur

Önemli Not: Normalde config.php dosyası sadece temel ayarları içerir. Ancak ekstra özelleştirmeler için kullanabileceğiniz birçok gelişmiş ayar vardır. Bu ayarlar config.php aracılığıyla kontrol edilir ve denemeye açıktır.

Kritik Uyarı: Bu ayarlar XenForo'nun temel işlevlerini kontrol eder. Yanlış yapılandırma sitenizin çalışmamasına neden olabilir. Eğer bir sorun yaşarsanız, değişiklikleri geri alın veya config.php dosyasını sıfırlayın.

---

Temel Yapılandırma

config.php dosyasında bir değişken tanımlamak için şu format kullanılır:

$config['variableName'] = 'default-value';

Değişken isimleri tam olarak gösterildiği şekilde yazılmalıdır (büyük/küçük harf duyarlı). Aksi takdirde ayar geçersiz sayılır ve görmezden gelinir.

Her değişken bir varsayılan değerle gösterilir, örneğin:

$config['variableName'] = 'default-value';

Veritabanı Bağlantısı

Temel Bağlantı Bilgileri

$config['db']['host'] = 'localhost';
$config['db']['port'] = 3306;
$config['db']['socket'] = null;

Bu ayarlar, XenForo veritabanınızı barındıran MySQL sunucusunun hostname, port ve socket bilgilerini içerir. Bu bilgileri hosting sağlayıcınızdan alabilirsiniz.

Kimlik Doğrulama

$config['db']['username'] = '';
$config['db']['password'] = '';
$config['db']['dbname'] = '';

Veritabanı kullanıcı adı, şifre ve veritabanı ismini buraya girin. Bu bilgiler sunucunuzda kurulu olan ve forumunuzda kullanacağınız veritabanına aittir.

---

Unicode ve Emoji Desteği

Tam Unicode Desteği

$config['fullUnicode'] = false;

Bu ayar, XenForo'nun forum içeriğinde tam Unicode desteği (emojiler dahil) kullanıp kullanmayacağını belirler. Tam Unicode kullanılmadığında, bazı karakterler (emojiler gibi) doğru görüntülenmeyebilir.

Önemli Bilgiler:

• XenForo 2 ile başladıysanız ve XenForo 1'den upgrade yapmadıysanız, veritabanınız zaten tam Unicode formatındadır ve bu ayarı true yapabilirsiniz
• XenForo 1'den upgrade yaptıysanız, önce Unicode dönüştürme işlemini yapmanız gerekir
• Aksi takdirde bu ayarı false bırakmalısınız

Gereksinim: Tam Unicode desteği için en az MySQL 5.5 gereklidir.

---

Cookie Ayarları

Kullanıcılarınızın tarayıcısında cookie ayarlarını yapılandırmak istiyorsanız, aşağıdaki ayarları kullanabilirsiniz. Ancak bu ayarların yanlış kullanımı, kullanıcılarınızın XenForo hesaplarına giriş yapamamasına veya kontrol panelinden çıkış yapamamasına neden olabilir.

Ana Ayar

Bu ayarları yalnızca gerçekten gerekli olduğunda değiştirin! Sorun yaşarsanız, değerleri varsayılana geri döndürün.

Cookie Prefix (Öneki)

$config['cookie']['prefix'] = 'xf_';

Tüm cookie'ler isimleriyle tanımlanır ve XenForo tarafından oluşturulan cookie'ler normalde xf_ önekiyle başlar. Bu sayede aynı domain'de birden fazla XenForo kurulumu yaparsanız cookie'ler karışmaz.

Cookie prefix'i şu karakterleri içermelidir: harfler, sayılar ve alt çizgi. Büyük/küçük harf duyarlılığına dikkat edin.

Cookie Path (Yolu)

$config['cookie']['path'] = '/';

Varsayılan değer / ile tüm XenForo cookie'lerinin sitenizin her alanında kullanılabilir olmasını sağlar. Bu değeri değiştirirseniz, cookie'lerin sadece belirtilen dizinde geçerli olmasını sağlayabilirsiniz.

Örnek kullanımlar:

• / → XenForo cookie'leri sitenin tüm alanlarında geçerlidir
• /forum/ → Cookie'ler sadece forum dizini içindeki sayfalarda okunabilir (örn: http://example.com/forum)
• /path/to/other/folder/ → Cookie'ler sadece belirtilen dizinde geçerlidir

Önemli Uyarı:

Eğer cookie path'i XenForo root klasörü dışında bir yere ayarlarsanız, şu sorunlar oluşabilir:

• Root klasörün dışındaki sayfalarda cookie'ler okunamaz
• Şu URL'lerde sorun yaşarsınız:
  • http://example.com/path
  • http://example.com/path/
  • http://example.com/path/to
  • http://example.com/path/to/other

Öneri: Cookie path'i XenForo root klasörü içinde tutmak en güvenli yoldur. Eğer farklı bir değer kullanmanız gerekiyorsa, çok dikkatli olun. Yanlış bir değer, cookie-based işlevleri bozabilir.

Cookie Domain (Alan Adı)

$config['cookie']['domain'] = '';

Cookie domain, cookie'lerin hangi alan adlarında kullanılabileceğini belirler. Varsayılan olarak boş bırakılır (/ path ile birlikte) ve cookie'lerin site genelinde kullanılmasını sağlar.

Bu ayarı kullanmanın temel nedeni, aynı domain'deki birden fazla XenForo kurulumunun cookie paylaşımını sağlamaktır. Eğer sadece tek bir kurulumunuz varsa, bu ayarları değiştirmenize gerek yoktur.

Diğer senaryolar için bu ayarları değiştirin, ancak çok dikkatli olun! Yanlış yapılandırma, cookie tabanlı işlevleri bozabilir (giriş yapma, çıkış yapma gibi).

Domain Ayarı Nasıl Çalışır?

Cookie domain'i, birden fazla subdomain'de cookie paylaşımını sağlamak için kullanılır. Örneğin:

• example.com domain'inden erişilen cookie'ler subdomain.example.com ve diğer subdomain'lerde de kullanılabilir
• www.example.com ve other.example.com gibi farklı subdomain'lerde de aynı cookie'ler geçerli olur

Bu ayarı kullanırken, genellikle şu formatta bir değer girersiniz:

$config['cookie']['domain'] = '.example.com';

Bu şekilde example.com ve tüm subdomain'lerde cookie'ler kullanılabilir.

Örnek Kullanım Senaryoları

Senaryo 1: Sadece Ana Domain

$config['cookie']['domain'] = ''; // Varsayılan

Cookie'ler sadece ayarlandığı domain'de okunabilir.

Senaryo 2: Tüm Subdomain'ler Dahil

$config['cookie']['domain'] = '.example.com';

example.com ve tüm subdomain'lerinde (www.example.com, forum.example.com, vb.) cookie'ler kullanılabilir.

Senaryo 3: Belirli Bir Subdomain

$config['cookie']['domain'] = 'subdomain.example.com';

Cookie'ler sadece subdomain.example.com'da okunabilir.
Sonuç

config.php dosyası XenForo'nun en kritik dosyalarından biridir. Bu ayarları değiştirirken:

• Değişiklik yapmadan önce yedek alın
• Her ayarın ne işe yaradığını tam olarak anlayın
• Test ortamında deneme yapın
• Sorun yaşarsanız hemen geri alın

Umarım bu rehber sizin için faydalı olmuştur. Sorularınızı yorumlarda belirtebilirsiniz!

 

[FoxFox doğrulanmış üyedir.]

Harika ve çok detaylı bir rehber olmuş, ellerine sağlık! Özellikle **Unicode** ve **Cookie** ayarlarıyla ilgili verdiğin uyarılar çok kritik; kurulum sonrası "giriş yapamama" veya "emoji karakter hataları" yaşayan kullanıcılar için can kurtarıcı bir kaynak.

Rehberine ek olarak, hata ayıklama süreçlerinde çok işe yarayan şu küçük satırı da belki ilerleyen süreçte konuya dahil edebilirsin:

$config['debug'] = true;

Özellikle beyaz sayfa hatası alan veya şablonlarda geliştirme yapmak isteyenler için bu kod hayat kurtarıcı olabiliyor. Paylaşım için teşekkürler!