Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/leocavalcante/dwoole
⚙️ Docker image for Swoole apps with Composer, auto-restart on development and a production-ready version.
https://github.com/leocavalcante/dwoole
development docker hot-reload production swoole
Last synced: 3 months ago
JSON representation
⚙️ Docker image for Swoole apps with Composer, auto-restart on development and a production-ready version.
- Host: GitHub
- URL: https://github.com/leocavalcante/dwoole
- Owner: leocavalcante
- License: mit
- Created: 2019-02-21T21:23:26.000Z (almost 6 years ago)
- Default Branch: main
- Last Pushed: 2021-01-01T23:01:10.000Z (about 4 years ago)
- Last Synced: 2024-10-03T10:50:38.419Z (4 months ago)
- Topics: development, docker, hot-reload, production, swoole
- Language: PHP
- Homepage: https://cloud.docker.com/repository/docker/leocavalcante/dwoole
- Size: 83 KB
- Stars: 32
- Watchers: 7
- Forks: 4
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
> ⚠️ First, I'd like to invite you to take a look at the official Swoole image: https://hub.docker.com/r/phpswoole/swoole
# Dwoole
[Docker](https://www.docker.com/) image for [Swoole](https://www.swoole.co.uk/) apps with [Composer](https://getcomposer.org/), auto-restart on development and a production-ready version.
## Usage
### Requirements
- `composer.json`
- `index.php` (this will be your entry-point)
Entry-point file can be overridden with the environment variable `ENTRY_POINT_FILE`. See [this](https://github.com/leocavalcante/siler/blob/master/examples/swoole-chat/docker-compose.yml) for an example.
#### Exposed port is 9501
#### Using Docker Compose?
A `docker-compose.yml` file would look like:
```yaml
version: "3"
services:
web:
container_name: my_app
image: leocavalcante/dwoole:dev
volumes:
- ./:/app
ports:
- "9501:9501"
```
Yeah! Simple like that.
### What is inside?
Options enabled:
- `--enable-openssl`
- `--enable-sockets`
- `--enable-http2`
- `--enable-mysqlnd`
#### Development
Comes bundled with:
- [sdebug](https://github.com/swoole/sdebug)
- Hot-restart
- PDO MySQL & MySQLi
- MongoDB
- Redis
Watch interval can be overridden with the environment variable `WATCH_INTERVAL`.
#### Production
Comes bundled with:
- _Nothing_
It is Swoole only. That is because only you knows what your project really needs.
The recommended way to use the production variant is as a base image for you project image.
```Dockerfile
FROM leocavalcante/dwoole:prod
# Add only what your project really needs
COPY . /app
```
Then you can add whatever extensions you would like.
##### Adding PHP extensions
```Dockerfile
RUN apk add --no-cache freetype-dev libjpeg-turbo-dev libpng-dev libzip-dev \
&& docker-php-ext-configure gd && docker-php-ext-install -j$(nproc) gd zip
```
##### Adding PECL extensions
```Dockerfile
RUN pecl install mongodb \
&& docker-php-ext-enable mongodb
```
```Dockerfile
RUN pecl install redis \
&& docker-php-ext-enable redis
```
###### [You can always take a look at the development Dockerfile to see how it installs extensions that you might have used.](https://github.com/leocavalcante/dwoole/blob/master/development/Dockerfile)
#### Why not inotify?
- https://github.com/docker/for-win/issues/56
- > Linux containers only receive file change events (“inotify events”) if the original files are stored in the Linux filesystem. - https://docs.docker.com/docker-for-windows/wsl/
⚠ Dwoole will always commit to the latest PHP and Swoole versions.