Manual:LocalSettings.php
MediaWiki dosyası: LocalSettings.php | |
---|---|
Konum: | / |
Kaynak kodu: | bu Git'te değil (yükleme sırasında oluşturulan) |
Sınıflar: |
LocalSettings.php
dosyası, bir MediaWiki kurulumunun temel yapılandırma ayarları ($3 dosyasına göre) 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 yüklediğiniz klasörde, includes/
ve skins/
gibi klasörlerle 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.
Daha birçok ayarın varsayılan değerleri includes/DefaultSettings.php
içinde ayarlanmıştır, düzenlenmemelidir; değiştirmek istediğiniz değişken zaten listenizde belirtilmemişse. LocalSettings.php
, DefaultSettings.php
içinden uygun satırı kopyalayın ve LocalSettings.php
içinde uygun şekilde değiştirin. LocalSettings.php
içinde, sonuna yeni satırlar ekleyebilirsiniz.
Within LocalSettings.php
you can add new lines at the end.
Dosya içinde, uzantıları işaret eden 'require_once "$IP/extensions/uzanti.php";
' gibi birkaç satır da olabilir. 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.
These lines enable the corresponding extension in the wiki.
Those extensions may require setting the values of more variables in LocalSettings.php
; check the documentation of the extension itself for further instructions.
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 wiki çiftliğinin tüm vikilerinde çoğu ayarı aynı tutmak istiyor.
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.
Attempting to set $IP
(or MW_INSTALL_PATH
) in LocalSettings.php
may produce unexpected results.
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.
When using a protocol relative URL, be sure to set $wgCanonicalServer
.
$wgCanonicalServer
is needed for some places in the code where an origin with a protocol and hostname is needed.
$wgServer = '//www.example.com';
$wgCanonicalServer = 'https://www.example.com';
Betik adı
$wgScript , varsayılan olarak index.php
adlı ana (indeks) MediaWiki PHP betiğinin adıdır. Betik adını değiştirmek muhtemelen iyi bir fikir değildir. Ancak, bunu yapma dürtüsünü hissediyorsanız, değişikliklerinizi yapacağınız 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.
Logo
$wgLogo , tüm MediaWiki sayfalarının sol üst köşesinde hangi grafik logonun görüntüleneceğini belirtir. Bu adımlar, /wiki/skins/common/images/ dizinindeki varsayılan logoyu, /wiki ile MediaWiki yazılımını kurduğunuz dizinin yolu ile değiştirir.
See Manual:SSS for how to change the logo.
İ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.
Also see Manual:Securing database passwords for a method to move the sensitive parts of LocalSettings.php
to a different file in a different directory.
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 defaults to /images, but allows more than just images
$wgUploadDirectory = "$IP/uploads"; ## Wiki 1.5 defaults to /images, but allows more than just images
## To enable image uploads, make sure the above '$wgUploadPath' directory is writable by Apache User or group.
## ''(i.e. chmod og+w uploads images)'' then the following should be true:
$wgEnableUploads = true;
$wgUseImageMagick = true;
$wgImageMagickConvertCommand = "/usr/bin/convert";
## If you want to use image uploads under safe mode, create the directories images/archive, images/thumb and
## images/temp, and make them all writable. Then uncomment this, if it's not already uncommented:
$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:
Fatal error: mime_magic could not be initialized, magic file is not available in includes/MimeMagic.php on line 506
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. WVkinizi İ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.
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. 1.44.0-wmf.5 (d64f667) yerelleştirme istatistiklerinin listesi için buraya bakın. Yayımlanan sürüm başına istatistikler için translatewiki.net adresine bakın. See the translation statistics on TranslateWiki for an up-to-date list of which languages are supported and to what extent. That list reflects the current state of MediaWiki core, so depending on what version you are using there may be a discrepancy.
Site için telif hakkı ayarı
- $wgRightsPage , vikide altına düştüğü telif haklarını kapsayan sayfadır. Genellikle bu Project:Telif hakları olacaktır.
- $wgRightsUrl , lisansınızın tüm ayrıntılarını açıklayan sayfadır. (Örneğin, GNU FDL için bu,
http://www.gnu.org/licenses/fdl.html
olacaktır.)
- $wgRightsText , alt bilgide "İçerik şurada mevcuttur" ifadesinin ardından gelen metindir.
$wgRightsPage
içinde belirtilen sayfaya bağlanacaktır.
- $wgRightsIcon , altbilginin soluna yerleştirilen resmin URL'sidir.
$wgRightsPage
boş değilse, telif hakkı/lisans bildirimindeki bağlantı sitenizdeki o sayfaya bağlantı verir. $wgRightsPage
boşsa, telif hakkı/lisans bildirimi bunun yerine $wgRightsUrl
ile bağlanır.Sitenin telif hakkı beyanlarını değiştirmek için LocalSettings.php
ile şunun gibi bir şey ekleyin:
$wgRightsPage = "YourWiki:Copyright";
$wgRightsText = "copyright YourWiki";
Ardından, telif hakkı sayfanızın bağlantısının olacağı konumu belirtmek için "
kullanarak uygun bir mesaj sağlamak için MediaWiki:Copyright sayfasını düzenleyin.
"$1"
"
Örnek: bir Creative Commons lisansı ayarlama
Creative Commons lisansı ayarlamak için aşağıdakileri yapın:
- Lisansınızı seçin: http://creativecommons.org/choose/
- Döndürülen HTML kodunu inceleyin, örneğin:
- Examine the returned HTML code, e.g.:
<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ı bağlantılarının geldiği metni girin (dil bilgisi açısından daha doğru bir sürüm 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ından src 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
- LocalSettingsGenerator.php kurulum sırasında
LocalSettings.php
dosyasının ilk içeriğini oluşturan kaynak kodu. - Viki aileleri aynı LocalSettings.php paylaşımını yapabilir.
- Manual:Securing database passwords - veritabanı parolalarınızı ve
LocalSettings.php
dosyanızı güvence altına almak için bir kılavuz.