https://github.com/tuupola/php-docker-k8s
Examples how to run PHP with Docker and Kubernetes
https://github.com/tuupola/php-docker-k8s
docker kubernetes kustomize php
Last synced: 12 months ago
JSON representation
Examples how to run PHP with Docker and Kubernetes
- Host: GitHub
- URL: https://github.com/tuupola/php-docker-k8s
- Owner: tuupola
- Created: 2022-12-07T13:57:33.000Z (over 3 years ago)
- Default Branch: master
- Last Pushed: 2023-03-04T10:17:34.000Z (over 3 years ago)
- Last Synced: 2025-03-18T15:11:53.557Z (over 1 year ago)
- Topics: docker, kubernetes, kustomize, php
- Language: PHP
- Homepage:
- Size: 63.5 KB
- Stars: 15
- Watchers: 4
- Forks: 5
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# PHP with Docker and Kubernetes
Examples how to run [Slim Framework](https://www.slimframework.com/) with Docker and Kubernetes. Same setups should work with any PHP application. Subfolders have their own more specific README.
## Setups
### Apache + MariaDB
[The simplest possible setup](apache/). PHP 8.1 as Apache an module and MariaDB in separate containers. This setup also has a Kubernetes and Kustomize example.
### NGINX + PHP-FPM + MariaDB
[The fashionable setup](nginx-phpfpm/). PHP 8.1 as PHP-FPM reverse proxied by NGINX and MariaDB as database. All in separate containers. This setup also has a Kubernetes example.
### Caddy + Apache + MariaDB
[Modern simple setup](caddy-apache/). Caddy as a reverse proxy in front of PHP 8.1 as an Apache module and MariaDB as the database. All in separate containers. With Docker Caddy handles TLS automatically. There is no Kubernetes example. With Kubernetes you would use ingress instead of manually installed Caddy.
### Caddy + PHP-FPM + MariaDB
[Modern setup](caddy-phpfpm/). PHP 8.1 as PHP-FPM reverse proxied by Caddy and MariaDB as database. All in separate containers. With Docker Caddy handles TLS automatically. TODO: add Kubernetes example.
### Traefik + Apache + MariaDB
[Enterprisey setup](traefik-apache/). Traefik as reverse proxy in front of PHP 8.1 as Apache an module and MariaDB as the database. With Docker Traefik handles TLS automatically. There is no Kubernetes example. With Kubernetes you would use ingress instead of manually installed Traefik.
## Docker Compose
Use docker compose for development. The application source is bindmounted into the container so edits can be seen instantly.
```
$ docker compose up --build
```
## Docker Stack
Docker stack is usually used for deployment into a swarm. Although you could use it also for development. To use Docker stack you must have initialised a [Docker swarm](https://docs.docker.com/engine/swarm/) before deploying.
```
$ docker swarm init
$ docker stack deploy -c stack.yaml slim
```
## Kubernetes
### Manifests
Vanilla manifests are the simplest way to create Kubernetes deployments. If an example supports Kubernetes manifests it will have a file named `deployment.yaml`.
```
$ kubectl apply -f deployment.yaml
```
### Kustomize
[Kustomize](https://kustomize.io/) provides more robust way of deploying applications to Kubernetes. If an example supports Kustomize it will have a subfolder named `kustomize`.
```
$ kubectl apply -k kustomize
```
You can also deploy alternative production or staging configurations. These are just examples on how to use Kustomize. Only difference between production and staging deployments is the number of replicas.
```
$ kubectl apply -k kustomize/overlays/production
$ kubectl apply -k kustomize/overlays/staging
```
If you have the standalone kustomize binary installed, you can also see the generated manifests with the following.
```
$ kustomize build kustomize
$ kustomize build kustomize/overlays/production
$ kustomize build kustomize/overlays/staging
```
### Ingress
Since Kubernetes does not bind ports to localhost, you should somehow make `example.local` resolv to the ingress ip address. Easiest way is to add it to the hosts file.
```
$ kubectl get ingress
NAME CLASS HOSTS ADDRESS PORTS AGE
slim-ingress traefik example.local 172.23.0.2 80 70s
$ echo "172.23.0.2 example.local" | sudo tee --append /etc/hosts
```
There are several ways to create a local Kubernetes for testing. Easiest are probably [k3d](https://k3d.io/) and [Minikube](https://minikube.sigs.k8s.io/docs/start/). I have not tested, but [Docker Desktop](https://docs.docker.com/desktop/kubernetes/) most likely works too.
```
$ k3d cluster create slim-test --servers 1 --agents 3
```
Or you can use the provided config file.
```
$ k3d cluster create -f k3d.yaml
```
With Minikube remember to enable ingress addon first.
```
$ minikube addons enable ingress
$ minikube start
```
## Testing
After deploying you can test different endpoints with curl.
```
$ curl --ipv4 --include example.localhost
$ curl --ipv4 --include example.localhost/cars
$ curl --ipv4 --include example.localhost/static.html
$ curl --ipv4 --include example.localhost/server\?foo=bar
```
If testing Kubernetes deployment use `example.local` instead.
```
$ curl --ipv4 --include example.local
$ curl --ipv4 --include example.local/cars
$ curl --ipv4 --include example.local/static.html
$ curl --ipv4 --include example.local/server\?foo=bar
```
Note that some setups use TLS.
```
$ curl --ipv4 --include https://example.localhost
$ curl --ipv4 --include https://example.localhost/cars
$ curl --ipv4 --include https://example.localhost/static.html
$ curl --ipv4 --include https://example.localhost/server\?foo=bar
```