Manual:LocalSettings.php/vi

File  cung cấp cáccài đặt cấu hình cơ bản(dựa trên file  ) của một cài đặt MediaWiki. Bạn phải chú ý xem lại các cài đặt trong file này. File này thường được tạo ra bởi trình cài đặt web-based MediaWiki nhưng bạn cũng có thể điều chỉnh các thông số, có lẽ liên quan đến các cài đặt Apache. Đối với các cài đặt MediaWiki được cấu hình như là một wiki farm, một file được đặt tên  có thể được sử dụng.

Vị trí trên server
File LocalSettings.php không phải là 1 trang wiki và bạn không thể truy cập tới nó trên trình duyệt của bạn. Thật ra, nó là 1 file trong hệ thống file của server. Nội dung của nó được tạo ra trong quá trình cài đặt wiki ban đầu và file kết quả phải được copy vào server thủ công. File đó phải nằm trong folder mà bạn cài đặt MediaWiki vào, cùng cấp với các folder như "includes/" hoặc "skins/" và các file như "api.php". Nếu file này không nằm ở đó, wiki sẽ không làm việc - nếu wiki làm việc, file này sẽ có ở đó. Nếu bạn không biết nó nằm ở đâu, bạn có thể chạy dòng lệnh này  trên UNIX shell để server của bạn chỉ cho bạn file này đang nằm ở vị trí nào.

Instead, it is a file in the file system of the server. Its contents are generated during the initial setup of the wiki, and the resulting file must be copied to the server manually. The file must be located in the folder you installed MediaWiki into, on the same level with folders like and   and files like. If this file is not there, the wiki will not work at all—if the wiki does work, the file is there. If you do not know where it is, you can enter a command such as find / -iname LocalSettings.php -print in a terminal window to locate it.

