PHP tools to build robust long-running processes.

Geezer is a PHP library that provides tools for building and managing robust long-running processes. It uses Docker for development environment setup and includes a comprehensive set of development tools for testing, code analysis, and maintenance.

• PHP ^8.4
• ext-pcntl extension

• Docker

• recruiterphp/concurrency ^5.0 - For concurrent processing
• symfony/console ^7.3 - For command-line interface

Clone the repository and install dependencies:

git clone <repository-url>
cd geezer
make install

The project includes a comprehensive Makefile with the following targets:

• make build - Build the Docker image
• make up - Start the services in detached mode
• make down - Stop the services
• make clean - Clean up containers and volumes

• make install - Install composer dependencies
• make update - Update composer dependencies

• make test - Run all PHPUnit tests
• make phpstan - Run PHPStan static analysis
• make rector - Run Rector for code refactoring
• make fix-cs - Fix code style using PHP-CS-Fixer

• make shell - Open a bash shell in the PHP container
• make logs - View PHP container logs in follow mode

1. Start the development environment:

   make up

2. Run tests to ensure everything is working:

   make test

3. Access the container for development:

   make shell

The project maintains high code quality standards using:

• PHPUnit for unit testing
• PHPStan for static analysis
• PHP-CS-Fixer for code formatting
• Rector for automated refactoring

Run all quality checks:

make test
make phpstan
make fix-cs
make rector