Manual:Maintenance scripts/cs

Údržbářské skripty se používají pro různé administrativní úlohy, import dat, údržbu, generování reportů a také při aktualizaci. Jsou napsány v PHP a u nainstalované MediaWiki je najdete v podadresáři.

Jsou to desítky skriptů, které mají různou kvalitu zpracování i užitnou hodnotu. Než nějaký skript použijete, tak byste si měli pozorně přečíst jeho dokumentaci. Pokud není řádně zdokumentován, nejprve ho řádně prostudujte, abyste věděli co udělá, dřív než ho spustíte.

Konfigurace
Aby bylo možné spouštět údržbářské skripty, které potřebují sáhnout na databázové schéma (jako např. ) a udělat změny ke kterým uživatel nastavený v konfigurační proměnné   nemusí mít dostatečná práva, tak by měly být nastaveny také konfigurační proměnné   a. Obejdete se bez nich, pokud skriptu při spouštění na příkazové řádce předáte uživatele s těmito právy a jeho heslo přes parametry --dbuser a --dbpass. Předávaná hodnota, resp. hodnota těchto proměnných se může lišit, podle toho jakou databázi jste použili pro svou MediaWiki. Pokud tyto proměnné nejsou nastavené, tak skript použije uživatele z $wgDBuser.

MySQL
Některé skripty údržby vyžadují databázová oprávnění, která by z bezpečnostních důvodů hlavní databázový účet MediaWiki neměl mít. Měl by být vytvořen samostatný databázový účet s oprávněními „superuživatele“ pouze pro databázi MediaWiki (pokud již neexistuje). Pokud se databáze, kterou používáte pro MediaWiki, nazývá, pak by následující SQL vytvořit takového uživatele, který může vykonávat privilegia superuživatele na localhost .:

Jakmile účet existuje, měl by být název účtu nastaven v konfigurační proměnné. Stejně jako ostatní konfigurační proměnné by měl být  nastaven na. V konfigurační proměnné  musí být nastaveno heslo pro.

PostgreSQL
PostgreSQL používá jiný bezpečnostní model než MySQL a stejný serverový účet PostgreSQL používaný pro každodenní provoz instalace MediaWiki musí být také použit pro spouštění skriptů údržby. To je nezbytné k zajištění správného nastavení vlastníka nových tabulek vytvořených skripty údržby. Není třeba nastavovat  nebo.

Spouštění skriptů
Skripty údržby pak musí být spuštěny z příkazového řádku. Uživatelé, kteří nemají přístup k serveru přímo z jeho terminálu, obvykle naváží spojení pomocí ssh. Pro uživatele Linux / Unix je to pomocí ssh klienta ve shellu. Uživatelé systému Windows vyžadují použití klientské aplikace ssh, jako je ta, která je uvedena níže.

Požadovaný program pro uživatele Windows: PuTTY nebo jakýkoli emulátor terminálu


 * Krok 1: Stáhněte a spusťte PuTTY, emulátor terminálu.
 * Krok 2: Do pole PuTTy zadejte Hostitelský název (nebo IP adresu) IP Address vašeho webhostingového serveru (v případě potřeby kontaktujte poskytovatele webových stránek) a klikněte na Open.


 * Krok 3: Objeví se obrazovka s příkazy. Na řádku přihlášení jako: zadejte uživatelské jméno FTP.


 * Krok 4: Zadejte heslo FTP.


 * Krok 5: Změňte aktuální adresář do podadresáře údržby (maintenance). Zadáním  zobrazíte složku, ve které se právě nacházíte. Složka údržby je v kořenové složce Mediawiki.


 * Krok 6: Spusťte skript údržby:


 * Pokud se zobrazí chyba (například: php.exe není platná aplikace Win32), zkuste následující:


 * Ve Windows je to příkaz:

Standardní možnosti příkazového řádku
Téměř každý skript PHP v  podporuje několik standardních možností:
 * --help
 * Zobrazí zprávu nápovědy


 * --conf &lt;path&gt;
 * Umístění LocalSettings.php, není-li výchozí (v nadřazeném adresáři skriptu)


 * --dbuser &lt;username&gt;
 * Databázový účet, který se má použít namísto účtu uvedeného v LocalSettings.php. Nepoužívá se pro skripty, které nevyžadují připojení k databázi nebo pokud se používá backend databáze SQLite


 * --dbpass &lt;password&gt;
 * Heslo databáze, které se má použít místo hesla uvedeného v LocalSettings.php. Nepoužívá se pro skripty, které nevyžadují připojení k databázi nebo pokud je použito backend databáze SQLite


 * --globals
 * Výstup globálů na konci zpracování pro ladění


 * --memory-limit &lt;value&gt;
 * Nastavuje limit paměti pro skript. Přijímá běžná čísla, standardní zkratky php.ini (1024K, 20M, 1G),  bez omezení (ve výchozím nastavení bude použito, pokud bude vynecháno) a   beze změny.


 * --quiet
 * Potlačí výstup bez chyb


 * --wiki &lt;id&gt;
 * Wiki ID pro wiki farmy. Může to být ve formě  nebo  . LocalSettings.php bude spuštěn s konstantami   a.


 * --profiler
 * Profiler output format (usually "text").


 * --mwdebug
 * Enable built-in MediaWiki development settings.

MediaWiki installs that use symlinks
In cases where the MediaWiki php files are symlinked to a central installation, you will need to specify to the maintenance script the path of the LocalSettings.php file. For example:

php maintenance/importImages.php --conf /var/wwwdata/website.org/wiki/LocalSettings.php /tmp/wikiimages .jpg .png .svg Otherwise you will get this error:

A copy of your installation's LocalSettings.php must exist and be readable in the source directory.

MediaWiki installs that use shared settings (family type)
Sometimes MediaWiki is installed as a family for many languages and settings (LocalSettings.php) are split to common part and language parts (see ) where common part is located outside of /w directory and accessed using relative link. In this case maintenance scripts will not work when running them in /w/maintenance directory. Run them from /w directory instead:

No shell access
On many shared hosts, you won't have shell access. The following extensions may be useful to run maintenance scripts via the web: and.

Přehled údržbářských skriptů
Instead of this probably-outdated list,


 * https://doc.wikimedia.org/mediawiki-core/master/php/ - View its generated documentation summary. (Files > File List > maintenance in the tabs or left-hand navigation sidebar)
 * https://doc.wikimedia.org/mediawiki-core/master/php/ - View its generated documentation summary. (Files > File List > maintenance in the tabs or left-hand navigation sidebar)

Here is the list of files included in the  subdirectory located at the root of a MediaWiki installation. You can contribute to this manual by keeping this list up to date, adding a description of these files' specific purpose and of how an administrator should use them (command line examples, etc.). Be aware that these were created and named on an ad hoc basis so have some usability issues.

Viz též

 * maintenance/README
 * maintenance/README
 * maintenance/README
 * maintenance/README
 * maintenance/README