(If you are using Vagrant, see also MediaWiki-Vagrant#MediaWiki_settings.)

Bảo mật
LocalSettings.php thường chứa các dữ liệu nhạy cảm như database logins. Dữ liệu này không bao giờ được để lộ ra công cộng! Do một lỗ thủng bảo mật nào đó trên server, có thể người dùng nào đó có thể thấy được nội dung bên trong các file. Để tăng cường bảo mật cho dữ liệu của bạn, bạn phải đặt UNIX permissions cho file này để: webserver user phải được quyền truy cập vào file này. Nếu có cùng account, ai là chủ của file đó, thì bạn có thể đặt permissions giá trị 600. Đôi khi, webserver user không phải là chủ của file đó, nhưng anh ta lại là chủ của nhóm UNIX user. Trong trường hợp này, permissions có giá trị là 640. Để tăng độ bảo mật, bạn phải thu hẹp permissions xuống tới mức thấp nhất có thể. This data should never be revealed to the public! Due to a security breach somewhere on the server, it might happen that other users are able to view the contents of files. In order to improve security of your data, you should set UNIX permissions for this file accordingly: The webserver user must have access to this file. If this is the same account, who is the owner of the file, then you can set permissions to 600. Sometimes, the webserver user is not the file owner, but they are in the owner's UNIX user group. In this case, permissions of 640 should be fine. For improved security you should narrow permissions down as far as possible.

Thêm vào đó, bạn có thể tạo ra một MySQL user, người này chỉ bị cấm bởi database sử dụng bởi wiki và cung cấp giấy ủy nhiệm cho người này trong LocalSettings.php. Bạn cũng có thể cấu hình database server của mình theo các tương tự để chỉ chấp nhận các kết nối từ localhost - điều này sẽ ngăn chạn việc truy cập từ bên ngoài trong trường hợp bị rò rỉ các ủy nhiệm.

See also for a method to move the sensitive parts of   to a different file in a different directory.

Nội dung của file
Khi chỉnh sửa lại file LocalSettings.php, hãy đảm bảo rằng nó có quyền encoding trở lại. Bạn nên sử dụng "ANSI as UTF-8" encoding - đó là UTF-8 encoding không cần đánh dấu thứ tại byte (byte order mark -BOM).

chứa mã PHP ; chủ yếu là các định nghĩa của các biến và giá trị của chúng. Thay đổi một cài đặt thường có nghĩa là thay đổi giá trị của một biến PHP. Các thay đổi sẽ có hiệu lực ngay lập tức sau khi lưu lại tập tin trên máy chủ: Không cần phải "khởi động lại" bằng tay bất cứ thứ gì. Dù sao, trong một số trường hợp, bạn có thể cần phải xóa bộ nhớ cache trình duyệt của bạn để thực sự nhìn thấy những thay đổi mà bạn đã thực hiện.

Các giá trị mặc định của các thiết lập khác được đặt trong,  không nên chỉnh sửa làm gì; nếu các biến mà bạn muốn thay đổi chưa được đề cập đến trong   của bạn, sao chép các dòng thích hợp từ   và sửa đổi nó một cách thích hợp trong LocalSettings.php. Trong   bạn có thể thêm các dòng mới vào dưới cùng.

Trong file này, cũng có thể có một vài dòng như ' ', chỉ đến extensions. Những dòng này cho phép extension tương ứng trong wiki. Những extension này có thể yêu cầu thiết lập các giá trị của các biến trong ; kiểm tra tài liệu của extension tương ứng để biết thêm chi tiết.

Phiên bản của  có thể không kết thúc với một thẻ PHP đóng của  . Điều này được thực hiện nhằm mục đích, ngăn cản người nào đó vô tình thêm thông tin mới theo sau tag này. PHP sẽ hoạt động tốt mà không cần một thẻ đóng.

Nếu bạn có một wiki trên một MediaWiki wiki farm bạn có thể không có quyền ghi (có lẽ thậm chí không đọc) tập tin LocalSettings.php (xem ví dụ:  ). Wiki farm đi theo có thể có hoặc không sẵn sàng thực hiện thay đổi mà bạn mong muốn. Có lẽ nó muốn giữ cho hầu hết các thiết lập giống nhau trên tất cả các wiki của wiki farm.

Tổng quan về các thiết lập có sẵn
Xem configuration settings index và các ý kiến ​​nằm trong các tập tin cài đặt biết những gì tất cả các biến thực hiện. Một danh sách ngắn của các biến quan trọng nhất, cũng như các tính năng yêu cầu nhiều nhất, được liệt kê dưới đây.

Đường dẫn chứa wiki
Biến $IP (chứa đường dẫn) giữ đường dẫn tập tin địa phương tới các cài đặt cơ bản của wiki của bạn. Hãy chắc chắn rằng bạn chỉ đến đường dẫn tập tin này đầy đủ. Đừng bao gồm một dấu gạch chéo ở cuối đường dẫn. Từ MediaWiki 1.17, thiết $IP trong LocalSettings.php không còn cần thiết. Nó sẽ tự động mặc định tới thư mục làm việc hiện tại. Since MediaWiki 1.18, the system sets $IP automatically. Setting  manually in   is no longer needed. will default to the current working directory and can be used without the need to manually define it. Attempting to set  (or  ) in   may produce unexpected results.

File DefaultSettings.php được nạp từ thư mục được chỉ định bởi biến IP.

Tên site
Biến $Sitename giữ tên của cài đặt wiki của bạn. Tên này được gọi lại rất nhiều lần trên toàn hệ thống, chẳng hạn như qua MediaWiki:Pagetitle (Tiêu đề của trang). Ví dụ, khẩu hiệu Wikipedia "Từ Wikipedia, bách khoa toàn thư miễn phí" sử dụng cài đặt này.

Sự biến cách của tên trang web
Một số bản dịch giao diện sẵn sàng cho việc uốn tên trang web. Bạn có thể thiết lập 'các hình thức của từ' thích hợp trong biến $GrammarForms. You can set proper forms of word in variables ' (for example please refer to the ' documentation page).

Ngôn ngữ của trang
Biến $LanguageCode kiểm soát ngôn ngữ giao diện của trang wiki của bạn. Trong khi người dùng có thể chuyển đổi ngôn ngữ mà họ nhìn thấy trong tùy chọn của họ, biến này đặt ngôn ngữ mặc định mà tất cả người dùng vô danh và người dùng đã đăng ký mới nhất phải thấy. While users can switch the language they see in their preferences, this variable sets the default language that all anonymous users and most registered users see.

