Yii 2 Basic Project Template with Deployer.php support
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.
- This project can be deployed by Deployer
yiiis generated automatically
.htaccessis added to the
webfolder and FollowSymlinks is turned on.
- Project can be served directly from source on the development machine, but this requires manual setup - namely creating
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
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
You can copy the contents of
servers-sample.yml to get you started.
Prior to deployment, make sure that you have created a database on the server you want to deploy to.
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).
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.
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
- Refer to the README in the
testsdirectory for information specific to basic application tests.