PHP File Service

HTTP microservice written in PHP for handling files.

Features:

• Upload files (default and chunk based)
• Download files
• Upload (chunk combine) complete webhook
• API based access control
• Generate image thumbnails with Imagick

TODO:

• Failed job list api endpoint
• Failed job webhook
• Failed job retry (manual or auto)

Install

Requirements:

• PHP (>8.1)
• Nginx (>1.2)
• PostgreSQL (>14)
• RabbitMQ (>3)

Docker-compose

docker-compose up -d
docker-compose exec php composer install

Api

• POST "/upload", See UploadForm.php for details
• POST "/chunked-upload", See ChunkedUploadForm.php for details
• PUT "/chunked-upload-complete", See ChunkedUploadCompleteForm.php for details
• GET "/download/([a-zA-Z0-9-]+)"
• GET "/image/([a-zA-Z0-9-]+)", See ImageForm.php for details

Docker

Build and push:

docker buildx build -t <your_registry>/php-file-service:<version> . --platform=linux/arm64,linux/amd64 --push

Useful scripts:

Linter

docker-compose exec php ./vendor/bin/php-cs-fixer fix --diff --dry-run --config .php-cs-fixer.php --verbose

Thank You

• Special thanks to @dblaci for the technical support.