Manual:importImages.php

Soubor MediaWiki: importImages.php
Lokalita:	maintenance/
Zdrojový kód:	master • 1.41.1 • 1.40.3 • 1.39.7
Třídy:	ImportImages

importImages.php je script, který nahrává obrázky do MediaWiki ze stejného počítače, kde je konfigurována wiki. Pokud je konfigurační parametr $wgForeignFileRepos správně nakonfigurován, nebo pokud používáte rozšíření, které jej správně konfiguruje, jako je rozšíření AWS (S3) , provede vzdálené nahrávání.

Pokud plánujete importovat i popisy souborů na obrázkové stránky, měli byste to udělat před spuštěním importImages.php. Jinak budou tyto popisy souborů pohřbeny pod importem v historii stránky. Pokud tuto chybu uděláte, můžete ji opravit pomocí skriptu bota, například FixFileDescriptionPagesBot.php .

Příklady

Nahrajte s výchozím komentářem "Importing file" a výchozím uživatelem "Maintenance script":

php maintenance/importImages.php /path/to/images/directory

Nahrajte s vlastním komentářem "Import souborů z místního úložiště souborů" a výchozím uživatelem "Maintenance script":

php maintenance/importImages.php /path/to/images/directory --comment="Import souborů z místního úložiště souborů"

Nahrajte s vlastním komentářem "Import souborů z místního úložiště souborů" a vlastním uživatelem "Nahraný admin" (který již musí existovat, jinak dojde k chybě):

php maintenance/importImages.php /path/to/images/directory --comment="Import souborů z místního úložiště souborů" --user="Nahraný admin"

importImages.php nebude ve výchozím nastavení vyhledávat a nahrávat obrázky v podadresářích (rekurze adresáře). Proto nahrajte s vlastním komentářem "Import souborů z místního úložiště souborů", vlastní uživatel "Nahraný admin": a rekurzivně vyhledejte soubory v podadresářích:

php maintenance/importImages.php /path/to/images/directory --comment="Import souborů z místního úložiště souborů" --user="Nahraný admin" --search-recursively

File:OOjs UI icon notice-destructive.svg <translate> Warning:</translate>

Pokud se tento skript používá k importu souborů z adresáře souborů instalace MediaWiki s volbou --search-recursively, dejte pozor, abyste přeskočili jakékoli podadresáře jiné než \0–\9 a \a–\f (zejména jakékoli podadresáře \archive nebo \deleted budou pro smazané soubory a podadresář \thumb vygenerovat miniatury).

importImages.php nepřepíše obrázky, pokud obrázek se stejným názvem již na wiki existuje. Proto nahrajte s vlastním komentářem "Importing files from local file repository", vlastním uživatelem "Upload admin" a přepište existující obrázky:

php maintenance/importImages.php /path/to/images/directory --comment="Importing files from local file repository" --user="Upload admin" --overwrite

The same as above but only overwriting the given image types, e.g. pdf (for .pdf-files):

php maintenance/importImages.php /path/to/images/directory --comment="Importing files from local file repository" --user="Upload admin" --overwrite --extensions=pdf

An example of what a successful import of one image (Foo.jpg) looks like:

root@f345:/home/t/public_html/mywikisite/public/w/maintenance# php importImages.php /home/t/public_html/import --extensions=svg,png,jpg,jpeg,gif,bmp,SVG,PNG,JPG,JPEG,GIF,BMP Import Images Importing Foo.jpg...done. Found: 1 Added: 1 root@f345:/home/t/public_html/mywikisite/public/w/maintenance#

It is probably a good idea to run this script as the apache user (Commonly either apache or www-data). Otherwise the uploaded files will be owned by the person who ran the script, which may prevent MediaWiki from being able to move, delete, or otherwise manipulate the files later on.

Arguments

Verze MediaWiki:

<translate> ≥</translate> 1.21

$ php importImages.php
Import Images

Imports images and other media files into the wiki
USAGE: php importImages.php [options] <dir>

<dir> : Path to the directory containing images to be imported

Options:
--extensions=<exts>     Comma-separated list of allowable extensions, defaults
                        to $wgFileExtensions.
