Jump to content

Manual:LocalSettings.php

From mediawiki.org
This page is a translated version of the page Manual:LocalSettings.php and the translation is 100% complete.
Uyarı Uyarı: LocalSettings.php dosyasını Windows 10 Sürüm 1809 veya daha önceki sürümlerde Not Defteri, TextEdit veya dosyalara bayt sırası işaretleri ekleyen diğer metin düzenleyicileri gibi belge düzenleyicileriyle düzenlemeyin. Bunlar vikinizin PHP çalışma zamanını bozar. Bunun yerine bir kod düzenleyici kullanın, örneğin Vim veya Notepad++. Bunlar dosya kodlamalarını düzgün bir şekilde işler. Ayrıca belge düzenleyicileri tarafından daha önce bozulmuş dosyaları onarmak için de kullanılabilirler.

LocalSettings.php dosyası, MediaWiki kurulumunun temel yapılandırma ayarlarını sağlar. Bu dosyadaki ayarları gözden geçirmek için zaman ayırmalısınız. Dosya genellikle web tabanlı MediaWiki yükleyicisi tarafından oluşturulur, ancak muhtemelen Apache ayarlarıyla uyumlu olarak parametreleri değiştirebilirsiniz. Viki çiftliği olarak yapılandırılan MediaWiki kurulumları için CommonSettings.php adlı bir dosya kullanılabilir.

Sunucudaki konum

LocalSettings.php dosyası bir viki sayfası değildir ve ona web tarayıcınızla erişemezsiniz. Bunun yerine, sunucunun dosya sistemindeki bir dosyadır. İçeriği vikinin ilk kurulumu sırasında oluşturulur ve elde edilen dosyanın sunucuya elle kopyalanması gerekir. Dosya, MediaWiki'yi kurduğunuz klasörün içinde, includes/ ve skins/ gibi klasörler ve api.php gibi dosyalarla aynı seviyede bulunmalıdır. Bu dosya orada değilse, viki hiç çalışmayacaktır. Viki çalışırsa, dosya oradadır. Nerede olduğunu bilmiyorsanız, onu bulmak için bir terminal penceresine find / -iname LocalSettings.php -print gibi bir komut girebilirsiniz.

