미디어위키/LocalSettings.php 편집하기

귀하는 로그인되어 있지 않습니다. 이대로 편집하면 귀하의 IP 주소가 편집 기록에 남게 됩니다.

편집을 취소할 수 있습니다. 이 편집을 되돌리려면 아래의 바뀐 내용을 확인한 후 게시해주세요.

최신판 당신의 편집
2번째 줄: 2번째 줄:


==이 파일은==
==이 파일은==
[[미디어위키]]의 거의 모든<ref>스킨단에서 처리하는 경우 등을 제외한 거의 99%의 경우</ref> 설정은 이 파일을 건들어야 한다. LocalSettings.php는 DB 정보를 포함한 기본적인 정보 뿐만 아니라, 확장기능의 목록/설정 등도 이 파일로 관리한다.
# [[미디어위키]]의 거의 모든<ref>스킨단에서 처리하는 경우 등을 제외한 거의 99%의 경우</ref> 설정은 이 파일을 건들어야 한다.
 
# DB 정보를 포함한 기본적인 정보 뿐만 아니라, 확장기능의 목록/설정 등도 이 파일로 관리한다.
이 파일은 미디어위키 설치중에 생성되며, 설치 맨 마지막에 위키 개설자가 이 파일을 위키 최상단(index.php이 있는 곳)에 업로드 해야 한다.
# 미디어위키 설치중에 생성되며, 설치 맨 마지막에 위키 개설자가 이 파일을 위키 최상단(index.php이 있는 곳)에 업로드 해야 한다.


==보안==
==보안==
이 파일은 '''절.대.로!''' 외부에서 접근 할 수 없도록 해야 한다. 왜냐하면 이 파일 내에는 DB 정보 뿐만 아니라 설정값 중에서 개인정보(SMTP 설정때 등)등이 포함되어 있기 때문이다.
# 이 파일은 '''절.대.로!''' 외부에서 접근 할 수 없도록 해야 한다.
# DB 정보 뿐만 아니라 설정값 중에서 개인정보(SMTP 설정때 등)등이 포함되어 있기 때문이다.


==관리 가능한 부분==
==관리 가능한 부분==
===DB 정보===
===DB 정보===
* '''Mysql/MariaDB'''를 기준으로 설명합니다.
* '''Mysql/MariaDB'''를 기준으로 설명합니다.
 
# LocalSettings.php로 DB 정보를 관리 할 수 있습니다.
LocalSettings.php로 DB 정보를 관리 할 수 있습니다. 이 파일로 DB를 설정 할 수 있는 범위는 아래와 같습니다.
# 이 파일로 DB를 설정 할 수 있는 범위는 아래와 같습니다.
* DB 타입(mysql/sqlite 등) - $wgDBtype
## DB 타입(mysql/sqlite 등)
* DB 서버(기본값 localhost) - $wgDBserver
## DB 서버(기본값 localhost)
* DB 이름 - $wgDBname
## DB 이름
* DB 아이디(유저) - $wgDBuser
## DB 아이디(유저)
* DB 비밀번호 - $wgDBpasswird
## DB 비밀번호
* 테이블 접두사(입력한 접두사가 그대로 사용되므로, 접두사를 구분하기 위해 _(언더바)를 사용하자.) - $wgDBprefix
## 테이블 접두사(입력한 접두사가 그대로 사용되므로, 접두사를 구분하기 위해 _(언더바)를 사용하자.)
* DB 옵션(InnoDB/MyISAM) / 언어셋(바이너리/UTF) - $wgDBTableOptions
## DB 옵션(InnoDB/MyISAM)
 
## 언어셋(바이너리/UTF)
서버를 이전하는 등 DB 정보가 변경된 경우, 위의 항목에서 변경된 부분만 수정하면 된다. 예를 들어 DB 아이디가 변경된 경우, DB 아이디 부분만 수정하면 된다.
# 서버를 이전하는 등 DB 정보가 변경된 경우, 위의 항목에서 변경된 부분만 수정하면 된다.
 
DB 옵션의 경우, InnoDB를 권장한다. MyISAM의 경우, 테이블 사용 시 락이 걸리기 때문에 여러 유저가 편집하는 경우 오래걸리기 떄문이다.
 
