Manual:migrateFileRepoLayout.php

MediaWiki file: migrateFileRepoLayout.php
Location:	maintenance/
Source code:	master • 1.42.4 • 1.41.5 • 1.39.11
Classes:	MigrateFileRepoLayout

Details

migrateFileRepoLayout.php is a maintenance script that copies all files in FileRepo to a new layout using SHA1 paths.

Options

Option	Description	Required
--oldlayout	Old layout; one of 'name' or 'sha1'	Required
--newlayout	New layout; one of 'name' or 'sha1'	Required
--since	Copy only files from after this timestamp	Optional

This script runs in batches of 50.

Usage

php maintenance/run.php migrateFileRepoLayout --oldlayout name|sha1 --newlayout  name|sha1 [ --since ]

Terminal

$ php maintenance/run.php migrateFileRepoLayout --oldlayout name --newlayout sha1

Migrating file batch:
"1631330937964.jpeg" (dest: mwstore://local-backend/local-original/o/5/0/o50kk2gmida2gmaxbp19qzdhhfosovz)
"Example_Main_Page.png" (dest: mwstore://local-backend/local-original/0/u/n/0unk5fuzx7s2qeic2hxtp73pk1yeln6)
"Logo.jpg" (dest: mwstore://local-backend/local-original/a/x/r/axrt73dk8q1r1xw5zmn819w5ybriclx)
Array
(
    [0] => Array
        (
            [type] => error
            [message] => lockmanager-fail-openlock
            [params] => Array
                (
                    [0] => mwstore://local-backend/local-public/8/8a/764634234.jpeg
                )

        )

)
Batch done

Done (started 20211028042818)

In MediaWiki version 1.39.10 and earlier, you must invoke maintenance scripts using php maintenance/scriptName.php instead of php maintenance/run.php scriptName.

Common error

Invalid old layout.

The value for parameter --oldlayout must be either name or sha1.

Invalid new layout.

The value for parameter --newlayout must be either name or sha1.

See also

• Manual:FindMissingFiles.php
• Manual:FindOrphanedFiles.php
• Manual:CopyFileBackend.php