Příručka:Instalace MediaWiki

From mediawiki.org
This page is a translated version of the page Manual:Installing MediaWiki and the translation is 99% complete.

MediaWiki se instaluje pomocí interaktivního webového instalačního skriptu (umožňujícího vzájemnou komunikaci). Předtím než spustíte tento skript, musíte udělat pár věcí: Podívejte se na požadavky pro instalaci nebo na krátkou instalační příručku pro experty.

MediaWiki může být náročná na instalaci pro každého, kdo nemá zkušenosti s Apache, PHP a MySQL/MariaDB. Většina uživatelů, kteří chtějí používat wiki software, může mít úspěch při použití bezplatného hostitele MediaWiki nebo softwarových balíčků.

Pro informace o řešení problémů použijte Návod:Chyby a příznaky#Chyby instalace.

Stažení software MediaWiki

Webový prohlížeč

Stáhněte si soubor tar MediaWiki z oficiální stránky pro stažení. Obecně platí, že pokud používáte produkční prostředí, chcete používat nejnovější stabilní verzi, kterou je mediawiki-1.38.2.tar.gz.

Příkazový řádek (*nix machine)

Chcete-li stahovat MediaWiki 1.38.2, což je nejnovější stabilní verze, můžete použít následující příkaz:

wget https://releases.wikimedia.org/mediawiki/1.38/mediawiki-1.38.2.tar.gz

Jinak použitím cURL:

curl -O https://releases.wikimedia.org/mediawiki/1.38/mediawiki-1.38.2.tar.gz

Stažené soubory jsou ve formátu .tar.gz, takže musí být před použitím rozbaleny (extrahovány). Rozbalení může být uskutečněno lokálně na váš počítač (a potom nahráno použitím FTP) nebo přímo na váš server. Rozbalení je obvykle děláno se softwarem 7-Zip (zdarma), WinZip, WinRAR nebo IZArc (zdarma) na Windows. Na operačních softwarech Linux a Mac OS X můžete soubor extrahovat použitím tohoto příkazu:

tar -xf mediawiki-*.tar.gz
Pokud archiv zrušíte jako root, pravděpodobně byste později měli změnit vlastnictví pomocí chown, jinak budou soubory nakonec vlastněny jako uživatel s ID 1000, což může, ale nemusí být to, co chcete.


Git (pro vývojáře)

Vývojáři by na druhou stranu měli pravděpodobně stahování z Gitu nastavit na místní úložiště s nejnovějším vývojovým kódem.

Rovněž budou muset ručně instalovat závislosti pomocí Composer .

Nahrání souborů na váš server

Pokud ještě nemáte soubory nahrané na server, udělejte to takto:

Nahrajte soubory do úložiště serveru buď:

  1. přímo zkopírováním extrahované složky nebo
  2. použitím FTP klienta jako FileZilla (Open Source Software, Windows, OSX a Linux) nebo Cyberduck (také OSS, Windows a OSX).
  3. by using cPanel File Manager (see below)

Pokud má váš nahrávací nástroj možnost "změnit názvy souborů na malá písmena", musíte to zakázat.

Pokud máte nainstalován Apache, správný adresář je zadán ve vašem souboru httpd.conf (je to DocumentRoot obvykle /var/www/ nebo <apache-folder>/htdocs). Poznámka: To se změnilo v Ubuntu 14.04 s Apache 2.4.7, kde primární konfigurační soubor pro nastavení a adresáře serveru Apache je /etc/apache2/apache2.conf.

Pokud používáte server Linux nebo Unix, můžete místo toho zkopírovat soubory do jakéhokoli adresáře ve vašem serveru a potom udělat symbolický odkaz do této složky z webového adresáře webového serveru.

Přejmenujte nahranou složku na cokoliv co chcete mít v URL. Pokud váš webový server pracuje například jako http://localhost, přejmenování na adresář /w/ by znamenalo, že byste přistupovali ke své wiki za http://localhost/w/index.php. Nepoužívejte /wiki/, pokud jej chcete použít jako krátkou URL adresu (Short URL). (A nenastavujte krátké adresy URL, dokud nespustíte instalační skript.)

V některých případech, například když je lokální úložiště nastaveno s použitím Gitu, by při procházení na index.php mohl Linuxový server zobrazit "500 Internal server Error". To je možná chyba oprávnění, kterou lze vyřešit změnou oprávnění souboru a adresáře spuštěním následujícího příkazu v SSH po změně adresáře na "w":
find . -type f -exec chmod 644 {} \;
find . -type d -exec chmod 755 {} \;

Tato (přejmenovaná) složka bude nyní označena jako <MediaWiki-folder>.

Správce souborů cPanel

cPanel je populární rozhraní, které používá mnoho webových hostitelů. Tato metoda je účinná, protože soubory nejsou zhuštěné na samotném serveru.

  • Přejděte do adresáře, kam chcete umístit složku wiki.
  • Nahrajte soubor mediawiki-1.xx.x.tar.gz. Abyste jej viděli, bude možná nutné stisknout "Reload" (znovu načíst).
  • Rozbalte soubor mediawiki-1.xx.x.tar.gz. Znovu načtěte.
  • Potvrďte přítomnost složky mediawiki-1.xx.x.
  • Odstraňte soubor tar.gz.
  • Přejmenujte složku mediawiki-1.xx.x na w.

