PHPackages phoneburner/pinch - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Framework](/categories/framework) 4. / 5. phoneburner/pinch ActiveLibrary[Framework](/categories/framework) phoneburner/pinch ================= The Pinch API Framework Monorepo v0.0.36(7mo ago)003MITPHPPHP ^8.4CI passing Since Aug 8Pushed 2mo agoCompare [ Source](https://github.com/phoneburner/pinch)[ Packagist](https://packagist.org/packages/phoneburner/pinch)[ RSS](/packages/phoneburner-pinch/feed)WikiDiscussions main Synced 1mo ago READMEChangelog (10)Dependencies (74)Versions (21)Used By (0) [![Logo](packages/template/public/images/pinch-logo.svg)](https://github.com/phoneburner/pinch) Pinch Framework =============== [](#pinch-framework) > Feels like home, just without the salty tears of frustration The Pinch Framework is a "batteries-included," very-highly-opinionated PHP framework, derived from the original Salt framework/application used by PhoneBurner. While modeled on other modern "general purpose" frameworks like Symfony and Laravel, the Pinch Framework is designed and optimized as an API backend. Ideally, it adapts the best core features of Salt without dragging along unnecessary complexity, technical debt, and the (many) design decisions we regret. The goal is to provide users with a robust framework with minimum cognitive overhead from the original Salt framework, avoiding the pitfalls of bringing in a full-fledged third-party framework and trying to adapt that to our needs. ### Guiding Principles [](#guiding-principles) 1. Compatiblity with the PSRs should be the general rule, but sensible deviations are allowed, especially in the name of type safety. 2. Where practical, third-party library code should be wrapped in a way that lets us expose our own interface. This allows us to swap out the underlying library without changing application code. 3. Separation of "framework" and "application" concerns 4. Take the best parts of Salt, leave the rest, and add new features wrapping the best of modern PHP 5. Configuration driven, with environment variables as the primary source of overrides ### Notable Differences from Salt [](#notable-differences-from-salt) - The time zone configuration for PHP and the database is set to UTC by default. - Configuration is defined by the environment, and not by the path value of a request. - Overriding configuration values is done via environment variables, not by adding local configuration files. - Database migrations are handled by the [Doctrine Migrations](https://www.doctrine-project.org/projects/migrations.html) library, as opposed to Phinx. - PHPUnit 12 is used for testing, this is a significant upgrade from the previous version. Notably, unit tests are defined with attributes and data providers must be defined as static functions. - When cast to a string, `\Phoneburner\Pinch\Component\PhoneNumber\DomesticPhoneNumber` is formatted as an E.164 phone number ("+13145551234"), instead a ten-digit number ("3145551234"). ### Backwards Capability Guarantees [](#backwards-capability-guarantees) Classes and interfaces with the `#[PhoneBurner\Pinch\Attribute\Usage\Contract]` attribute are considered part of the public API of the framework and should not be changed without a major version bump. These "contracts" can be freely used in application code. Conversely, classes and interfaces with the `#[PhoneBurner\Pinch\Attribute\Usage\Internal]`attribute are very tightly coupled to third-party vendor and/or framework logic, and should not be used in application code. ### Included Functionality [](#included-functionality) - PSR-7/PSR-15 Request & Response Handling - PSR-11 Dependency Injection Container - PSR-3 Logging with Monolog - PSR-14 Event Dispatching based on Symfony EventDispatcher - Local/Remote Filesystem Operations with Flysystem - Development Environment Error Handling with Whoops - Console Commands with Symfony Console - Interactive PsySH Shell with Application Runtime - Doctrine ORM & Migrations - Redis for Remote Caching with PSR-6/PSR-16 Support - RabbitMQ for Message Queues and Job Processing - Task Scheduling with Cron Expression Parsing with Symfony Scheduler - SMTP/API Email Sending with Symfony Mailer Docker ------ [](#docker) The default Docker image used by this project is based on Docker's official PHP 8.4 FPM image with default with a few additional extensions installed and configuration tweaks. The base image's "php.ini-production" configure is used as the basis for the php.ini file. The values in this file are overridden by the "php-development.ini" or "php-production.ini" files, depending on the environment. Sodium ------ [](#sodium) The official PHP 8.4 FPM image ships with an older version of libsodium, which does not support the latest functionality added to PHP's Sodium extension. The project image updates 1.0.20, so AEGIS-256 related functions are available. ### XDebug [](#xdebug) The PHP Docker image used by this project includes the XDebug extension, but it is not enabled in the same way as the other extensions. To load the XDebug extension, "zend\_extension=xdebug.so" must be added to an INI file. It is enabled by default in the Docker image as the "php-development.ini" is copied to the PHP INI directory as "settings.ini". Production builds should copy the "php-production.ini" file instead, which does not include the XDebug extension (enabling the JIT instead). Notes ----- [](#notes) - Events can be defined at the component level; Event listeners must be defined at the framework or application level. ### Health Score 37 — LowBetter than 83% of packages Maintenance75 Regular maintenance activity Popularity2 Limited adoption so far Community12 Small or concentrated contributor base Maturity53 Maturing project, gaining track record Bus Factor1 Top contributor holds 75.3% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~3 days Recently: every ~12 days Total 20 Last Release 222d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/7ecc476ac18daccbca443ff60a1a3a58d213617e7954eb9511d63c685a7c4c3d?d=identicon)[kevinreeves](/maintainers/kevinreeves) --- Top Contributors [![andysnell](https://avatars.githubusercontent.com/u/7006523?v=4)](https://github.com/andysnell "andysnell (122 commits)")[![actions-user](https://avatars.githubusercontent.com/u/65916846?v=4)](https://github.com/actions-user "actions-user (37 commits)")[![johncongdon](https://avatars.githubusercontent.com/u/67472?v=4)](https://github.com/johncongdon "johncongdon (2 commits)")[![kevinreeves](https://avatars.githubusercontent.com/u/723899?v=4)](https://github.com/kevinreeves "kevinreeves (1 commits)") ### Code Quality TestsPHPUnit Static AnalysisRector ### Embed Badge ![Health badge](/badges/phoneburner-pinch/health.svg) ``` [![Health](https://phpackages.com/badges/phoneburner-pinch/health.svg)](https://phpackages.com/packages/phoneburner-pinch) ``` ### Alternatives [shopware/platform The Shopware e-commerce core 3.3k1.5M3](/packages/shopware-platform)[shopware/core Shopware platform is the core for all Shopware ecommerce products. 595.2M386](/packages/shopware-core)[sylius/sylius E-Commerce platform for PHP, based on Symfony framework. 8.4k5.6M651](/packages/sylius-sylius)[sulu/sulu Core framework that implements the functionality of the Sulu content management system 1.3k1.3M152](/packages/sulu-sulu)[laravel/framework The Laravel Framework. 34.6k509.9M17.0k](/packages/laravel-framework)[contao/core-bundle Contao Open Source CMS 1231.6M2.4k](/packages/contao-core-bundle) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)