===위키 이름===
===위키 이름===
위키 이름을 설정 할 수 있다. 위키 이름은 공백을 허용한다. 하지만 프로젝트 명($wgMetaNamespace), 네임스페이스는 공백을 허용하지 않는다. 공백이 필요한 경우, _(언더바)를 활용하자.
# 위키 이름을 설정 할 수 있다.
 
# 위키 이름은 공백을 허용한다.
===스킨===
# 하지만 프로젝트 명($wgMetaNamespace), 네임스페이스는 공백을 허용하지 않는다. 공백이 필요한 경우, _(언더바)를 활용하자.
====$wgDefaultSkin====
위키 내에서 사용할 스킨의 기본값을 설정할 수 있다.
 
다음과 같이 사용한다.
 
<syntaxhighlight lang='PHP'>
$wgDefaultSkin = "liberty";
</syntaxhighlight>
 
아래의 [[#wfLoadSkin]]에 없는 스킨을 설정하는 경우 오류가 발생한다.
 
대문자가 아닌 소문자로만 작성해야 한다.
 
기본값이기 때문에 로그인 이후 개인 설정을 통해 다른 스킨으로 변경 할 수 있다.<ref>해당 계정에만 적용된다.</ref>
 
====스킨 불러오기====
=====wfLoadSkin=====
사용할 스킨을 불러오는 기능으로, "./skins" 폴더에 해당 스킨 폴더가 있어야 한다.<ref>반드시 skins 폴더에 있는 모든 스킨을 적을 필요는 없다. 그러나 사용하기 위해서는 적어야 한다.</ref><ref>wfLoadSkin으로 불러온 스킨들은 개인 설정 페이지에서 리스트로 나온다.</ref>
 
폴더명과 스킨 폴더 내부에 있는 파일들의 이름<ref>스킨명Template.php 등</ref>이 일치해야 한다.<ref>대소문자 구분</ref> 예를 들어 파일명이 LibertyTemplate.php 이라면, 폴더명도 Liberty로 동일해야 한다.
 
=====require_once (스킨)=====
확장기능에서의 require_once는 [[#require_once (확장기능)|require_once (확장기능)]] 문단을 확인하세요.
 
미디어위키 구버전에서는 require_once로 스킨을 불러왔었다.
 
이때 스킨의 경로를 입력해야 하기에 관리하기에 있어서 불편하다.
 
현재는 위의 [[#wfLoadSkin|wdLoadSkin]]으로 불러오면 되기 때문에 필요 없어진 방법이다.
 
===확장기능===
====wfLoadExtension====
위키에서 사용 할 확장기능을 등록하는 것으로, wfLoadExtension으로 등록된 확장기능은 사용 할 수 있다.
 
다만 wfLoadExtension으로 사용 설정한 확장기능들 중에서 추가 설정이 필요한 확장기능들도 존재한다.
 
====require_once (확장기능)====
스킨에서 사용하는 require_once는 [[#require_once (스킨)|require_once (스킨)]] 문단을 확인하세요.
 
미디어위키 1.25 이전 버전에서는 require_once으로 확장기능의 경로를 적어서 불러왔었다.
 
현재의 대부분의 확장기능은 위의 [[#wfLoadExtension|wfLoadExtension]]으로 적으면 되지만, 몇몇 확장기능들은 1.25버전 이후 버전을 사용하더라도 require_once를 써야 한다고 안내한다.
 
require_once는 보통은 '''<nowiki>"$IP"</nowiki>'''와 변수<ref>도메인 최상위. 예를 들어 https://example.com/</ref> 같이 사용하며,
 
<syntaxhighlight lang='PHP'>
require_once "$IP/extensions/sample/sample.php";
</syntaxhighlight>
 
위와 같이 사용한다.


==각주==
==각주==
가온 위키에서의 모든 기여는 크리에이티브 커먼즈 저작자표시-동일조건변경허락 라이선스로 배포된다는 점을 유의해 주세요(자세한 내용에 대해서는 가온 위키:저작권 문서를 읽어주세요). 만약 여기에 동의하지 않는다면 문서를 저장하지 말아 주세요.
또한, 직접 작성했거나 퍼블릭 도메인과 같은 자유 문서에서 가져왔다는 것을 보증해야 합니다. 저작권이 있는 내용을 허가 없이 저장하지 마세요!
취소 편집 도움말 (새 창에서 열림)

이 문서에서 사용한 틀: