This release updates the Drush pm-* commands to use supported URLs when fetching releases from Drupal.org. Previous versions of Drush use URLs that are being decommissioned; all users must upgrade.

• Drupalorg updates (#3915)
• Add adaptors for the alias manager and the process manager to provide these Drush 9 APIs for Drush 8 extensions (#3976)
• Improve consistency of command files between Drush 9 and Drush 8: (#3928)
• file_get_stream_wrappers cache poisoning in update_check_requirements() (#3789)
• Fix boolean logic check of --local option for commands (#3777)
• Guard against bad return value in config-pull

We now run full test suite on a Windows host! This rounds out our big testing push, which added postgres and sqlite testing a couple months ago.

• DB prefix ignored when installing site. (#3920)
• Detect os to fix 'sql-query does not work on Windows' (#3886)
• Update supported Drupal Versions explanation (#3937)
• Namespaced includes (#3932)
• Continue #3166. Fix script name when Drupal uses a domain + subdir
• Add testing of all PRs on Windows (via Appveyor)
• Fixes #3943: Better quoting when pipefail is used with sql:dump (#3965)

• Remove spurious second call to 'mustRun' in sql:cli f0b17d1
• Fix #3895. drush ssh --cd does not chdir for remote calls (#3904) 0306eb4
• Fix #3894. Assume pre-escaped for single arg calls to ssh command. b0a3620
• Fix #3897. Allow multiple topics for commands. (#3907) 15950ff
• Remove extra param in log msg. 0af6535
• Remove respawn after 50% memory exhaustion during batch processing. 92b2359

• Fix: Process whitelisting of fields correctly (#3882)
• Set Drupal root context for backward compat. (#3887)
• Do one setup for locale tests. (#3889)
• Fix logging and status checking in Integration tests (#3890)
• Don't use DI in a static method. eb0e84e

• Use process manager (#3842)
• Better calculation of drush script (#3852)
• Fix pm:security. See drupal-composer/drupal-security-advisories#11. (#3857)
• Remove set_error_handler('drush_error_handler') from cache:rebuild. (#3862)
• Propagate option negations to updatedb:status (#3863)
• Allow input to be piped to sql:cli (#3866)
• Update 3 commands to use new StdinAwareInterface. (#3865)
• Update to stable version of site-process and filter-via-dot-access-data (#3870)
• Wrap 'pipefail' in "bash -c". (#3875)

Highlights

• Site aliases may now point into a Docker container #3835
• Now 100% ✅ for sqlite and postgres databases. Mysql has always been ✅. Our test bots run these tests every night.
• Deprecate drush_invoke_process(), backend.inc and context.inc. These are no longer used by Drush core and commandfiles are encouraged to use their replacements like Drush::drush(). These APIs will be removed in Drush 10.
• Unish, our test framework, can now run integration tests without a heavy setUp(). Tests are being ported over slowly.

Notes

• Document how to deal with dynamic usernames in a site.yml file. 9fb7658
• Combine phpunit configuration for unit and functional tests into a single file, and move it back to its historic location. (#3798)
• Use Drupal DB during bootstrap instead of CLI (#3800). This enables you to run all but the sql:* commands without the mysql client. Useful for minimalist Docker environments.
• Obsolete the unused and unmaintained core:execute command. Use site:ssh instead. (#3803)
• Replace drush_set_error() and drush_log() via Drush::logger() (#3810)
• Remove last calls to drush_get_error(). (#3813)
• Add ssh.pipefail config and use it in sql:dump --gzip (#3818)
• Improve testability of the startup (runtime / preflight) code (#3809)
• Better bootstrap refactor (#3820)
• Postgres Unish fixes (#3826)
• Allow integration tests to feed stdin to Drush commands. (#3827)
• Open generated file in editor - and misc (#3829)
• PGPASSFILE passed via Process not on commandline (#3833)
• Fix #1910. Add support for site aliases that point into a Docker container (#3835)

• Support Drupal 6 on PHP 7.2 (#3720)
• Correctly detect incorrect 'stty size' output (#3764)
• Set a non-zero exit status for "sql-create" on failure (#3733)
• Fix #2282, #2079. Do not pass this->query_extra to pg_dump.
• Remove fifth argument of error handler. (#3712)
• Allow Composer to place site command files in 'contrib' and 'custom' directories (#3702)
• Add option to core-cli to change the default working directory
• Set maintenance mode to update when running updates (#3605)
• Mention possible conflict of ~/.my.cnf vs --defaults-extra-file (#3581)
• Fix Drush command sql-query with option "--db-prefix" in use (#3529)

• Vastly improve return handling from older versions of Drush during sql:sync #3784
• Remove deprecated DRUSH_EXECUTION_COMPLETED and DRUSH_EXIT_CODE handling #3780

1. Fix #3748. Use Semver::satisfies. (#3774)
2. Increase default Process timeout to absurdly high level, since Drush has never had a timeout. Customize each Process as desired.

This release features significant new features and a major refactor of our "backend" plumbing. Our goal is to preserve all existing APIs so please report any breakage.

1. Add --filter to many commands (#3718). You may now filter output from any tabular commands. An example: drush pm:list --filter=ctools. See docs for details and general info about output formats.
2. Add cwd option to core-cli #3656
3. Fix bug where pm:security misses required security updates. (#3766)
4. Allow Symfony Console commands to be used in php:cli. (#3770). Did you know that Drush can run plain Symfony Console commands?
5. Deprecate backend.inc in favor of a new site-process library (#3758). This is a HUGE win for the maintainability of Drush.
6. Forward-port #3764 (stty size fix) to master (#3772)
7. Allow symfony/finder 4 (#3744) and symfony/var-dumper 4 (#3739)
8. Fix #3743. Remove symfony/config dependency. Its unused. (#3775)
9. Unset _style during encode/decode of backend packets to avoid type mismatch errors. (#3776)
10. Fix BaseBoot's site alias inflection (#3778)

9.5.2

• Fix #3656: Adding cwd option to core-cli
• Fix #3741 Handle global Drush9 edge case
• #3747 Keep things that are only needed for debugging out of Packagist's prefer dist' exports.

9.5.1

• Removed a patch to drupal/core that was inadvertently specified in composer.json

9.5.0

• When an update fails, updatedb is still exiting with 0. (#3673)
• Add a cache clear option for plugin cache a330e39
• Fix undefined variable preflightArgs notice (#3679)
• Fix help example for php:script
• Add command to import .po files (#3521)
• Fixes #3672: Call Boot::terminate() in a shutdown handler. (#3680)
• Move sandbox and SUT alongside Drush, instead of in a tmp dir (#3682)
• Update cron.md - invert env / docroot order (#3686)
• Retain 'contrib' / 'custom' paths for site-wide Drush extensions (#3687)
• Provide docker-compose for running tests and developing Drush (#3691)
• Fix config:export not deleting collections (#3690)
• Fix SiteAliasManager::getMultiple (#3695)
• Functional tests compatible with PHPUnit 6. a12639e
• Fix .env.example syntax d5c56d0
• Get rid of UNISH_DRUPAL_MAJOR_VERSION constant. bb82da3
• Update to Symfony 3.4 as minimum. (#3697)
• Use new native isHidden() method in Help. Also mark SUT commands as hidden (#3698)
• Don't delete built-in users during entity:delete. b136aa3
• Compatibility with new Tideways XHProf extension. (#3707)
• Bugfix in pgsql sql driver : options --data-only and --create-db were always active (#3685)
• Bump chi-teck/drupal-code-generator dependency.
• Add way to clear cache bin(s) by name via 'drush cc bin [name]' (#3726)
• Pass -A by default to mysql connections. Speeds up connect time. (#3727)
• Fix #2282, #2079. Do not pass this->query_extra to pg_dump. Refs #3727.
• Under Windows+Postgres, "PGPASSFILE=..." is interpreted as a command 1764553
• Remove query_extra in dumpCmd for sqlite 93e36e5
• Fixed notice Undefined variable: translationOptions (#3723)
• Fix #3586. entup is always is clearing cache.
• Add usage hint about detecting pending entity updates. 1e5029e

9.5.1

• Removed a patch to drupal/core that was inadvertently specified in composer.json

9.5.0

• When an update fails, updatedb is still exiting with 0. (#3673)
• Add a cache clear option for plugin cache a330e39
• Fix undefined variable preflightArgs notice (#3679)
• Fix help example for php:script
• Add command to import .po files (#3521)
• Fixes #3672: Call Boot::terminate() in a shutdown handler. (#3680)
• Move sandbox and SUT alongside Drush, instead of in a tmp dir (#3682)
• Update cron.md - invert env / docroot order (#3686)
• Retain 'contrib' / 'custom' paths for site-wide Drush extensions (#3687)
• Provide docker-compose for running tests and developing Drush (#3691)
• Fix config:export not deleting collections (#3690)
• Fix SiteAliasManager::getMultiple (#3695)
• Functional tests compatible with PHPUnit 6. a12639e
• Fix .env.example syntax d5c56d0
• Get rid of UNISH_DRUPAL_MAJOR_VERSION constant. bb82da3
• Update to Symfony 3.4 as minimum. (#3697)
• Use new native isHidden() method in Help. Also mark SUT commands as hidden (#3698)
• Don't delete built-in users during entity:delete. b136aa3
• Compatibility with new Tideways XHProf extension. (#3707)
• Bugfix in pgsql sql driver : options --data-only and --create-db were always active (#3685)
• Bump chi-teck/drupal-code-generator dependency.
• Add way to clear cache bin(s) by name via 'drush cc bin [name]' (#3726)
• Pass -A by default to mysql connections. Speeds up connect time. (#3727)
• Fix #2282, #2079. Do not pass this->query_extra to pg_dump. Refs #3727.
• Under Windows+Postgres, "PGPASSFILE=..." is interpreted as a command 1764553
• Remove query_extra in dumpCmd for sqlite 93e36e5
• Fixed notice Undefined variable: translationOptions (#3723)
• Fix #3586. entup is always is clearing cache.
• Add usage hint about detecting pending entity updates. 1e5029e

• When an update fails, updatedb is still exiting with 0. (#3673)
• Add a cache clear option for plugin cache a330e39
• Fix undefined variable preflightArgs notice (#3679)
• Fix help example for php:script
• Add command to import .po files (#3521)
• Fixes #3672: Call Boot::terminate() in a shutdown handler. (#3680)
• Move sandbox and SUT alongside Drush, instead of in a tmp dir (#3682)
• Update cron.md - invert env / docroot order (#3686)
• Retain 'contrib' / 'custom' paths for site-wide Drush extensions (#3687)
• Provide docker-compose for running tests and developing Drush (#3691)
• Fix config:export not deleting collections (#3690)
• Fix SiteAliasManager::getMultiple (#3695)
• Functional tests compatible with PHPUnit 6. a12639e
• Fix .env.example syntax d5c56d0
• Get rid of UNISH_DRUPAL_MAJOR_VERSION constant. bb82da3
• Update to Symfony 3.4 as minimum. (#3697)
• Use new native isHidden() method in Help. Also mark SUT commands as hidden (#3698)
• Don't delete built-in users during entity:delete. b136aa3
• Compatibility with new Tideways XHProf extension. (#3707)
• Bugfix in pgsql sql driver : options --data-only and --create-db were always active (#3685)
• Bump chi-teck/drupal-code-generator dependency.
• Add way to clear cache bin(s) by name via 'drush cc bin [name]' (#3726)
• Pass -A by default to mysql connections. Speeds up connect time. (#3727)
• Fix #2282, #2079. Do not pass this->query_extra to pg_dump. Refs #3727.
• Under Windows+Postgres, "PGPASSFILE=..." is interpreted as a command 1764553
• Remove query_extra in dumpCmd for sqlite 93e36e5
• Fixed notice Undefined variable: translationOptions (#3723)
• Fix #3586. entup is always is clearing cache.
• Add usage hint about detecting pending entity updates. 1e5029e

This release is contains a bunch of bug fixes, and supports new features coming in tomorrow's Drupal 8.6 release ([#3625]).

• Fix #3595. Remove non-default options in REPL commands, Fix help command grouping (#3667)
• Advertise generate field command.
• Fix #3664. Make config:set --value_format=yaml work. (#3666)
• Allow multipart aliases with drush sa, e.g. @location.site.env or @location.site, in addition to just @location or @site. (#3660)
• Validate any provided config dirs in si command (#3659)
• Do not pass local paths to remote hosts (#3658)
• Automatically select correct profile when using --existing-config (#3657)
• Fix #3634. updatedb with long-running updates can end in "MySQL went away" error (#3655)
• Fix #3624. Change usage of '--config-dir' site-install option. (#3625)
• Fixes #3651: correct typos in topic file paths.
• Fixes #3274: Allow un-found aliases on the commandline to be passed through to the site-local Drush. (#3650)
• Add an 'ssh.tty' option to site aliased. (#3648)
• Fix #3641. Move path doc to non-optional step.
• Fix #3635. More verbose output when an exception happens during command execution. (#3640)
• Set maintenance mode constant running updatedb (#3606)
• Add drush cache directory to core:status (#3623)
• Fix #3596. Canonicalize directory. (#3600)
• Improve site alias example documentation. (#3612)
• Site alias location filters (#3602)
• Enable configurability of the Drush cache directory. (#3597)
• Fix si breaking with uri and default directory (#3591)
• Factor SiteAlias classes out into consolidation/site-alias project. (#3588)
• Fixes #3510: Fix up regular expressions for remote site specifications. (#3583)
• Support ansi options. (#3579)
• Support var-dumper 4.x (#3578)
• Mark drush_backend_invoke_concurrent as deprecated (#3573)
• Fix #3569. Drush 9 aliases path is wrong when using symlink (#3570)
• Fix #3566 - Improve docs for authoring global commandfiles.
• Fix pm:security to properly identify security updates.

The refactoring of the site alias classes into consolidation/site-alias may require minor changes to Drush extensions that reference site alias classes directly (e.g. namespaces will need to be updated).

• Stop all processing of queue on SuspendQueueException (#3327)
• Fix php 7.1 warning for COLUMNS env variable.
• Prevent 'drush @local uli' and related commands from executing twice. #3428
• Add tests for Drupal 8.5. (#3438)
• Call batch finished with call_user_func_array() to use static method call. (#3517)
• Fix drush make-convert --format=composer (#3499)
• Fix PHP 7.2 warning regarding count() (#3545)
• Fix #2285, #2268. Recognize current working dir for multisites when bootstrapping a site. Affects hosts that have pcntl_exec(). (#3550)
• #3039 : Fixed numeric notice in PHP 7.x.

Add twig:unused command. Move twig:compile (#3503)
Fix #3512. Add extra-dump option to sql:sync.
Fix namespace for global commandfiles. Now matches docs. (#3518)
Fix #3380. 'Container cannot be saved to cache' for updatedb commands.
Fix #3166. Fix incorrect script name when Drupal uses a domain + subdir. (#3553)
Update user-cancel test to match upstream DCG changes.

Authors of Drush9 global commands (i.e. commands that don't live within a module) will want to make sure they use the namespace Drush/Commands and not the briefer Drush.

Fix bug affecting sites still using Drupal 8.4.

Version mismatch workaround

There is a bug when performing a sql:sync between mismatched versions of Drush. Specifically, when 9.2.1 or later on the destination and an earlier version is on the source may give errors. You get an error mentioning an auto.gz file. In that case, pass --source-dump=/tmp/tmp.sql (or another path) in your sql:sync call. Once your source Drush is up to 9.2.1, these errors will go away and you may remove the --source-dump option.

• Factor preflight class references out of site alias manager (#3432)
• Many small docs improvements
• Allow custom target dir for config:pull (#3436)
• Allow registering of command info alterer services (#3447)
• Use bundle key in entity:delete command (#3450)
• Fix infinite loop in DrupalBoot::scanUpForUri (on Windows) (#3435)
• Unish - bump drupal core versions. (#3461)
• Fix #3464. Louder warning when mysql is not present.
• Also load 'drush9.yml' to allow for variant Drush configuration files… (#3465)
• Fixed deprecated each() for PHP 7.2 - 3469 (#3472)
• D9 Run batch process during pm-enable when needed. (#3446)
• [#3330] Fix logic leading to creation of PGPASSFILE. Postgres users rejoice!
• Add more informative error depending on bootstrap status when a command is not found.
• Surface Drupal 8 Messages in the log. (#3489)

• Fix #3417. sql-sync dump filename not automatically generated (#3418)

Note: sql:sync where this Drush version is on the destination a prior version is on the source may give errors regarding an auto.gz file. In that case, pass --source-dump=/tmp/tmp.sql (or another path) in your sql:sync call. Once your source Drush is up to 9.2.1, these errors will go away and you may remove the --source-dump option.

See last link for the details about the following highlights since 9.1.0:

• Show formatted severity in wd:one (#3362)
• Add entity:delete command (#3365)
• Fix #3009. Document setting Drush config values via environment variable.
• Add --result-file-auto to save to a date-based filename under ~/drush-backups directory (#3370)
• Minor tweaks to pm:security
• #3383 - fix label not being used for drush config:import command (#3384)
• Fixes #3385: DrushArgvInput must extend ArgvInput. (#3388)
• Use Drupal’s Installerkernel in site:install (#3390)
• #3392 use canonicalized file paths for config import sync dir (#3393)
• Support a new phase value when with @bootstrap max annotation. Improves sql commands (#3397)
• Fixes #3306: Make sure that rsync with %files resolves correctly (#3405)
• Fixes #3394: make sure that site alias manager is inflected for command objects that need it. (#3406)
• Fixes #3127: Non-interactive invoke via 'drush @alias cmd' (#3407)
• Changes since 9.1.0.