Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/8ctopus/nginx-php-fpm-alpine
A super light docker web server with nginx and php-fpm on top of Alpine Linux for development purposes
https://github.com/8ctopus/nginx-php-fpm-alpine
alpine-linux composer docker docker-image https nginx php-fpm xdebug
Last synced: 5 days ago
JSON representation
A super light docker web server with nginx and php-fpm on top of Alpine Linux for development purposes
- Host: GitHub
- URL: https://github.com/8ctopus/nginx-php-fpm-alpine
- Owner: 8ctopus
- License: mit
- Created: 2020-04-18T08:31:39.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2020-11-10T09:47:29.000Z (about 4 years ago)
- Last Synced: 2025-01-02T23:18:03.970Z (7 days ago)
- Topics: alpine-linux, composer, docker, docker-image, https, nginx, php-fpm, xdebug
- Language: Shell
- Homepage:
- Size: 81.1 KB
- Stars: 1
- Watchers: 2
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
## project description
A super light docker web server with nginx and php-fpm on top of Alpine Linux for development purposes
- nginx 1.18.0 with SSL
- php-fpm 7.4.12
- Xdebug debugging from host
- Xdebug profiler
- composer
- zsh
The docker image size is 43 MB.
## cool features
- nginx and php configuration files are exposed on the host.
- Just works with any domain name.
- https is configured out of the box.
- All changes to the config files are automatically applied (hot reload).
- Xdebug is configured for remote debugging (no headaches).
## start container
Starting the container with `docker-compose` offer all container functionalities.
```bash
docker-compose up
CTRL-Z to detach
docker-compose stop
```
Alternatively the container can also be started with `docker run`.
```bash
docker run -p 80:80 --name web 8ct8pus/nginx-php-fpm-alpine:latest
CTRL-Z to detach
docker stop container
```
## access website
http://localhost/
https://localhost/
The source code is located inside the `html` directory.
## set domain name
To set the domain name to www.test.com, edit the environment variable in the docker-compose file
environment:
- DOMAIN=www.test.com
Add this line to the system host file. Editing the file requires administrator privileges.
C:\Windows\System32\drivers\etc\hosts
127.0.0.1 test.net www.test.net
## https
To remove "Your connection is not private" nag screens, import the certificate authority file under ssl/certificate_authority.pem in the browser's certificates under Trusted Root Certification Authorities.
guide: https://support.globalsign.com/digital-certificates/digital-certificate-installation/install-client-digital-certificate-windows-using-chrome
## Xdebug debugging
This github repository is configured to debug php code in Visual Studio Code.
To start debugging, open the VSCode workspace then select `Run > Start debugging` then open the site in the browser.
For other IDEs, set the Xdebug debugging port to 9001.
## Xdebug profiling
The docker image is configured to profile php code.
To start profiling, add the `XDEBUG_PROFILE` variable to the request as a GET, POST or COOKIE.
http://localhost/?XDEBUG_PROFILE
Profiles are stored in the log directory.
## access container through command line
```bash
docker exec -it web zsh
```
## build docker image
```bash
docker build -t nginx-php-fpm-alpine:dev .
```
## extend docker image
In this example, we add the php-curl extension.
```bash
docker-compose up --detach
docker exec -it web zsh
apk add php-curl
exit
docker-compose stop
docker commit web nginx-php-fpm-alpine-curl:dev
```
To use the new image, update the image link in the docker-compose file.
## more info on php-fpm
https://php-fpm.org/about/
## notes
In Windows hot reload doesn't work with WSL 2, you need to use the legacy Hyper-V.