Yii 3 development environment
This repo contains tools to set up a development environment for Yii 3 packages. It allows to work on separate packages and test the result in other packages at the same time.
If you prefer manual install, you need:
- GNU/Linux or Windows with bash
- PHP 7.4 or higher
- Composer installed and
composeron the command line
If you prefer Docker, you only need to install Docker.
git clone https://github.com/yiisoft/yii-dev-tool cd yii-dev-tool composer install ./yii-dev install
The above command will clone all Yii 3 packages and run
composer install in them.
You may select packages by providing a second argument:
./yii-dev install di,rbac,yii-cycle,view
Tip: You can speed up Composer significantly by installing prestissimo plugin globally.
Note: In case you are using PhpStorm you have to add
yiisoftexclusion pattern in "Settings → Directories → Exclude Files". Else it would go into infinite indexing cycle.
To upgrade yii-dev-tool to the latest version, run the following commands:
cd yii-dev-tool git pull composer update
To customize the configuration of yii-dev-tool, create your local configuration
packages.local.php.example as example. In this file you will find examples of all available
If you want to run yii-dev-tool in a Docker container, run the following command:
docker-compose run --rm php bash
Afterwards you can run the above commands like
Suppose we want to work on three interdependent packages:
Package yii-demo depends on package view, and package view depends on package i18n.
Suppose we want to add new features to package i18n, and then use them in package view. After that, we will need to run the tests in package yii-demo and make sure that everything works correctly.
Step 1: create forks
Go to the page of each repository and click the "Fork" button:
Suppose my nickname on Github is "samdark". Then I will get three forks:
For your nickname you will get other fork names.
Step 2: install yii-dev-tool
Now install yii-dev-tool:
git clone https://github.com/yiisoft/yii-dev-tool cd yii-dev-tool composer install
Step 3: configure yii-dev-tool to use forks
In order for yii-dev-tool to use our forks, they must be configured. Create your configuration:
cd yii-dev-tool cp packages.local.php.example packages.local.php
Specify the forks in config
$packages = [ 'yii-demo' => 'samdark/yii-demo', 'view' => 'samdark/view', 'i18n' => 'samdark/i18n', ];
Step 4: install packages
Now install the packages:
cd yii-dev-tool ./yii-dev install yii-demo,view,i18n
This command clones the fork repositories from GitHub to the local directory
for them and executes
composer install in each package. Then symlinks will be created:
- yii-dev-tool/dev/yii-demo/vendor/yiisoft/view -> yii-dev-tool/dev/view
- yii-dev-tool/dev/view/vendor/yiisoft/i18n -> yii-dev-tool/dev/i18n
Due to these symlinks, changes in packages will immediately affect the operation of packages that depend on them. It is very convenient for development.
Step 5: create a git branch for work
Create a new feature-x branch in the repositories:
cd yii-dev-tool ./yii-dev git/checkout-branch feature-x yii-demo,view,i18n
Step 6: writing the code
Now make the necessary changes to the code of package i18n in folder
Next, make changes to the code of package view in folder
And, finally, change package yii-demo in folder
Step 7: run the tests
Make sure the tests pass. For instance, package yii-demo tests can be run with the following command:
cd yii-dev-tool/dev/yii-demo ./vendor/bin/phpunit
Step 8: commit and push the changes to the fork repositories
Commit the changes:
cd yii-dev-tool ./yii-dev git/commit "Add feature X" yii-demo,view,i18n
Push the new code to remote repositories:
cd yii-dev-tool ./yii-dev git/push yii-demo,view,i18n
Step 9: create pull requests
Go to the pages of the original repositories and create a PR in each:
That's all. We developed new functionality and submitted it for review
Remember that yii-dev-tool contains many other commands for working with repositories:
./yii-dev exec– executes the specified console command in each package
./yii-dev git/checkout-branch– creates, if not exists, and checkout a git branch
./yii-dev git/commit– add and commit changes into each package repository
./yii-dev git/pull– pull changes from package repositories
./yii-dev git/push– push changes into package repositories
./yii-dev git/status– show git status of packages
./yii-dev install– install packages
./yii-dev lint– check packages according to PSR12 standard
./yii-dev replicate/files– copy files specified in
config/replicate/files.phpinto each package
./yii-dev replicate/composer-config– merge
composer.jsonof each package
./yii-dev update– update packages
If you encounter any problems, create an issue – and we'll try to help you.