KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #typescript #ai-agent #developer-tools #claude-code #codex #deepseek-harness #ai-agents #cli #react #mcp

docker-symfony

★ 75 Open GitHub ↗

This is a simple REST API app written in Symfony2, running on Docker Compose

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# docker-symfony

[![Build Status](https://travis-ci.org/sskorc/docker-symfony.svg?branch=master)](https://travis-ci.org/sskorc/docker-symfony)

This is a simple To-do list application with GUI and REST API written in [Symfony](http://symfony.com/), running on
multiple [Docker](http://www.docker.com/) containers. [Docker Compose](http://docs.docker.com/compose/)
is used for orchestration.

## Previous versions
- If you are looking for products example rather than to-do list,
check the [`products` tag](https://github.com/sskorc/docker-symfony/tree/products).
- If you are looking for a multiple containers example with Apache,
check the [`apache` tag](https://github.com/sskorc/docker-symfony/tree/apache).
- If you are looking for a single container example with supervisor and Vagrant,
check the [`single-container` tag](https://github.com/sskorc/docker-symfony/tree/single-container).

## Multiple containers

This environment uses 3 containers:

1. The `php` container with PHP-FPM, being build from `Dockerfile`. It's based on `sskorc/symfony2-mongo` image. You can
find its `Dockerfile` in [this repo](https://github.com/sskorc/symfony2-mongo-dockerimage). This container shares
the application sources with the host machine.
2. The `nginx` container with nginx, pulled directly from the official nginx image on Docker Hub. This container shares
the application sources with the host machine.
3. The `db` container with MongoDB, pulled directly from the official MongoDB image on Docker Hub. This container shares
DB data with the Docker Machine VM.

Containers are managed by Docker Compose. The configuration is in the `docker-compose.yml`.

## Requirements

Basically, you need to have [Docker Compose installed](http://docs.docker.com/compose/#installation-and-set-up).

If you use Mac OS X or Windows as your host OS, I recommend using [Docker Machine](https://docs.docker.com/machine/)
as the proxy VM to run Docker.

## How to use it?

### Start the environment

In the project root directory run the following command:
```
docker-compose up -d
```

This command will build the `php` Docker image and run its container together with `nginx` and `db` containers.

### Prepare the environment

1. Log in to the `php` container by running the following command:
    ```
    docker exec -it dockersymfony_php_1 bash
    ```

2. Install dependencies by running the following command:
    ```
    cd /var/www/docker-symfony && composer install -n
    ```

3. Change `/tmp` dir permissions:
    ```
    chown -R www-data:www-data /tmp
    ```

### Update your hosts

#### Mac OS X

1. Check Docker Machine IP address: `docker-machine ip dev`.

2. Assuming it's 192.168.99.100, add the following line to your `/etc/hosts` file:
    ```
    192.168.99.100 docker-symfony.dev
    ```

#### Linux

TBA

#### Windows

1. Check Docker Machine IP address: `docker-machine ip dev`.

2. Assuming it's 192.168.99.100, add the following line to your `%SystemRoot%\System32\drivers\etc\hosts` file:
    ```
    192.168.99.100 docker-symfony.dev
    ```

### Test the application

#### Web

You can test the application by following [http://docker-symfony.dev/]() URL in your browser.

#### REST API

- You can test the REST API by sending the POST request with the `name` parameter to `http://docker-symfony.dev/api/tasks`.
Example:
    ```
    curl -w "\n" -H "Content-Type: application/json" -X POST -d '{"name":"Hello!"}' http://docker-symfony.dev/api/tasks
    ```

- You can get all products by sending the GET request to `http://docker-symfony.dev/api/tasks`. Example:
    ```
    curl -w "\n" -X GET http://docker-symfony.dev/api/tasks
    ```

#### Debugging

This application is ready to be debugged by [Xdebug](https://xdebug.org/). If you want to configure your host and
PHPStorm to debug this app, please follow [the instruction](docs/xdebug.md).

## Continuous Delivery

The application is being build on [Travis CI](https://travis-ci.org/sskorc/docker-symfony) and it's being deployed to
[Docker Cloud](https://cloud.docker.com/).

docker-symfony

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README