(Vagrant kullanıyorsanız, ayrıca MediaWiki-Vagrant#MediaWiki ayarları sayfasına bakın.)

Güvenlik

LocalSettings.php genellikle veritabanı oturum açma bilgileri gibi hassas verileri içerir. Bu veriler kamuoyuna asla ifşa edilmemelidir! Sunucudaki bir güvenlik ihlali nedeniyle, diğer kullanıcılar dosyaların içeriğini görebilir. Verilerinizin güvenliğini artırmak için bu dosya için UNIX izinlerini buna göre ayarlamalısınız: Web sunucusu kullanıcısının bu dosyaya erişimi olmalıdır. Bu, dosyanın sahibi olan aynı hesapsa, izinleri 600 olarak ayarlayabilirsiniz. Bazen, web sunucusu kullanıcısı dosya sahibi değildir, ancak sahibinin UNIX kullanıcı grubundadır. Bu durumda 640 izinleri iyi olmalıdır. Gelişmiş güvenlik için izinleri mümkün olduğunca daraltmalısınız.

Ek olarak, yalnızca viki tarafından kullanılan veritabanıyla sınırlı bir MySQL kullanıcısı oluşturabilir ve bu kullanıcının kimlik bilgilerini LocalSettings.php içinde sağlayabilirsiniz. Ayrıca veritabanı sunucunuzu yalnızca localhost'tan gelen bağlantıları kabul edecek şekilde yapılandırabilirsiniz. Bu, sızdırılmış kimlik bilgileri durumunda dışarıdan erişimi engellemelidir.

Ayrıca LocalSettings.php hassas kısımlarını farklı bir dizindeki farklı bir dosyaya taşıma yöntemi için Manual:Securing database passwords sayfasına bakın.

Dosya içeriği

LocalSettings.php dosyasını düzenlediğinizde, tekrar doğru kodlamayla kaydettiğinizden emin olun. "ANSI as UTF-8" kodlamasını kullanmalısınız. Bu, bayt sıra işareti (BOM) olmadan UTF-8 kodlamasıdır.

LocalSettings.php, PHP kodu içerir; temel olarak değişkenlerin tanımı ve değerleri. Bir ayarı değiştirmek genellikle bir PHP değişkeninin değerini değiştirmek anlamına gelir. Değişiklikleriniz, dosyayı tekrar sunucuya kaydettikten hemen sonra geçerli olacaktır: Hiçbir şeyi manuel olarak "yeniden başlatmaya" gerek yoktur. Her neyse, bazı durumlarda yaptığınız değişiklikleri gerçekten görmek için tarayıcınızın önbelleğini temizlemeniz gerekebilir.

Yapılandırma ayarlarının varsayılan değerleri includes/MainConfigSchema.php içinde ayarlanmıştır ve düzenlenmemelidir; eğer değiştirmek istediğiniz değişken LocalSettings.php dosyanızda daha önceden belirtilmemişse, o dosyaya bir satır ekleyin ve uygun şekilde değiştirin. LocalSettings.php içine sonuna yeni satırlar ekleyebilirsiniz.

Dosyanın içerisinde ayrıca, uzantılara işaret eden require_once "$IP/extensions/UzantıAdı.php"; veya wfLoadExtension( 'UzantıAdı' ) gibi birkaç satır da bulunabilir. Bu satırlar, vikide uygun uzantıyı etkinleştirir. Bu uzantılar, LocalSettings.php içinde daha fazla değişkenin değerlerinin ayarlanmasını gerektirebilir; daha fazla talimat için ilgili uzantının belgelerine bakın.

MediaWiki'deki çoğu PHP dosyası gibi, LocalSettings.php PHP kapanış etiketi ?> ile bitmez. Bu, yöneticilerin yanlışlıkla bu etiketten sonra yeni bilgiler eklemesini önler. PHP bir kapanış etiketi olmadan iyi çalışır.

Bir MediaWiki'de viki çiftliğine bir vikiniz varsa, LocalSettings.php dosyasına yazma erişiminiz (belki de okuma erişiminiz bile olmayabilir) olmayabilir (örn. [1] sayfasına bakın). Viki çiftlik şirketi, istediğiniz değişiklikleri yapmaya istekli olabilir veya olmayabilir. Belki de viki çiftliğinin tüm vikilerinde çoğu ayarı aynı tutmak istiyor.

Bu dosya, güvenlik nedeniyle web sunucunuza otomatik olarak yazılmaz. Bunun yerine, vikinizin çalışmaya başlaması için daha sonra sunucunuza yüklemeniz gereken bir indirme olarak sunulur. Daha eksiksiz bir açıklama için bu açıklamaya bakın.

Mevcut ayarlara genel bakış

Tüm değişkenlerin ne yaptığı konusunda yardım için yapılandırma ayarları dizini ve ayar dosyalarında bulunan yorumlara bakın. En önemli değişkenlerin kısa bir listesi ve en çok istenen özellikler aşağıda listelenmiştir.

Standart ayarlar

Yol kurulumu

$IP (kurulum yolu) değişkeni, vikinizin temel kurulumunun yerel dosya yolunu tutar. MediaWiki 1.18'den beri sistem otomatik olarak $IP ayarlar. $IP ile LocalSettings.php olarak elle ayarlamak artık gerekli değildir. $IP geçerli çalışma dizinine varsayılan olacak ve elle tanımlamaya gerek kalmadan kullanılabilir. LocalSettings.php dosyasına $IP (veya MW_INSTALL_PATH) koymaya çalışmak beklenmedik sonuçlar doğurabilir.

Site adı

$wgSitename viki kurulumunuzun adını tutar. Bu ad, örneğin MediaWiki:Pagetitle aracılığıyla sistem genelinde birçok kez dahil edilir. Örneğin, Vikipedi sloganı "Vikipedi sitesinden, özgür ansiklopedi" bu ayarı kullanır.

Site adının düşüşleri

Arayüzün bazı çevirileri site adının bükülmesi için hazırdır. Uygun kelime biçimlerini $wgGrammarForms değişkenlerinde ayarlayabilirsiniz (örneğin lütfen $wgSitename belgelendirme sayfasına bakın).

Betik yolu

$wgScriptPath , MediaWiki'nin merkezi işlem kodu olan ana MediaWiki betiğine erişmek için URL yolu önekidir. Bu ayar, özellikle Apache'nin yeniden yazma kurallarını kullanıyorsanız, Apache ayarları ile uyumlu olmalıdır.

Sunucu adı

$wgServer , protokol dahil, ancak sonunda eğik çizgi ve varsa alt dizin olmadan sunucunun temel URL'sini içerir. Vikiye çalıştığı yerel ana bilgisayardan, bir intranetten veya internetten erişildiğinde, e-posta bildirimleri ve birkaç diğer hesaplanmış mesaj genellikle farklı URL'lerle teslim edilir.

MediaWiki 1.34'ten $wgServer, LocalSettings.php olarak ayarlanmalıdır. Bundan önce, MediaWiki sunucunun adını otomatik olarak algılamaya çalıştı ve otomatik algılamayı geçersiz kılmak için $wgServer isteğe bağlıydı.

www.example.com internetten görüldüğü gibi vikinizin sunucu adresiyse, aşağıdaki gibi bir satır ekleyin:

$wgServer = 'http://www.example.com';

Sihirli kelime değişkeni {{SERVER}} viki sayfalarında kullanılabilir; bu, $wgServer değerine eşittir; ancak, göreli URL'lerin kullanıldığı Wikimedia ailesindekiler gibi bir vikide, tam olarak genişlemeyecektir, örneğin burada //www.mediawiki.org görüntüleniyor, bu ne tıklanabiliyor ne de adres çubuğuna kopyalanıp yapıştırılabiliyor. olduğu gibi.

Aşağıda gösterildiği gibi bir protokole göre URL de kullanabilirsiniz. Protokol göreli URL'sini kullanırken $wgCanonicalServer değerini ayarladığınızdan emin olun. Kodun bazı yerlerinde, protokol ve ana bilgisayar adı içeren bir kökene ihtiyaç duyulduğu için $wgCanonicalServer ihtiyaç duyulur.

$wgServer = '//www.example.com';
$wgCanonicalServer = 'https://www.example.com';

Betik adı

$wgScript , varsayılan olarak index.php olarak adlandırılan ana (dizin) MediaWiki PHP betiğinin adıdır. Betik adını değiştirmek muhtemelen iyi bir fikir değildir. Ancak, bunu yapma ihtiyacı hissederseniz, değişikliklerinizi yapmak için doğru yer burasıdır. Ne yaptığınızı bildiğinizden emin olun.

Madde yolu

$wgArticlePath , MediaWiki'de bir sayfaya erişirken kullanılacak yoldur. Yol, ana betiğinin yolunu içermeli (genellikle $wgScript kullanılarak) ve madde adı için $1 yer tutucusunu kullanmalıdır.

Güzel ve kısa URL'ler oluşturmak için Apache yeniden yazma kuralları kullanıyorsanız, muhtemelen doğru yolu belirlemek için $wgArticlePath ögesini ayarlamanız gerekir. wgArticlePath'in MediaWiki içinden URL'ler oluşturmak için kullanıldığını unutmayın. Burada bir hata yaparsanız, doğru URL'yi elle belirterek ana sayfaya erişmeye devam edebilecekken dahili bağlantılar yanlış görünecektir. URL yapılandırması hakkında daha fazla bilgi için Manuel:Kısa URL sayfasına bakın.

Tipik değerler:

"$wgScript/$1" madde adını ayırıcı "/" ile iletin
"$wgScript?title=$1" madde adını parametre olarak iletin (eski stil)
"/mypath/$1" özel yol. "mypath" ana betiğine erişen uygun yola dönüştürmek için Apache yeniden yazma kurallarını kullanın

Stil sayfası konumu

MediaWiki kurulumu için stil sayfalarının (CSS) bulunduğu yerin URL yolunu ayarlamak için $wgStylePath kullanın. $wgStyleDirectory aynı yeri göstermelidir, ancak bunun dosya sistemine erişen dahili betiklerinde kullanım için yerel bir dosya sistemi yolu olduğunu unutmayın.

Yükleme konumu

Yükleme dizini, kullanıcılar tarafından yüklenen dosyaların depolandığı yerdir. $wgUploadPath URL yolunu belirtir, $wgUploadDirectory yerel dosya sistemi yolunu gösterir.

$wgLogos , çoğu MediaWiki kurulumunda sayfanın sol üst köşesinde hangi grafik logoların görüntüleneceğini belirtir.

Logonun nasıl değiştirileceğini öğrenmek için Manual:SSS sayfasına bakın.

İletişim bilgisi

$wgEmergencyContact , bir şeyler ters gittiğinde iletişime geçilecek kullanıcının e-posta adresidir. Bu e-posta adresi, dahili hata raporları göndermek için kullanılır. Hizmetli olarak, e-posta adresinizi buraya eklemek istiyorsunuz.

$wgPasswordSender , parolarını unutan kullanıcılara parolalar gönderildiğinde e-postanın kimden gönderildiği e-posta adresidir. Sorun veya karışıklık durumunda insanların yanıtlayabileceği bir adres seçin.

Veritabanı ayarları

MediaWiki'nin sayfaları, değişiklikleri, kullanıcı bilgilerini ve daha birçok şeyi depolamak için veritabanına (şu anda MySQL veya PostgreSQL) erişmesi gerekiyor.

$wgDBserver , veritabanının barındırıldığı ana bilgisayar adını içerir. Çoğu durumda, veritabanı aynı sistem üzerinde çalıştığından bu yalnızca "localhost" olacaktır, ancak dağıtılmış kurulumlar için, veritabanını çalıştıran bilgisayarın tam etki alanı adını doldurmanız gerekir.

$wgDBname , MediaWiki tarafından kullanılacak veritabanının veritabanı adıdır. Tek bir MySQL veya PostgreSQL kurulumu birden fazla veritabanı depolayabilir ve hatta tek bir sunucuda birçok MediaWiki kurulumunu çalıştırabilirsiniz. Burada doğru veritabanı adını belirttiğinizden emin olun ve aynı veritabanı sunucusunda farklı viki kurulumları için farklı veritabanı adları kullanın.

$wgDBuser ve $wgDBpassword , veritabanına erişmek için MediaWiki tarafından kullanılacak oturum açma adını ve parolayı içerir. Belirtilen kullanıcının, veritabanı sunucusundaki viki tablosunu değiştirebilmek için uygun erişim haklarına sahip olduğundan emin olun.

Ayrıca LocalSettings.php dosyanın hassas kısımlarını farklı bir dizindeki farklı bir dosyaya taşıma yöntemini görmek için Manual:Securing database passwords sayfasına bakın.

Kullanıcı hakları

$wgGroupPermissions , farklı kullanıcı gruplarınız için sayfa oluşturma ve düzenleme izinlerini kontrol eden bir ilişkisel dizidir. Bu dizide, özel izin seviyeleri oluşturulabilir ve farklı kullanıcı grupları için izin seviyeleri ayarlanabilir. Mevcut farklı izinler ve kullanıcı grupları hakkında daha fazla bilgi için Help:User rights sayfasına bakın.

Sermaye bağlantılarını zorla

Varsayılan olarak, hiçbir sayfa adı Roman harfi küçük harfle başlayamaz: bunu yapmak için ilk harf büyük harfe dönüştürülür; bir bağlantı hedefi, dahil edilen sayfa, resim veya kategori küçük harfle başlayan bir adla belirtilmişse, asıl hedef vb. ilgili büyük harfle başlayan sayfadır.

Alternatif olarak, sayfa adları büyük harf, rakam vb. ile başlama olasılıklarına ek olarak küçük harfle başlayabilir. Bunun için $wgCapitalLinks ile ayarlamanız gerekir. Bunu false olarak ayarlamak küçük harflere izin verir, true varsayılan davranışı seçer.

Alt sayfaları etkinleştirme

LocalSettings.php içinde, alt sayfalar $wgNamespacesWithSubpages kullanılarak ad alanı bazında etkinleştirilir. Örneğin, ana ad alanındaki alt sayfaları etkinleştirmek için:

$wgNamespacesWithSubpages[NS_MAIN] = 1;

Resim yüklemeleri

Kullanıcıların MediaWiki sistemine dosya yüklemesine izin verilmeden önce bu özelliği etkinleştirmeniz gerekir. Yükleme Dizininin Apache web sunucusu işlemi tarafından uygun şekilde yapılandırıldığından ve yazılabilir olduğundan emin olun. Ardından, web kullanıcı arayüzünde yüklemeye izin vermek için $wgEnableUploads ile true olarak ayarlayın.

yani, LocalSettings.php içine koymak için includes/DefaultSettings.php dosyasından bazı örnek kodlar:

$wgUploadPath       = "$wgScriptPath/uploads";      ## Wiki 1.5 varsayılan olarak /images dizidir, ancak yalnızca resimlere değil, daha fazlasına da izin verir
$wgUploadDirectory  = "$IP/uploads";                ## Wiki 1.5 varsayılan olarak /images dizidir, ancak yalnızca resimlere değil, daha fazlasına da izin verir

## Resim yüklemelerini etkinleştirmek için yukarıdaki '$wgUploadPath' dizininin Apache Kullanıcısı veya grubu tarafından yazılabilir olduğundan emin olun.
## ''(yani chmod og+w uploads images)'' sonra aşağıdakiler doğru olmalıdır:
$wgEnableUploads       = true;

$wgUseImageMagick      = true;
$wgImageMagickConvertCommand = "/usr/bin/convert";

## Güvenli modda resim yüklemelerini kullanmak istiyorsanız, dizinleri oluşturun
## images/archive, images/thumb ve images/temp, ardından hepsini yazılabilir olarak yapılandırın. Daha önce yapılmadıysa, şu satırın yorumunu kaldırın:
$wgHashedUploadDirectory = false;

Küçük resimleri desteklemek için resimleri anında yeniden boyutlandırabilmek istiyorsanız, MediaWiki'nin çalışan bir ImageMagick kurulumuna ihtiyacı vardır. ImageMagick'i sisteminize kurup test ettikten sonra $wgUseImageMagick ile true olarak ayarlayın. $wgImageMagickConvertCommand ögesinin kurulumunuzun convert komutunun doğru konumunu gösterdiğinden, komutun web sunucusu işlemi tarafından yürütülebildiğinden ve $wgMaxShellMemory yeterince büyük olduğundan emin olun. Ayrıntılı bilgi ve sorun giderme için Manual:Image administration#Image thumbnailing sayfasına bakın.

Ayrıca, $wgFileExtensions içinde saklanan kabul edilen uzantıların listesini değiştirmek isteyebilirsiniz:

$wgFileExtensions = [ 'png', 'jpg', 'jpeg', 'ogg', 'doc', 'xls', 'ppt', 'mp3', 'sxc', 'pdf' ];

ImageMagick'in aşağıdakine benzer bir hata mesajı vermesi durumunda:

Ölümcül hata: mime_magic başlatılamadı, magic dosyası includes/MimeMagic.php içinde 506. satırda mevcut değil

ardından aşağıdaki satırı LocalSettings.php dosyasına eklemeyi deneyin:

$wgMimeDetectorCommand = "file -bi";

Vikiarası desteği

Vikiarası desteği MediaWiki'de yerleşiktir ancak dahili bağlantılarınız için kullanılacak öneki yapılandırmanız gerekir. Bu önek genellikle $wgSitename ile aynıdır, ancak bunu değiştirmeniz gerekirse, $wgLocalInterwikis değişkenini tercih edilen ada ayarlarsınız.

Kullanıcı arayüzünün dili

MediaWiki, varsayılan İngilizce yerine çeşitli yerelleştirilmiş kullanıcı arabirimi dillerine izin verir. Vkinizi İngilizce olmayan bir dilde çalıştırmak istiyorsanız, $wgLanguageCode değişkenini uygun dil kodu olarak ayarlayın (ör. Almanca için "de", İspanyolca için "es" vb.)

languages/i18n dizinindeki bir dosyaya sahip dillerden herhangi birini kullanabilirsiniz. Örneğin. es.json dosyasını bulursanız, İspanyolca için "es" kullanabilirsiniz. Büyük harfle "Es" kullanmayın. İşe yarıyor gibi görünse de, tüm metinler tercüme edilmez.

Dil kodunu değiştirdikten sonra, çalışması için bir PHP betiği çalıştırmanız gerekecek. Bir terminal penceresinde viki dizininize geçin, maintenance klasörüne geçin ve php rebuildMessages.php --rebuild girin. Windows'ta PHP klasörü PATH ortam değişkeninizde olmayabilir ve programın yolunun önüne php eklemeniz gerekir.

Tüm diller desteklenmez. Hangi dillerin ne ölçüde desteklendiğine dair güncel bir liste için TranslateWiki'deki çeviri istatistiklerine bakın. Bu liste MediaWiki temelin mevcut durumunu yansıtmaktadır, dolayısıyla kullandığınız sürüme bağlı olarak bir tutarsızlık olabilir.

Site için telif hakkı ayarı

$wgRightsPage boş değilse, telif hakkı/lisans bildirimindeki bağlantı sitenizdeki ilgili sayfaya yönlendirilecektir. $wgRightsPage boşsa, telif hakkı/lisans bildirimi bunun yerine $wgRightsUrl ile yönlendirilecektir.

Sitenin telif hakkı beyanlarını değiştirmek için LocalSettings.php ile şunun gibi bir şey ekleyin:

$wgRightsPage = "YourWiki:Copyright";
$wgRightsText = "copyright YourWiki";

Daha sonra, "$1" için telif hakkı sayfanızın bağlantısının nerede olacağını belirtmek için kullanarak uygun bir mesaj sağlamak için MediaWiki:Copyright-footer sayfayı düzenleyin.

Örnek: bir Creative Commons lisansı ayarlama

Creative Commons lisansı ayarlamak için aşağıdakileri yapın:

<a rel="license" href="http://creativecommons.org/licenses/by-nc-sa/3.0/">
<img alt="Creative Commons License" border="0" src="http://creativecommons.org/images/public/somerights30.png" />
</a>
This work is licensed under a
<a rel="license" href="http://creativecommons.org/licenses/by-nc-sa/3.0/">
Creative Commons Attribution-NonCommercial-ShareAlike 3.0 License</a>.
  • $wgRightsURL için ilk bağlantıdaki href bilgisini girin:
$wgRightsUrl = "http://creativecommons.org/licenses/by-nc-sa/3.0/";
  • $wgRightsText için ikinci bağlantının bağlantısının metnini girin (daha dil bilgisi açısından doğru bir versiyon için Viki değişkenine "a" ekleyin)
$wgRightsText = "a Creative Commons Attribution-NonCommercial-ShareAlike 3.0 License";
  • $wgRightsIcon için ilk bağlantıdaki img bağlantısındaki kaynak bilgisini girin. Creative Commons sitesindeki rozeti kullanmak yerine, rozeti kendi sitenize kopyalamak istiyorsunuz.
$wgRightsIcon = "http://creativecommons.org/images/public/somerights30.png";

Özel ad alanları

$wgExtraNamespaces bildirerek ve $wgNamespacesWithSubpages ve $wgNamespacesToBeSearchedDefault değiştirilerek, MediaWiki kurulumuna fazladan ad alanları eklenebilir; ve $wgNamespaceAliases dizi ad alanı diğer adları bildirilerek eklenebilir. Örneğin, "Teknik:Destek" adlı bir sayfanız varsa ve Teknik: ad alanını oluşturduysanız, bu ad alanında önceden başlıklı sayfa olmamasına dikkat edin, o sayfa yalnızca kaybolmakla kalmaz, aynı zamanda Special:Allpages sayfasından kaldıramazsınız. Bunu düzeltmek için ad alanını silin, "Teknik:Destek" ögesini ana alanda "Destek" sayfasına taşıyın, yönlendirmeyi silin, ad alanını yeniden yerleştirin ve "Teknik:Destek" sayfasına geri taşıyın. Bunun nasıl yapılacağı hakkında daha fazla bilgi için Özel ad alanlarına bakın.

Görünümler

Sitenin varsayılan görünümü $wgDefaultSkin aracılığıyla değiştirilebilir.

Ayrıca bakınız