Đường dẫn Script
$ScriptPath là tiền tố đường dẫn URL để truy cập các tập lệnh MediaWiki chính, đó là trung tâm hoạt động của mã nguồn của MediaWiki. Thiết lập này phải tương ứng với các cài đặt Apache, đặc biệt là nếu bạn đang sử dụng các qui tắc ghi đè của Apache. This setting should correspond to the Apache settings, especially if you are using Apache's rewrite rules.

Tên Server
 có thể được tùy ý sử dụng để ghi đè lên các phát hiện tự động. Khi wiki được truy cập từ một trong 2 localhost nơi nó chạy, từ một mạng nội bộ hoặc từ internet, các thông báo e-mail và một vài thông điệp máy tính khác sẽ thường được phân phối với các URL khác nhau. Sử dụng  ghi đè  phát hiện và tên máy chủ sẽ là hằng số.

From MediaWiki 1.34  must be set in LocalSettings.php. Prior to that, MediaWiki tried to autodetect the name of the server and  was optional, to override the autodetection.

Nếu www.example.com là địa chỉ máy chủ của wiki của bạn như nhìn thấy từ internet, thêm một dòng như sau:

Biến magic từ  có thể được sử dụng trên các trang wiki; nó bằng giá trị của  ; Tuy nhiên, trên một wiki, chẳng hạn như những trang trong gia đình WikiMedia, nơi các URL liên quan được sử dụng, nó sẽ không hoàn toàn mở rộng, ví dụ ở đây nó sẽ hiển thị, mà có thể không được nhấp được hay sao chép-dán được vào thanh địa chỉ như bình thường.

You can also use a protocol relative URL as shown below. When using a protocol relative URL, be sure to set. is needed for some places in the code where an origin with a protocol and hostname is needed.

Tên script
 là tên của kịch bản PHP chính của MediaWiki (index), được đặt tên là  theo mặc định. Thay đổi tên kịch bản có thể không phải là một ý tưởng hay. Tuy nhiên, nếu bạn cảm thấy đôn đốc để làm như vậy, đây là nơi để thực hiện thay đổi của bạn. Hãy chắc chắn là bạn biết những gì bạn đang làm.

Đường dẫn bài viết
 là đường dẫn để sử dụng khi truy cập vào một trang trong MediaWiki. Đường dẫn nên chứa đường dẫn đến kịch bản chính (thường phải sử dụng  ) và sử dụng giữ chỗ   cho tên bài viết.

Nếu bạn đang sử dụng Apache để viết lại các quy tắc để tạo nên các URL đẹp và ngắn gọn, bạn có thể cần phải điều chỉnh  để chỉ đến đường dẫn đúng. Lưu ý rằng wgArticlePath được sử dụng để xây dựng các URL từ trong MediaWiki. Nếu bạn mắc một sai lầm ở đây, các liên kết nội bộ sẽ hiển thị không chính xác trong khi bạn vẫn có thể truy cập vào trang chính bằng cách chỉ định URL chính xác theo cách thủ công. Xem hướng dẫn sử dụng:URL ngắn gọn để biết thêm thông tin về cấu hình URL.

Các giá trị điển hình làː

Vị trí Stylesheet
Sử dụng biến $StylePath để thiết lập đường dẫn URL tới nơi stylesheets (CSS) cho việc cài đặt MediaWiki được đặt. Biến $StyleDirectory nên chỉ tới cùng một vị trí, nhưng lưu ý rằng đây là một đường dẫn hệ thống tệp cục bộ để sử dụng trong nội bộ tập lệnh truy cập đến hệ thống tập tin  should point the same place, but note that this is a local file system path for use in internal scripts accessing the file system.

Vị trí upload
Thư mục tải lên là nơi các tập tin được tải lên bởi người sử dụng. Biến $UploadPath chỉ định đường dẫn URL, $UploadDirectory chỉ đến đường dẫn hệ thống tệp cục bộ.

