exp:upgradelibraries
Upgrade stage 2, libraries: Composer install from composer.lock (or update of named packages) with a security audit (dry run unless --apply).
Script bin/php/upgradelibraries.php, code in kernel/private/classes/commands/upgradelibraries.php. Run it from the installation root, as the user the web server runs as:
./console exp:upgradelibraries --help
./console exp:upgrade:libraries --help
php bin/php/upgradelibraries.php --helpHelp text
Upgrade stage 2: the libraries
Makes vendor/ hold what composer.lock names (composer install, with the dev packages only when
vendor/ had them), or with --update composer update of the named packages first. The security
audit (composer audit) runs before and after and reports; it never stops the run. Refused when
Composer reports local changes in vendor/ (--allow-vendor-changes installs over them) and when
the process is not the owner of the installation. Dry run unless --apply.
./console exp:upgrade:libraries
./console exp:upgrade:libraries --apply
./console exp:upgrade:libraries --apply --update=guzzlehttp/guzzle
Guide: doc/eng-us/guides/upgrading-with-the-console.mdOptions
| Option | Value | Help |
|---|---|---|
--apply | Make the changes (the default is a dry run that lists them and changes nothing) | |
--dry-run | The default, accepted for scripts that pass it: list what would change, change nothing | |
--only | required | Only these steps (step ids, a comma list or repeated); an optional step runs only when named here |
--skip | required | Never these steps (step ids, a comma list or repeated) |
--format | required | text (default) or json (the machine output exp-upgrade/1) |
--no-backup | Write without making a backup first | |
--backup-dir | required | Where the backup goes (default var/backup/upgrade); a directory <time> is made in it |
--force-order | Run a stage although an earlier stage has pending steps | |
--fail-on-pending | Exit 1 when steps are still pending (for CI) | |
--force-no-backup | With --no-backup on a production installation: write without a backup all the same | |
--no-caption | Write without taking a caption first (the same as --no-backup); refused on production without --force-no-caption | |
--force-no-caption | With --no-caption on a production installation: write without a caption all the same | |
--update | required | composer update these packages, with their dependencies (a comma list or repeated) |
--composer | required | The Composer binary or composer.phar (default: composer on the PATH, else composer.phar in the root) |
--no-audit | Skip the security audit of the libraries (composer audit) before and after | |
--allow-vendor-changes | Install the libraries although Composer reports local changes in vendor/ |
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 ...).
Related
Generated by ./console exp:help:examples from bin/php/upgradelibraries.php, kernel/private/classes/commands/upgradelibraries.php. Do not edit this page: change the source and generate again (how). Free documentation: GFDL 1.3 or later.