Skip to the content
Documentation
Help Start
Reading in:
  • German: 9,059 of 9,059 pages
About the help in other languages
All help pages

exp:upgradescripts

Upgrade stage 4, scripts: the PHP upgrade steps, policies and repairs (dry run unless --apply).

Download as PDF

Address: https://doc.exponential.earth/learninminutes/exphelp/viewer/examples/commands/upgradescripts.md

On this page

exp:upgradescripts

Upgrade stage 4, scripts: the PHP upgrade steps, policies and repairs (dry run unless --apply).

Script bin/php/upgradescripts.php, code in kernel/private/classes/commands/upgradescripts.php. Run it from the installation root, as the user the web server runs as:

./console exp:upgradescripts --help
./console exp:upgrade:scripts --help
php bin/php/upgradescripts.php --help

Help text

Upgrade stage 4: the scripts
The PHP upgrade steps: the scripts of update/common/scripts/ and the setup commands (editor
policies, member management, user approval, ...), run through the same classes with their
default options. Refused while the database stage has pending steps (--force-order runs
anyway). Dry run unless --apply.

./console exp:upgrade:scripts
./console exp:upgrade:scripts --apply --skip=6.0.15-editor-policies
Guide: doc/eng-us/guides/upgrading-with-the-console.md

Options

OptionValueHelp
--applyMake the changes (the default is a dry run that lists them and changes nothing)
--dry-runThe default, accepted for scripts that pass it: list what would change, change nothing
--onlyrequiredOnly these steps (step ids, a comma list or repeated); an optional step runs only when named here
--skiprequiredNever these steps (step ids, a comma list or repeated)
--formatrequiredtext (default) or json (the machine output exp-upgrade/1)
--no-backupWrite without making a backup first
--backup-dirrequiredWhere the backup goes (default var/backup/upgrade); a directory <time> is made in it
--force-orderRun a stage although an earlier stage has pending steps
--fail-on-pendingExit 1 when steps are still pending (for CI)
--force-no-backupWith --no-backup on a production installation: write without a backup all the same
--no-captionWrite without taking a caption first (the same as --no-backup); refused on production without --force-no-caption
--force-no-captionWith --no-caption on a production installation: write without a caption all the same

Read from the option definitions in the code (startup(), getOptions(), options() or ezcConsoleOption). Every script also takes the standard options of the script framework (--help, --siteaccess, --debug, --quiet, --allow-root-user ...).


Generated by ./console exp:help:examples from bin/php/upgradescripts.php, kernel/private/classes/commands/upgradescripts.php. Do not edit this page: change the source and generate again (how). Free documentation: GFDL 1.3 or later.

Something wrong on this page? Report an error

Documentation license

This documentation is free documentation, licensed under the GNU Free Documentation License 1.3 or later.

Exponential Copyright © 1998-2026 Exponential Foundation and 7x