Yii and Docker

For development and deployments Yii applications can be run as Docker containers. A container is like a lightweight isolated virtual machine that maps its services to host’s ports, i.e. a webserver in a container on port 80 is available on port 8888 on your (local)host.

Containers can solve many issues such as having identical software versions at developer’s computer and the server, fast deployments or simulating multi-server architecture while developing.

You can read more about Docker containers on docker.com.

Requirements

• docker
• docker-compose

Visit the download page to get the Docker tooling.

Installation

After installation, you should be able to run docker ps and see an output similar to

CONTAINER ID   IMAGE   COMMAND   CREATED   STATUS   PORTS

This means your Docker daemon is up and running.

Additionally, run docker-compose version, your output should look like this

docker-compose version 1.20.0, build unknown
docker-py version: 3.1.3
CPython version: 3.6.4
OpenSSL version: OpenSSL 1.1.0g  2 Nov 2017

With Compose you can configure manage all services required for your application, such as databases and caching.

Resources

• PHP-base images for Yii can be found at yii2-docker
• Docker support for yii2-app-basic
• Docker support for yii2-app-advanced is in development

Usage

Basic commands for Docker are

docker-compose up -d

to start all services in your stack, in the background

docker-compose ps

to list running services

docker-compose logs -f

to view logs for all services, continuously

docker-compose stop

to stop all services in your stack, gracefully

docker-compose kill

to stop all services in your stack, immediately

docker-compose down -v

to stop and remove all services, be aware of data loss when not using host-volumes

To run commands in a container

docker-compose run --rm php composer install

runs composer installation in a new container

docker-compose exec php bash

executes a bash in a running php service

Advanced topics

Yii framework tests

You can run the dockerized framework tests for Yii itself as described here.

Database administration tools

When running MySQL as (mysql), you can add phpMyAdmin container to your stack like the following:

    phpmyadmin:
        image: phpmyadmin/phpmyadmin
        ports:
            - '8888:80'
        environment:
            - PMA_ARBITRARY=1
            - PMA_HOST=mysql
        depends_on:
            - mysql