Manual:MigrateFileRepoLayout.php
| MediaWiki file: migrateFileRepoLayout.php | |
|---|---|
| Location: | maintenance/ |
| Source code: | master • 1.42.3 • 1.41.4 • 1.39.10 |
| 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/migrateFileRepoLayout.php --oldlayout name|sha1 --newlayout name|sha1 [ --since ]
Terminal
$ php maintenance/migrateFileRepoLayout.php --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)
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.