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 69% complete.
Outdated translations are marked like this.
Uyarı Uyarı: LocalSettings.php ile Notepad, TextEdit veya dosyalara bayt sıralama işaretleri ekleyen diğer metin editörleri gibi belge editörleriyle değiştirmeyin. Bunlar, vikinizin PHP çalışma zamanını bozar. Bunun yerine, örneğin bir kod editörü kullanın. Vim, Notepad++ veya Atom. Bunlar dosya kodlamalarını uygun şekilde ele alır. Ayrıca, daha önce belge editörleri tarafından kırılan dosyaları onarmak için de kullanılabilirler.

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.

Bu dosya, güvenlik nedeniyle web sunucunuza otomatik olarak yazılmaz. Bunun yerine, wvkinizin ç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. 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.

$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.

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. 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ı

  • $wgRightsText , alt bilgide "İçerik şurada mevcuttur" ifadesinin ardından gelen metindir. $wgRightsPage içinde belirtilen sayfaya bağlanacaktır.
$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 ""$1"" kullanarak uygun bir mesaj sağlamak için MediaWiki:Copyright sayfasını düzenleyin.

Örnek: bir Creative Commons lisansı ayarlama

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

  • 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