https://github.com/yiisoft/yii2-docker

Official Docker images suitable for Yii 2.0
https://github.com/yiisoft/yii2-docker

docker-image hacktoberfest php yii yii2

Last synced: about 17 hours ago
JSON representation

Official Docker images suitable for Yii 2.0

• Host: GitHub
• URL: https://github.com/yiisoft/yii2-docker
• Owner: yiisoft
• License: bsd-3-clause
• Created: 2017-03-08T11:14:09.000Z (almost 8 years ago)
• Default Branch: master
• Last Pushed: 2024-08-05T15:07:10.000Z (5 months ago)
• Last Synced: 2024-10-29T14:35:35.697Z (2 months ago)
• Topics: docker-image, hacktoberfest, php, yii, yii2
• Language: PHP
• Homepage: https://www.yiiframework.com/
• Size: 211 KB
• Stars: 384
• Watchers: 42
• Forks: 202
• Open Issues: 7
• Metadata Files:
  • Readme: README.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE

Awesome Lists containing this project

README

        


    
Yii2 PHP Docker Image

    


[![Build Status](https://github.com/yiisoft/yii2-docker/actions/workflows/docker-image.yml/badge.svg)](https://github.com/yiisoft/yii2-docker/actions/workflows/docker-image.yml)

This is the repo of the official [Yii 2.0 Framework](http://www.yiiframework.com/) image on [DockerHub](https://hub.docker.com/r/yiisoftware/yii2-php/) for PHP.

## About

These Docker images are built on top of the official PHP Docker image, they contain additional PHP extensions required to run Yii 2.0 framework, but no code of the framework itself.

The `Dockerfile`(s) of this repository are designed to build from different PHP-versions by using *build arguments*.

### Available versions for `yiisoftware/yii2-php`

The following images are built on a *weekly* basis for **arm64** and **amd64**. For regular commits on **master** we only build images for **amd64** suffixed with `-latest`/`-latest-min`.

Minimal images

```

8.3-apache-min, 8.3-fpm-min, 8.3-fpm-nginx-min

8.2-apache-min, 8.2-fpm-min, 8.2-fpm-nginx-min

8.1-apache-min, 8.1-fpm-min, 8.1-fpm-nginx-min

```

Development images

```

8.3-apache, 8.3-fpm, 8.3-fpm-nginx

8.2-apache, 8.2-fpm, 8.2-fpm-nginx

8.1-apache, 8.1-fpm, 8.1-fpm-nginx

```

#### Deprecated or EOL versions

```

8.0-*

7.4-*

7.3-*

7.2-*

7.1-*

7.0-*

5.6-*

```

## Setup

    cp .env-dist .env

Adjust the versions in `.env` if you want to build a specific version.

> **Note:** Please make sure to use a matching combination of `DOCKERFILE_FLAVOUR` and `PHP_BASE_IMAGE_VERSION`

## Configuration

- `PHP_ENABLE_XDEBUG` whether to load an enable Xdebug, defaults to `0` (false)  *not available in `-min` images*

- `PHP_USER_ID` (Debian only) user ID, when running commands as webserver (`www-data`), see also [#15](https://github.com/yiisoft/yii2-docker/issues/15)

## Building

    docker-compose build

## Testing

    docker-compose run --rm php php /tests/requirements.php

### Xdebug

To enable Xdebug, set `PHP_ENABLE_XDEBUG=1` in .env file

Xdebug is configured to call ip `xdebug.remote_host` on `9005` port (not use standard port to avoid conflicts),

so you have to configure your IDE to receive connections from that ip.

## Documentation

More information can be found in the [docs](/docs) folder.

## FAQ

- We do not officially support Alpine images, due to numerous issues with PHP requirements and because framework tests are not passing.

- Depending on the (Debian) base-image (usually PHP <7.4) you might need to set `X_LEGACY_GD_LIB=1`

- test