Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/cnizzardini/cakephp-docker
A cakephp 4 template for Docker and Kubernetes.
https://github.com/cnizzardini/cakephp-docker
cakephp cakephp-docker cakephp4 docker docker-compose docker-compose-template docker-template
Last synced: about 2 months ago
JSON representation
A cakephp 4 template for Docker and Kubernetes.
- Host: GitHub
- URL: https://github.com/cnizzardini/cakephp-docker
- Owner: cnizzardini
- License: mit
- Created: 2020-09-26T15:15:52.000Z (about 4 years ago)
- Default Branch: master
- Last Pushed: 2023-10-01T15:59:42.000Z (about 1 year ago)
- Last Synced: 2024-10-09T16:31:57.866Z (2 months ago)
- Topics: cakephp, cakephp-docker, cakephp4, docker, docker-compose, docker-compose-template, docker-template
- Language: PHP
- Homepage:
- Size: 382 KB
- Stars: 30
- Watchers: 2
- Forks: 19
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-cakephp - CakePHP Docker - A cakephp/app template for docker. (Development Environment)
README
# 🍰 CakePHP Docker
[](https://github.com/cnizzardini/cakephp-docker/actions)
[](https://book.cakephp.org/5/en/index.html)
[](.docker)
[](.kube)
[](https://hub.docker.com/_/php)
[](https://hub.docker.com/_/nginx)
[](https://hub.docker.com/_/mysql)
A [cakephp/app](https://github.com/cakephp/app) template for Docker Compose and Kubernetes. You might also be
interested in [CakePHP Galley](https://gitlab.com/amayer5125/galley) which is similar to Laravel Sail
or [DevilBox](https://devilbox.readthedocs.io/en/latest/examples/setup-cakephp.html).
#### Dependencies:
- [Docker 20](https://docs.docker.com/engine/release-notes/) or higher
- Make
| Service | Host:Port | Docker Host | Image |
|------------------------|----------------|-------------|----------------------------------------------------------------------------------------------|
| PHP8.1-FPM w/ Xdebug 3 | - | php | [cnizzardini/php-fpm-alpine:8.1-latest](https://hub.docker.com/r/cnizzardini/php-fpm-alpine) |
| NGINX 1.19 | localhost:8080 | web | [nginx:1.19-alpine](https://hub.docker.com/_/nginx) |
| MySQL 8 | localhost:3607 | db | [library/mysql:8](https://hub.docker.com/_/mysql) |
- [Installation](#installation)
- [MacOS Notes](#mac-notes)
- [Usage](#usage)
- [PHP](#php)
- [MySQL](#mysql)
- [NGINX](#nginx)
- [Xdebug](#xdebug)
- [Reinstall](#reinstall)
## Installation
Fork and clone this repository then run:
```console
make init
```
That's it! Now just remove `app/*` from [.gitignore](.gitignore). You may also want to remove
[.assets](.assets) and adjust defaults in [.github](.github), [.docker](.docker), and [.kube](.kube).
> Note: `make init` and `make init.nocache` output interactively, while `make start` and `make up` do not.
## Mac Notes
1. Change your `SHELL` in the Makefile to `/bin/zsh`. This improves various output from the Makefile such as emoji's.
3. Mac ships with an older version of `sed` so install `gnu-sed` for some targets in the Makefile:
```console
brew install gnu-sed
```
Then update `sed` to `gsed` in the Makefile.
## Usage
After install browse to [http://localhost:8080](http://localhost:8080) to see the CakePHP welcome page.
A [Makefile](Makefile) is provided with some optional commands for your convenience. Please review the Makefile as
these commands are not exact aliases of docker-compose commands.
| Make Command | Description |
|-------------------------|-----------------------------------------------------------------------------------------|
| `make` | Shows all make target commands |
| `make init` | Runs docker build, docker-compose up, and copies over env files |
| `make init.nocache` | Same as make.init but builds with --no-cache |
| `make start` | Starts services `docker-compose -f .docker/docker-compose.yml start` |
| `make stop` | Stops services `docker-compose -f .docker/docker-compose.yml stop` |
| `make up` | Create and start containers `docker-compose -f .docker/docker-compose.yml up -d` |
| `make down` | Take down and remove all containers `docker-compose -f .docker/docker-compose.yml down` |
| `make restart` | Restarts services `docker-compose -f .docker/docker-compose.yml restart` |
| `make php.sh` | PHP terminal `docker exec -it --user cakephp sh` |
| `make php.restart` | Restarts the PHP container |
| `make db.sh` | DB terminal `docker exec -it sh` |
| `make db.mysql` | MySQL terminal `mysql -u root -h 0.0.0.0 -p --port 3307` |
| `make web.sh` | Web terminal `docker exec -it sh` |
| `make xdebug.on` | Restarts PHP container with xdebug.mode set to debug,coverage |
| `make xdebug.off` | Restarts PHP container with xdebug.mode set to off |
| `make composer.install` | `docker exec composer install --no-interaction` |
| `make composer.test` | `docker exec composer test` |
| `make composer.check` | `docker exec composer check` |
### PHP
See [.docker/README.md](.docker/README.md) for details.
Shell:
```console
make php.sh
```
Helper commands:
```console
make composer.install
make composer.test
make composer.check
```
### MySQL
See [.docker/README.md](.docker/README.md) for details.
Shell:
```console
make db.sh
```
MySQL shell (requires mysql client on your localhost):
```console
make db.mysql
```
### NGINX
See [.docker/README.md](.docker/README.md) for details.
Shell:
```console
make web.sh
```
### Xdebug
Xdebug is disabled by default. To toggle:
```console
make xdebug.on
make xdebug.off
```
### PHPStorm + Xdebug
Xdebug 3's default port is `9003`.
Go to `File > Settings > Languages & Frameworks > PHP > Servers`
- Name: `localhost`
- Host: `localhost`
- Port: `8080`
- Debugger: `Xdebug`
- Use path mappings: `Enable`
Map your project's app directory to the absolute path on the docker container `/srv/app`
## Reinstall
To completely reinstall delete existing containers and images, then remove the `app/` directory and run `make init`
again.