Logo
Biến  chỉ định biểu tượng logo đồ họa nào được hiển thị ở góc trên bên trái của tất cả các trang mediawiki. Các bước sau thay thế biểu tượng mặc định trong thư mục /wiki/skins/common/images/, thay thế /wiki với đường dẫn đến thư mục nơi bạn cài đặt phần mềm MediaWiki.

Trước tiên, sao chép bất kỳ biểu tượng nào bạn muốn vào thư mục /wiki/skins/common/images/ (thay thế /wiki với đường dẫn đến thư mục nơi bạn cài đặt phần mềm MediaWiki).

Tiếp theo, cố gắng tìm dòng trông giống như thế này trong :

Nếu không có dòng như vậy, bạn có thể sao chép và dán dòng ở trên vào cuối của tập tin.

Sau đó, sửa đổi dòng này để trỏ tới biểu tượng của bạn. Biểu tượng phải có thể truy cập được bằng web. Giá trị của biến này được thông qua trình duyệt web, trình duyệt web sẽ sử dụng nó để lấy biểu tượng. Nếu nghi ngờ, cách tốt nhất để chọn những gì để đặt ở đây là điều hướng đến biểu tượng trong trình duyệt web của bạn (ví dụ: url của logo wiki này là http://upload.wikimedia.org/wikipedia/mediawiki/b/bc/Wiki.png), và đặt url đầy đủ này làm giá trị của biến này.

Một số người chỉ cần thay thế tập tin skins/common/images/wiki.png với logo của họ. Điều này không được khuyến khích, vì biểu tượng tùy chỉnh này sẽ được ghi đè lên khi nâng cấp.

MediaWiki 1.35 introduced , which allows multiple versions of the same logo. An example of using multiple logos is shown below.

Thông tin liên lạc
Biến  là địa chỉ e-mail của người dùng để liên hệ nếu gặp khó khăn. Địa chỉ thư điện tử này được sử dụng để gửi báo cáo lỗi nội bộ. Là một quản trị viên, bạn muốn để địa chỉ e-mail của bạn ở đây.

Biến  là địa chỉ e-mail mà e-mail được gửi đến từ, khi mật khẩu được gửi cho người sử dụng đã quên mật khẩu của họ. Chọn một địa chỉ mà người đó có thể hồi âm trong trường hợp gặp khó khăn hoặc nhầm lẫn.

Cài đặt database
MediaWiki cần quyền truy cập vào cơ sở dữ liệu (hiện tại hoặc là MySQL hoặc  PostgreSQL) để lưu trữ trang, sửa đổi, thông tin người dùng, và rất nhiều thứ nữa.

 có chứa tên máy chủ nơi cơ sở dữ liệu được lưu trữ. Trong hầu hết trường hợp, nó sẽ chỉ là "localhost" là cơ sở dữ liệu chạy trên cùng hệ thống, nhưng đối với các cài đặt phân tán, bạn cần phải điền vào tên miền điều kiện đầy đủ của máy tính chạy cơ sở dữ liệu đó.

 là tên cơ sở dữ liệu của cơ sở dữ liệu được sử dụng bởi MediaWiki. Một cài đặt MySQL hoặc PostgreSQL duy nhất có thể lưu trữ nhiều hơn một cơ sở dữ liệu và bạn thậm chí có thể chạy nhiều cài đặt MediaWiki trên một máy chủ duy nhất. Đảm bảo rằng bạn đã khai báo cơ sở dữ liệu chính xác được kể ra ở đây và sử dụng các tên cơ sở dữ liệu khác nhau cho việc cài đặt các wiki khác nhau trên cùng một máy chủ cơ sở dữ liệu.

Các biến ' và ' chứa tên đăng nhập và mật khẩu được sử dụng bởi MediaWiki để truy cập vào cơ sở dữ liệu. Đảm bảo rằng người dùng đã chỉ định có quyền truy cập thích hợp để có thể thao tác các bảng của wiki trên máy chủ cơ sở dữ liệu.

Also see for a method to move the sensitive parts of   to a different file in a different directory.

Quyền của người dùng
 là một mảng kết hợp, kiểm soát quyền truy cập để tạo và chỉnh sửa các trang cho các nhóm người dùng khác của bạn. Trong mảng này, các cấp cho phép tùy chỉnh có thể được tạo ra, và các cấp cho phép cho các nhóm người dùng khác có thể được thiết lập. Xem thêm để biết thêm thông tin về các quyền hạn khác nhau và các nhóm người dùng có sẵn.

Force capital links
By default, no page name can start with a lowercase Roman letter: in an attempt to do so the first letter is converted to uppercase; if a link target, included page, image or category is specified with a name starting with a lowercase letter, the actual target etc. is the page starting with the corresponding capital.

Alternatively page names can start with a lowercase letter, in addition to the possibilities of starting with a capital, a digit, etc. For that you must adjust . Setting it to false allows lowercase characters, true chooses the default behavior.

Cho phép các trang con
In, subpages are enabled on a per-namespace basis using . For example, to enable subpages in the main namespace:

Upload hình ảnh
Trước khi người dùng được phép tải lên các tập tin vào hệ thống MediaWiki, bạn phải kích hoạt tính năng này. Đảm bảo rằng Thư mục Tải lên được cấu hình đúng và có thể ghi bởi quá trình máy chủ web Apache. Sau đó đặt giá trị biến  thành true để cho phép tải lên giao diện người dùng web.

tức là, đây là một số ví dụ mã nguồn từ includes/DefaultSettings.php để đặt vào trong LocalSettings.php.

If you want to be able to resize images on the fly to support thumbnails, MediaWiki needs a working ImageMagick installation. Set  to true once you have installed and tested ImageMagick on your system. Make sure ' points to the proper location of the  command of your installation, that the command is executable by the web server process, and ' is large enough. See for detailed information and troubleshooting.

Ngoài ra, bạn có thể muốn thay đổi danh sách các phần mở rộng đã chấp nhận, được lưu trữ trong mảng $FileExtensions:

Trong trường hợp gặp rắc rối với ImageMagick, và gặp thông báo lỗi sau:
 * Fatal error: mime_magic could not be initialized, magic file is not available in includes/MimeMagic.php on line 506

Thử thiêm dòng sau vào LocalSettings.php: $wgMimeDetectorCommand = "file -bi";

Hỗ trợ liên wiki
Hỗ trợ Hỗ trợ liên Wiki được tích hợp sẵn vào MediaWiki, nhưng bạn cần phải đặt cấu hình tiền tố được sử dụng cho các liên kết nội bộ của bạn. Tiền tố này thường là giống như $Sitename, nhưng trong trường hợp bạn cần phải thay đổi như vậy, bạn đặt biến $LocalInterwiki thành tên ưa thích. This prefix is usually the same as, but in case you need to change that, you set the variable to the preferred name.

Ngôn ngữ của giao diện người dùng
MediaWiki cho phép cho một loạt các địa phương hóa giao diện người sử dụng ngôn ngữ thay vì sử dụng tiếng Anh làm mặc định. Nếu bạn muốn chạy wiki của bạn trong một ngôn ngữ không phải tiếng Anh, thiết lập biến cho đúng language code (ví dụ như "vi" cho tiếng Việt, "de" cho tiếng Đức, "es" cho tiếng Tây Ban Nha, .v.v.)

Bạn có thể sử dụng bất kỳ ngôn ngữ nào được tìm thấy trong các thư mục language. Ví dụ, nếu bạn tìm thấy MessagesEs.php, bạn có thể sử dụng " " cho tiếng Tây Ban Nha. Không sử dụng " " với một chữ cái in hoa. Mặc dù nó có vẻ làm việc, không phải tất cả các dòng chữ đều được dịch.

Không phải tất cả mọi ngôn ngữ đều được hỗ trợ. Xem here để biết danh sách các thống kê địa phương hóa của. Xem translatewiki.net cho các thống kê cho mỗi phiên bản phát hành.

Cài đặt bản quyền cho trang web

 *  là trang trên wiki bao gồm các bản quyền mà nó thuộc. Thông thường, sẽ là Project:Bản quyền.
 * $RightsUrl là trang mô tả chi tiết đầy đủ các giấy phép của bạn. (Ví dụ GNU FDL, sẽ là .)
 * $RightsText là văn bản ở footer của trang theo sau "Nối dung có giá trị theo" . Nó sẽ được liên kết đến trang đặc biệt trong.
 * $RightsIcon là URL của hình ảnh được đặt ở bên trái của footer
 * Lưu ý: Nếu  là không trống, liên kết trong các thông báo bản quyền/giấy phép sẽ liên kết đến trang đó trên trang web của bạn. Nếu   trống, sau các thông báo bản quyền/giấy phép sẽ liên kết đến   để thay thế.
 *  is the page describing full details of your license. (For the GNU FDL, for example, this would be .)
 *  is the text in the footer that follows "Content is available under". It will be linked to the page specified in.
 *  is the URL of the image placed at the left of the footer.

Để sửa đổi các điều khoản bản quyền của trang web, thêm một cái gì đó như thế này vào LocalSettings.php :

Sau đó, chỉnh sửa MediaWiki:Copyright để cung cấp một thông điệp thích hợp, sử dụng  để chỉ ra vị trí nơi sẽ liên kết đến trang bản quyền của bạn.

Ví dụ: cài đặt một giấy phép Creative Commons

Để thiết lập một giấy phép Creative Commons làm như sau:


 * Chọn giấy phép của bạn: http://creativecommons.org/choose/
 * Kiểm tra mã HTML trả lại, ví dụ:


 * Đối với  nhập thông tin href từ anchor đầu tiên:
 * Đối với  nhập văn bản các liên kết anchor thứ hai từ (thêm "a" để biến Wiki cho một phiên bản đúng ngữ pháp hơn)
 * Đối với  nhập thông tin src từ liên kết img trong anchor đầu tiên. Bạn muốn sao chép các thẻ ra vào cho trang web của riêng bạn thay vì sử dụng từ trang web Creative Commons.
 * Để sử dụng siêu dữ liệu RDF về quyền tác giả thêm một hoặc cả hai dòng sau vào  của bạn:

Tùy biến không gian tên
Bằng cách khai báo mảng $ExtraNamespaces, và sửa đổi các mảng $NamespacesWithSubpages, và $NamespacesToBeSearchedDefault, không gian tên thêm có thể được thêm vào một cài đặt MediaWiki ; và bằng cách khai báo mảng $wgNamespaceAliases bí danh namespace có thể được thêm vào. Hãy chú ý không có bất kỳ trang nào đã đặt tên theo không gian tên đó, ví dụ như bạn đã có một trang gọi là "kỹ thuật:Hỗ trợ" và bạn tạo ra Kỹ thuật:namespace, thì sau đó trang đó sẽ không chỉ bị mất, mà bạn còn không thể remove nó từ Special:Allpages. Để khắc phục điều này, xóa không gian tên, di chuyển " Kỹ thuật:Hỗ trợ" thành "hỗ trợ" trong mainspace, xóa các trang chuyển hướng, lắp lại không gian tên, và di chuyển nó trở lại "kỹ thuật: Hỗ trợ". Xem Tùy chỉnh không gian tên để biết thêm thông tin. Take heed not to have any pages already titled in that namespace, for instance if you had a page called "Technical:Support" and you created the Technical: namespace, then that page would not only be lost, but you cannot remove it from Special:Allpages. To fix this delete the namespace, move "Technical:Support" to "Support" in mainspace, delete the redirect, reinsert the namespace, and move it back to "Technical:Support". See for more information as to how to do so.

Giao diện
Giao diện mặc định của trang web có thể được sửa đổi thông qua biến .

Xem thêm

 * Mã nguồn, tạo ra tập tin LocalSettings.php.
 * Họ Wiki có thể chia sẻ cùng.
 * Manual:Bảo mật mật khẩu cơ sở dữ liệu - một hướng dẫn để đảm bảo mật khẩu cơ sở dữ liệu của bạn và file.
 * - a guide to securing your database passwords and  file.