Vytvoření databáze

Pokud již máte databázový server a znáte pro něj root heslo, instalační skript MediaWiki vám pomůže vytvořit novou databázi. V takovém případě můžete přejít do níže uvedené části Spuštění instalačních skriptů. Pokud neznáte heslo uživatele root, například pokud jste na hostovaném serveru, budete si muset vytvořit novou databázi. V současné době musíte použít SQLite, MariaDB, MySQL nebo PostgreSQL k uložení skutečného obsahu vaší wiki. Pokud si nejste jisti, kterou databázi zvolit, použijte MariaDB. Je nejlépe podporována MediaWiki.

SQLite

SQLite je samostatná databázová knihovna, která ukládá obsah databáze do jednoho souboru. Pokud PHP obsahuje modul pdo-sqlite, není nutné žádné další nastavení.

Na instalační stránce budete muset vybrat název databáze (libovolný) a adresář databáze SQLite. V adresáři databáze se instalační program pokusí použít podadresář mimo kořen dokumentu a v případě potřeby jej vytvořit. Pokud tento adresář není bezpečný (například čitelný na webu), změňte jej ručně. Pro zabránění jeho zpřístupnění všem na webu.

MariaDB/MySQL

MediaWiki vás požádá o databázi a uživatelské jméno a pokusí se je vytvořit, pokud ještě neexistují. Pokud to není možné z MediaWiki, můžete to provést pomocí různých ovládacích panelů, jako je PhpMyAdmin, které jsou často dostupné od sdílených hostitelů nebo můžete použít ssh pro přihlášení k hostiteli a zadání příkazů do MySQL řádku. Viz odpovídající dokumentace. Případně kontaktujte svého hostitele a požádejte ho o vytvoření účtu.

CREATE DATABASE wikidb;
CREATE USER 'wikiuser'@'localhost' IDENTIFIED BY 'password';
GRANT ALL PRIVILEGES ON wikidb.* TO 'wikiuser'@'localhost' WITH GRANT OPTION;

Pokud vaše databáze není spuštěna na stejném serveru jako váš webový server, musíte zadat příslušný název hostitele webového serveru — mediawiki.example.com v níže uvedeném příkladu — následujícím způsobem:

GRANT ALL PRIVILEGES ON wikidb.* TO 'wikiuser'@'mediawiki.example.com' IDENTIFIED BY 'password';
Varování Varování: MySQL nebo MariaDB v systému UNIX nebo Linux zaznamenává všechny dotazy zaslané do souboru, obsahující heslo, které jste použili pro uživatelský účet. Pokud se vás to týká, odstraňte po spuštění těchto dotazů svůj soubor historie .mysql_history. Tento soubor lze nalézt ve vašem domovském adresáři (~/.mysql_history).

PostgreSQL

Pokud používáte PostgreSQL, musíte mít buď vytvořenou databázi a uživatele nebo jednoduše do konfiguračního formuláře zadat jméno uživatele PostgreSQL s oprávněními "superuživatele" (superuser). Tím je často uživatel databáze s názvem postgres.

Zde je způsob, jak udělat většinu nastavení. Pro Unix-like systém. V tomto příkladu vytvoříme databázi s názvem wikidb, kterou vlastní uživatel s názvem wikiuser. V příkazovém řádku jako uživatel postgres proveďte následující kroky.

 createuser -S -D -R -P -E wikiuser (zadejte heslo)
 createdb -O wikiuser wikidb

nebo jako superuser (výchozí postgres) spusťte na příkazovém řádku databáze následující příkazy:

CREATE USER wikiuser WITH NOCREATEDB NOCREATEROLE NOSUPERUSER ENCRYPTED PASSWORD 'password';
CREATE DATABASE wikidb WITH OWNER wikiuser;

Dejte pozor na seznam známých problémů při spuštění MediaWiki s PostgreSQL.

Spusťte instalační skript

Po dokončení všech výše uvedených kroků můžete instalaci dokončit pomocí webového prohlížeče tak, že v prohlížeči přejdete na adresu URL index.php - podívejte se na pokyny uvedené v Příručka:Konfigurační skript .

Instalační nástroj vás vyzve ke stažení souboru LocalSettings.php a uložení jako <MediaWiki-folder>/LocalSettings.php.

Alternativně můžete spustit instalační program příkazového řádku nebo příkaz CLI: php maintenance/install.php přidáním příslušných konfiguračních parametrů.

Další kroky

Ty jsou sice volitelné, ale díky nim bude váš web vypadat mnohem lépe.

Udržujte systém aktuální!

Po instalaci se ujistěte, že budete neustále informováni o vydáních a udržujte svůj server v bezpečí!

Pomoc s instalací

Související články