craklabs/skeleton-service

This project is intented to be a skeleton for PHP based services

dev-master 2015-06-30 14:36 UTC

Requires

• craklabs/rest-normalizer: ~1.0
• dbtlr/silex-doctrine-migrations: ~1.0
• doctrine/dbal: ~2.2
• doctrine/migrations: ~1.0@dev
• league/statsd: 1.2.0
• mockery/mockery: 0.9.4
• monolog/monolog: ~1.13
• predis/service-provider: ~1.0
• silex/silex: ~1.2
• symfony/console: ~2.4.0

Requires (Dev)

• behat/behat: ~2.5
• phpunit/phpunit: ~4.6
• symfony/browser-kit: ^2.6

MIT

• Sylvain Witmeyer

README

This project is intented to be a skeleton for PHP based services.

Getting started

$ docker build -t crakmedia/skeleton-service:latest .

$ cp docker-compose.yml.dist docker-compose.yml

$ docker-compose run shell

    $ composer install

$ docker-compose up

Overriding default settings

Should over need to override the default configuratio for any of the services runing within the container, you can add docker volumes to your docker-compose.yml. As an example, say you need to modify the default nginx configuration provided by the base image. In this case you just need to add a new voluming mapping under the volumes section in your docker-compose.yml file:

volumes:
 ... existing mappings ...
 - /path/to/nginx.conf:/etc/nginx/nginx.conf

The following is a list of files/directories added in the base image, which could be overriden:

- /etc/nginx/conf.d
- /etc/nginx/nginx.conf
- /etc/php.ini
- /etc/php-fpm.conf
- /etc/php-fpm.d

Of course you can always use docker volumes to override any file/directory within a running container. See here for more details.

Migrations

Run migrations

$ docker-compose run shell

$ php app/console migrations:migrate

Tests

First, go in your container shell

$ docker-compose run shell

Copy tests/config.yml.dist to tests/config.yml and configure your test database

$ cp tests/config.yml.dist tests/config.yml

Functional tests

$ bin/behat

Generate doc

Install apidoc

$ npm install apidoc -g

Generate doc

$ apidoc -i src/Controller/ -o doc

Launch doc/index.html with your browser.

Monitor your metrics

In order to monitor metrics of application, you should use $app['monitor']. For more information about how to use, see documentation of the client