Introduction to DeploYii 0.5, a task runner and deployment solution based on Yii 2 (PHP 5.4+). DeploYii let's you create your build script easily and quickly writing it as a simple php array.

1. Introducing DeploYii
v 0.5
http://www.deployii.com Giovanni Derks: http://derks.me.uk

2. What is it?
DeploYii is a PHP task runner and deployment
solution designed to be easy to use and
flexible.
It can be used for very simple tasks or for more
complex scenarios depending on your needs.

3. What is it?
● based on Yii 2 console app. (PHP 5.4+)
● friendly, array based, php build script
● extensible (create your own script commands & recipes.
Per project or globally)
● interactive / non-interactive modes
● configurable build script (common + per environment)
● override configuration defaults via command line
options
● in early stage development but with ambitious goals

4. Main features
(as of version 0.5)
● print out text and parameters or require user input
● save / load information from json files
● if / else statement based on PHP expression
● script and home folder version compatibility check
● create, copy, rename, delete folders
● copy, rename, delete file
● set files and folders permissions
● archive/compress files and folders
● replace in files
● SFTP support (put, get, mkdir, chmod, mv, rm, rmdir, ...)
● execute shell commands (locally or over SSH)

5. build.php
return [
'deployiiVersion' => '0.5.0',
'require' => [],
'params' => [
'username' => 'world',
],
'targets' => [
'default' => [
['out', 'Hello {{username}}!'],
],
],
];

6. build.php
return [
'deployiiVersion' => '0.5.0',
'require' => [],
'params' => [
'username' => 'world',
],
'targets' => [
'default' => [
['out', 'Hello {{username}}!'],
],
],
];
the “deployiiVersion” string contains the latest
DeploYii version number the build script has
been created for.
If, in a newer version, some changes break
the backward compatibility, DeploYii will
prompt the user to update the build script.

7. build.php
return [
'deployiiVersion' => '0.5.0',
'require' => [],
'params' => [
'username' => 'world',
],
'targets' => [
'default' => [
['out', 'Hello {{username}}!'],
],
],
];
Using the require array you can require / pre-load
some script commands or recipes.
Pre-loading a command allow it to check its
requirements, define a new set of parameters
and attach helper functions to the main
controller.
Requirements are recursive so a build script
can include a recipe which can include
another recipe and a command, etc.

8. build.php
return [
'deployiiVersion' => '0.5.0',
'require' => [],
'params' => [
'username' => 'world',
],
'targets' => [
'default' => [
['out', 'Hello {{username}}!'],
],
],
];
The params array contain the default values
of the build parameters.
The build parameters are used during the
execution of the build script and can be
accessed using placeholders in the format of
{{placeholder}} and in other commands
statements, such as the if/else.
Build parameters can be overwritten by the command line,
specifying them as a command line options (--
username=mike) while the build configuration is stored in
the Build script configuration

9. build.php
return [
'deployiiVersion' => '0.5.0',
'require' => [],
'params' => [
'username' => 'world',
],
'targets' => [
'default' => [
['out', 'Hello {{username}}!'],
],
],
];
The targets array let's you define your build
script targets.
You can also call a target or a recipe from a target by using
the "target" or the "recipe" command:
call another target:
['target', 'clean']
execute a recipe:
['recipe', 'test', 'clean']

10. Command line commands
$ deployii help
The following commands are available:
- fetch Fetch the requested project from git and run the build.
- help Provides help information about console commands.
- init Initialise a new build.php script from the build.tpl.php
template file.
- migrate Manages application migrations. (Yii 2 built-in feature)
- run Run the build; if no target is specified, the "default"
one will be ran.

11. The DeploYii home folder
During the first execution, the home folder is created in ~/.deployii
This folder contains:
● the VERSION file used by the version manager to ensure the the folder is up
to date;
● your personal global script commands and recipes;
● the log folder containing the execution logs of your build scripts;
● the templates folder containing the files used by the init command. You
can customise them to suit your needs;
● the workspace folder used by the fetch command.

12. Getting started
● Download DeploYii using composer or from GitHub;
● Install it globally (optional - see the wiki);
● run ./deployii fetch example_basic to try out the basic example;
● the basic example is downloaded into your workspace folder. You can run
it again using the run command passing the path to the basicExample/
folder;
● you can now try to create your own build script using the init command.
For more information please refer to the DeploYii online documentation.

13. Extending DeploYii
After creating your build script you should have a file called build.php inside
the deployii folder of your project.
To create a script command or recipe just create them inside the commands or
recipes folder inside your deployii folder. (Those folders needs to be
created too)
To have them globally, so that they can be used across different projects, just
create or move them to the corresponding folders inside your DeploYii home
folder.

14. Links & references
● DeploYii homepage: http://www.deployii.com
● DeploYii on GitHub: https://github.com/giovdk21/deployii
● The DeploYii wiki: https://github.com/giovdk21/deployii/wiki
● DeploYii examples: https://github.com/giovdk21/deployii-examples
● Yii Framework: http://www.yiiframework.com
● My Twitter account: https://twitter.com/giovdk21

15. Thanks for watching!
Giovanni Derks - http://derks.me.uk - @giovdk21