UPGRADE.md

Upgrade from 3.x to 4.x

1. Namespace for functions

   Add to beginning of deploy.php next line:

   use function Deployer\{server, task, run, set, get, add, before, after};

   If you are using PHP version less than 5.6, you can use this:

   namespace Deployer;

2. env() to set()/get()

   Rename all calls env($name, $value) to set($name, $value).

   Rename all rvalue env($name) to get($name).

   Rename all server(...)->env(...) to server(...)->set(...).

3. Moved NonFatalException

   Rename Deployer\Task\NonFatalException to Deployer\Exception\NonFatalException.

4. Prior release cleanup

   Due to changes in release management, the new cleanup task will ignore any prior releases deployed with 3.x. These will need to be manually removed after migrating to and successfully releasing via 4.x.

Upgrade from 2.x to 3.x

1. ->path('...')

   Replace your server paths configuration:

   server(...)
     ->path(...);

   to:

   server(...)
     ->env('deploy_path', '...');