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 kvalitou zpracování i užitnou hodnotu. Než nějaký skript použijete, tak byste si měli pozorně přečíst jeho dokumentaci. A pokud není řádně zdokumentován, tak byste si ho měli nejprve prostudovat, 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é   nemá 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 and --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
Some of the maintenance scripts require database permissions that, for security reasons, the main MediaWiki database account should not have. A separate database account with 'superuser' privileges for just the MediaWiki database should be created (if it does not already exist.) If the database that you use for MediaWiki is called , then the following SQL would create such a user who can exercise superuser privileges on localhost.:

Once the account exists, the account name should be set in the  configuration variable. Like other configuration variables,  should be set in. A password for  must be set in the   configuration variable.

PostgreSQL
PostgreSQL uses a different security model than MySQL and the same PostgreSQL server account used for day-to-day operation of the MediaWiki installation must also be used for running the maintenance scripts. This is necessary to ensure that the owner for new tables created by the maintenance scripts is set correctly. You don't need to set  or   at all.

Spouštění skriptů
The maintenance scripts must then be run from the command line. Users who do not access the server directly from its terminal will usually establish a connection through ssh. For Linux/Unix users this is by using the ssh client in a shell. For Windows users the use of a ssh client application such as the one introduced below is required.

Required program for Windows users: PuTTY or any terminal emulator


 * Step 1: Download and run PuTTY, a terminal emulator.
 * Step 2: In PuTTy, under the Host Name (or IP address) enter the IP Address of your web hosting site (Contact your website provider if necessary) and click Open.


 * Step 3: A command screen will pop up. At the login as: line enter the FTP user name.


 * Step 4: Enter the FTP password.


 * Step 5: Change the current directory to the maintenance subdirectory. You can type  to see what folder you are currently in. The maintenance folder is in the root mediawiki folder.


 * Step 6: Execute the maintenance script that needs to be run:


 * If you get an error (for example: php.exe is no valid Win32 application), try the following:


 * In Windows, the command is:

Standard command-line options
Almost every PHP script in  supports several standard options:
 * --help
 * Displays help message


 * --conf &lt;path&gt;
 * Location of LocalSettings.php, if not default (at parent directory of the script)


 * --dbuser &lt;username&gt;
 * Database account to use instead of the one specified in LocalSettings.php, not used for scripts that don't require a database connection or when SQLite database backend is used


 * --dbpass &lt;password&gt;
 * Database password to use instead of the one specified in LocalSettings.php, not used for scripts that don't require a database connection or when SQLite database backend is used


 * --globals
 * Output globals at the end of processing for debugging


 * --memory-limit &lt;value&gt;
 * Set memory limit for the script. Accepts ordinary numbers, standard php.ini abbreviations (1024K, 20M, 1G),  for no limit (will be used by default if omitted) and   for no change.


 * --quiet
 * Suppress non-error output


 * --wiki &lt;id&gt;
 * Wiki ID for wiki farms. This may be of the form  or  . LocalSettings.php will be run with the   and   constants defined accordingly.


 * --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