--overwrite             Overwrite existing images with the same name (default
                        is to skip them).
--limit=<num>           Limit the number of images to process. Ignored or
                        skipped images are not counted.
--from=<name>           Ignore all files until the one with the given name.
                        Useful for resuming aborted imports. <name> should be
                        the file's canonical database form.
--skip-dupes            Skip images that were already uploaded under a different
                        name (check SHA1)
--search-recursively    Search recursively for files in subdirectories.
--sleep=<sec>           Sleep between files. Useful mostly for debugging.
--user=<username>       Set username of uploader, default 'Maintenance script'.
--check-userblock       Check if the user got blocked during import.
--comment=<text>        Set file description, default 'Importing file'.
--comment-file=<file>   Set description to the content of <file>.
--comment-ext=<ext>     Causes the description for each file to be loaded from a
                        file with the same name, but the extension <ext>. If a
                        global description is also given, it is appended.
--license=<code>        Use an optional license template.
--dry                   Dry run, don't import anything.
--protect=<protect>     Specify the protect value (autoconfirmed,sysop).
--summary=<summary>     Upload summary, description will be used if not
                        provided.
--timestamp=<timestamp> Override upload time/date, all MediaWiki timestamp
                        formats are accepted.
--unprotect             Unprotects all uploaded images.
--source-wiki-url       If specified, take User and Comment data for each
                        imported file from this URL. For example,
                        --source-wiki-url="https://en.wikipedia.org/."

"--comment-ext" defines a file extension like ".meta" that contains the file comment, i.e. the content of the wiki-metadata-page associated with each imported file. This supports per-file metadata, whereas the --comment option supports only per-import metadata. The value of --comment-ext works with or without a leading dot (.meta as well as meta), the value may be quoted or not. The associated file is searched both as appended and substituted extension. Thus, importing x.jpg and setting "--comment-ext meta" or "--comment-ext=meta" either of x.meta or x.jpg.meta will be used to set the initial metadata page (i.e. the page shown for File:x.jpg).

The "canonical database form" required by "--from" is obtained from the file name by capitalizing the first letter, replacing all spaces with underscores, and then replacing multiple consecutive underscores with one underscore. For example, to start with the file someFile with __weird_ spaces.png, the correct argument would be --from=SomeFile_with_weird_spaces.png

Troubleshooting

Could not open lock file

Try chmod -R 777 images (even if it was already set to 755, sometimes it needs to be set to 777)

Does not find the picture to upload

Example where the script does not find any picture to upload:

vi-notebook:/var/lib/mediawiki1.7# php maintenance/importImages.php /store/wiki/absurd_pic jpg
Import Images

Warning: Invalid argument supplied for foreach() in /usr/share/mediawiki1.7/maintenance/importImages.php on line 34

Incorrect folder path

t@f66677:~/public_html/dead.com/public/w/maintenance$ php importImages.php /m gif bmp PNG JPG GIF BMP
Import Images

No suitable files could be found for import.

Usually this is because the path to the folder is incorrect.

Upload failed error

login as: ideakwty ideakwty@164.413.451.184's password: [ideakwty@server98 ~]$ cd public_html/youareapuppet.com/mw/maintenance [ideakwty@server98 maintenance]$ php importImages.php /public_html/TO svg png jpg jpeg gif bmp SVG PNG JPG JPEG GIF BMP Import Images No suitable files could be found for import. [ideakwty@server98 maintenance]$

"No suitable files could be found for import." error when user does not have the privileges to upload the pictures

The following error can be caused by two issues:

1. Directory permissions needs to be changed, and/or
2. user does not have the privileges to upload the pictures

Problem 1: Directory permissions needs to be changed

Solution: Change directory's mode

File:Chmod change in winscp.png

changing chmod in winSCP

1. chmod four folders to 777:
   1. images,
   2. images/temp,
   3. images/thumb and
   4. images/archive
2. If it hasn't already been done, in LocalSettings.php, uncomment the line $wgHashedUploadDirectory = false; by removing the # in front of the line.

Problem 2: user does not have the privileges to upload the pictures

Solution: switch users or change user upload privileges.

Související odkazy

• importDump.php - pro import stránek
• dumpBackup.php - pro export stránek