https://github.com/tbreuss/php-web-server
Docker image providing a lightweight PHP development environment using PHP's built-in web server.
https://github.com/tbreuss/php-web-server
docker docker-alpine php php-builtin-server php-web-server
Last synced: 5 months ago
JSON representation
Docker image providing a lightweight PHP development environment using PHP's built-in web server.
- Host: GitHub
- URL: https://github.com/tbreuss/php-web-server
- Owner: tbreuss
- License: mit
- Created: 2025-10-22T05:59:33.000Z (5 months ago)
- Default Branch: main
- Last Pushed: 2025-10-26T08:17:42.000Z (5 months ago)
- Last Synced: 2025-10-26T09:20:31.852Z (5 months ago)
- Topics: docker, docker-alpine, php, php-builtin-server, php-web-server
- Language: Dockerfile
- Homepage:
- Size: 11.7 KB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Docker Image using PHP's built-in Web Server
This Docker image provides a lightweight PHP development environment using PHP's built-in web server.
Based on the official Alpine PHP image, it's ideal for quickly spinning up ad hoc projects.
## Supported PHP Versions
- 8.2
- 8.3
- 8.4
Older versions should also work.
## Build Image
Build Docker image based on the latest supported PHP version.
docker build -t php:8.4 https://github.com/tbreuss/php-web-server.git
Optionally, you can also use an older PHP version.
docker build --build-arg PHP_VERSION=8.2 -t php:8.2 https://github.com/tbreuss/php-web-server.git
docker build --build-arg PHP_VERSION=8.3 -t php:8.3 https://github.com/tbreuss/php-web-server.git
## Apply Image
Start your project as follows:
docker run --rm -v .:/app -p 8888:8888 php:8.4
If you have a specific document root directory:
project/
├─ your-code/
└─ web/
└─ index.php
Then you can start your project as follows:
docker run --rm -v .:/app -p 8888:8888 php:8.4 php -S 0.0.0.0:8888 -t /app/web
And if you want to use Xdebug, here's how to do it:
docker run --rm -e XDEBUG_CONFIG="client_host=172.17.0.1" -e XDEBUG_MODE=debug -e XDEBUG_SESSION_START=true -v .:/app -p 8888:8888 php:8.4 php -S 0.0.0.0:8888 -t /app/web
Note: On macOS, the `client_host` setting should be `host.docker.internal`.
To start the container with an interactive terminal session, run the following command:
docker run --rm -it -v .:/app php:8.4 ash