This package is not installable via Composer 1.x, please make sure you upgrade to Composer 2+. Read more about our Composer 1.x deprecation policy.

Yii 2 Basic Project Template with Deployer.php support

2.0.6 2016-01-24 11:02 UTC

This package is not auto-updated.

Last update: 2021-09-15 09:52:34 UTC


Yii 2 Basic Project Template with Deployer.php support is a skeleton Yii 2 application for rapidly creating projects.

The template contains the basic features including user login/logout and a contact page. It includes all commonly used configurations that would allow you to focus on adding new features to your application.

Latest Stable Version Total Downloads


  • This project can be deployed by Deployer
  • config/db.php and yii is generated automatically
  • An .htaccess is added to the web folder and FollowSymlinks is turned on.
  • Project can be served directly from source on the development machine, but this requires manual setup - namely creating yii and config/db.php.


See my blog post Deploying Yii with Deployer


See also yii2-app-advanced-deployer


  assets/             contains assets definition
  commands/           contains console commands (controllers)
  config/             contains application configurations
  controllers/        contains Web controller classes
  deployer/recipe     contains Deployer recipes
  deployer/templates  contains templates configured by Deployer
  deployer/stage      contains configuration file for Deployer
  mail/               contains view files for e-mails
  migrations/         contains migrations
  models/             contains model classes
  tests/              contains various tests for the application
  vendor/             contains dependent 3rd-party packages
  views/              contains view files for the Web application
  web/                contains the entry script and Web resources


The minimum requirement by this project template that your Web server supports PHP 5.4.0.


mv deployer.phar /usr/local/bin/dep
chmod +x /usr/local/bin/dep

For more, see Deployer - Installation


Install via Composer

If you do not have Composer, you may install it by following the instructions at getcomposer.org.

You can then install this project template using the following command:

php composer.phar global require "fxp/composer-asset-plugin:~1.1.1"
php composer.phar create-project --prefer-dist --stability=dev jacmoe/yii2-app-basic-deployer basic



First, create a file entitled servers.yml in the deployer/stage directory.
You can copy the contents of servers-sample.yml to get you started.

Create db on server

Prior to deployment, make sure that you have created a database on the server you want to deploy to.

deploy command

When you have created a server configuration file, all you need to do is run this command:

dep deploy production


dep deploy local

Note that the server configuration for the local stage needs to have a key called local because that will make Deployer create a local server that doesn't use ssh.
If the active stage does not have local set for the server, you need an ssh server on your local machine (sudo apt-get install openssh-server).

Configure without deploy

It is very common to serve the project in place when developing, and therefore this project template ships with a function to configure files, set writable directories and install vendors.

Simply run:

dep inplace local

This command assumes that you've set the deploy dir in the servers.yml configuration file to point to your current source directory (the directory you are in).


The configuration is handled automatically from the values you wrote in servers.yml using the templates in deployer/templates.


  • Refer to the README in the tests directory for information specific to basic application tests.