This repository holds docker images which can be used for Kohana Framework.
There will be 4 branches which all server a different purpose:
| Branch | Purpose |
|---|---|
| master | Image for a development/production environment. |
| travis | Image for Unit-Testing inside Travis CI (CAREFUL: Don't use on production servers.) |
| devel | Development Branch for master. Only latest kohana:devel version will be supproted. |
| travis-devel | Development Branch for travis. Only latest kohana:devel version will be supproted. |
Using the container images
Using one of the container is quite straight forward. The docker repository for them is called
By specifying the desired branch as docker-tag you can acquire the desired image.
Note: for pulling the master branch use latest as tag name.
e.g. This will pull the master branch image:
docker pull kohanaworld/docker:latest
e.g This will pull the travis branch image:
docker pull kohanaworld/docker:travis-devel
After executing the docker pull command from above you're done setting up
your docker image, now you can go ahead and use it!
Example for using master image
Coming Soon. Stay tuned!
Example for using travis-devel image
For this particular Image you have multiple options.
-
Some IDE's (PHPStorm for example) have full support for docker unittesting, you just need to configure it there and you are good to go!
-
Run the tests from the cli. Execute the following cli commands (from within your Kohana installation folder): Start container in background and mount installation folder:
docker stop unittest && docker rm unittest docker run -dtP --name unittest -v $(pwd):/tmp/kohana/ kohanaworld/docker:travis-devel
-
Start services, install composer requirements and run PHPUnit
docker exec unittest /bin/sh -c "service redis-server start; service memcached start" cd /tmp/kohana update-alternatives --config php # switch php version composer install php vendor/bin/phpunit"
_(Hint) You can execute a /bin/bash shell inside the container and modify it before Unit-Testing
docker exec -it unittest /bin/bash cd /tmp/kohana
_(Hint) You can execute a single test
docker exec -it unittest /bin/bash cd /tmp/kohana composer install php vendor/bin/phpunit --filter HTMLTest php vendor/bin/phpunit --filter HTMLTest --debug
_
For more examples / tutorials how to create and interact with container visit the official Docker Help
Roadmap
| Target | Release date |
|---|---|
Initial master image |
2024.07.01 |
Initial travis image |
2024.06.16 |
Initial travis-devel |
2024.06.09 |
Contributing
As usual, fork and send pull requests
Getting Help
- Open issues in this project.