Placeholder service

There is a self-hosted service for images placeholders generation. Service works similar way as https://placeholder.com/, but self-hosted.

Full code coverage report: http://files.antonshell.me/github-actions/placeholder-service/master/coverage/coverage/

Psalm html report: http://files.antonshell.me/github-actions/placeholder-service/master/psalm/psalm-report.html

Install in docker

1 . Clone repository

git clone https://github.com/antonshell/placeholder-service.git

2 . Run containers

cd placeholder-service
docker-compose up

3 . Install dependencies

docker-compose exec php-fpm composer install

4 . Open in browser

http://127.0.0.1:16880/ - Healthcheck

http://127.0.0.1:16880/img - Default image

Demo

https://placeholder.antonshell.me/img?width=500

Usage

1 . Healthcheck

https://placeholder.antonshell.me/

2 . Get default image (300x300)

https://placeholder.antonshell.me/img

3 . Set image size

Set width https://placeholder.antonshell.me/img?width=500 - 500x500

Set height https://placeholder.antonshell.me/img?height=400 - 400x400

Set width & height https://placeholder.antonshell.me/img?width=320&height=240 - 320x240

4 . Set custom text

https://placeholder.antonshell.me/img?text=Hello

5 . Set text size (default: 28)

https://placeholder.antonshell.me/img?width=800&text_size=40

6 . Set text color

https://placeholder.antonshell.me/img?color_text=000

7 . Set background color

https://placeholder.antonshell.me/img?color_bg=000

8 . Set format (PNG, JPEG, GIF)

https://placeholder.antonshell.me/img?format=png

https://placeholder.antonshell.me/img?format=jpeg

https://placeholder.antonshell.me/img?format=gif

Tests

1 . Run tests

Local environment:

composer test

Docker environment:

docker-compose exec php-fpm composer test

2 . Update code coverage badges

Local environment:

composer update-badges

Docker environment:

docker-compose exec php-fpm composer update-badges

Codestyle

1 . Fix codestyle

composer cs-fixer src
docker-compose exec php-fpm composer cs-fixer src

2 . Code quality with Psalm

composer psalm
composer psalm-report-html

docker-compose exec php-fpm composer psalm
docker-compose exec php-fpm composer psalm-report-html

Open in browser: psalm-report.html

Macos docker environment(Mutagen)

1 . Install mutagen

brew install mutagen-io/mutagen/mutagen
mutagen daemon start

2 . Run containers

docker-compose down --remove-orphans || true
mutagen project start || mutagen project terminate

3 . Troubleshooting:

Fix permissions:

docker-compose exec php-fpm chmod -R 777 /var/www

Disable permission tracking:

git config core.fileMode false

Setup xdebug (Docker)

https://blog.denisbondar.com/post/phpstorm_docker_xdebug

nanawel / placeholder-service