spiral

spiral/framework

PHP MIT Web Dev

High-Performance PHP Framework

2.1k stars
91 forks
active
GitHub +2 / week

2.1k

Stars

91

Forks

45

Open issues

30

Contributors

3.17.0 03 Jun 2026

AI Analysis

Spiral Framework is a high-performance, long-living PHP framework built on a hybrid runtime model where PHP code stays in memory via RoadRunner, complemented by 60+ PSR-compatible components. It serves teams building long-running, event-driven PHP applications requiring native support for queues, gRPC, WebSockets, and background workers—not a general-purpose framework for typical CRUD web applications, but rather a specialized tool for systems demanding persistent memory and horizontal scalin...

Web Dev Web Framework Discovery value: 5/10
Documentation 8/10
Activity 9/10
Community 7/10
Code quality 8/10

Inferred from signals mentioned in the README (tests, CI, type safety) — not a review of the actual code.

Overall score 8/10

AI's overall editorial judgment — not an average of the bars above, can weigh other factors too.

php-framework long-running-services application-server psr-compliant roadrunner
Actively maintained Well documented MIT licensed Niche/specialized use case Production ready
Deep Analysis · Based on README and public signals
3d ago

PHP framework combining long-running processes with RoadRunner server for performance-oriented backends

Spiral is a full-stack PHP framework built around a hybrid execution model where PHP code persists in memory via RoadRunner, a high-performance application server written in Go. It targets developers building data-heavy or real-time applications in PHP who need performance characteristics closer to Go or Node.js. The framework includes 60+ PSR-compatible components, ORM (Cycle), queue integrations, and gRPC support. Adoption appears concentrated in Eastern Europe and among teams already committed to the RoadRunner ecosystem; mainstream PHP adoption remains modest relative to Laravel or Symfony.

Origin

Spiral was created in 2012 and has evolved from a traditional PHP framework into an opinionated platform centered on long-running process models. The RoadRunner application server (Go-based) emerged as a core differentiator around 2019–2020, positioning Spiral as a performance-first alternative to traditional CGI-based PHP frameworks.

Growth

The project gained traction in Eastern European developer communities and among teams optimizing for high-throughput workloads. GitHub stars grew modestly and plateaued around 2,000–2,100 in recent years. Recent growth (2 stars in 7 days as of 2026-07-07) reflects slow, stable adoption rather than viral adoption. The RoadRunner bridge and ecosystem of integrations (Temporal, Cycle ORM, data-grid) suggest sustained, deliberate development rather than rapid market capture.

In production

Adoption not formally verified in README. README claims 'battle-tested since 2013' and references TechEmpower benchmarks performance data, but no customer names, case studies, or adoption metrics disclosed. Presence of Packagist downloads badge and multiple bridge packages suggests some production use, but scale cannot be quantified from available metadata. Adoption appears real but limited to specialist communities.

Code analysis
Architecture

Based on README, Spiral uses a hybrid runtime model: PHP services stay resident in memory managed by RoadRunner (a Go-based application server handling GRPC, queues, WebSockets), while application PHP code runs continuously. The framework claims to be PSR-{3,4,7,11,12,14,15,16,17} compliant and exposes 60+ components. Appears to emphasize dependency injection, static analysis, and code generation (scaffolding). Specific architectural patterns (MVC, HMVC, CQRS, RPC-oriented, CLI) are documented but implementation details are not visible from README alone.

Tests

README displays Codecov and Shepherd.dev badges, indicating test coverage tracking is active. No specific percentage disclosed in truncated README. Coverage appears monitored but concrete metrics not documented in excerpt.

Maintenance

Last push 2026-07-06 (one day before evaluation date), indicating active maintenance. GitHub Actions build badge present. Project appears under active development with regular commits. Issue/PR activity not visible in metadata provided, but recent push and CI integration suggest ongoing stewardship. No signs of stagnation; cadence appears consistent and deliberate rather than high-velocity.

Honest verdict

ADOPT IF: your team is building high-throughput or latency-sensitive PHP backends, already familiar with or committed to RoadRunner, and can invest in learning a less-mainstream framework. Performance benchmarks and queue/gRPC support are genuine technical strengths. AVOID IF: you need the largest ecosystem, hiring pool, and community resources (Laravel/Symfony are safer bets); or you prioritize rapid scaffolding via boilerplate generators without learning the framework's opinionated model. MONITOR IF: you are evaluating PHP frameworks for a new project and performance is critical but you haven't committed to RoadRunner—consider learning curve and team familiarity as real costs alongside benchmark gains.

Independent dimensions

Mainstream potential

3/10

Technical importance

7/10

Adoption evidence

3/10

Risks
  • Hiring/team familiarity: dramatically smaller developer pool than Laravel or Symfony; onboarding costs higher for teams without RoadRunner/long-running-process experience.
  • Ecosystem maturity: 60+ components is substantial, but real-world third-party integrations and community packages likely fewer than Laravel. Bridge packages (Cycle, Temporal, etc.) are maintained but dependent on upstream projects.
  • Long-running process model introduces operational complexity: memory leak management, graceful shutdown, state isolation between requests—non-trivial compared to stateless CGI model. README acknowledges anti-memory-leak tools but doesn't detail operational burden.
  • RoadRunner dependency: framework is tightly coupled to RoadRunner. Teams must operate and monitor a separate Go binary alongside PHP, adding devops complexity. RoadRunner is actively maintained (separate Spiral Scout project) but represents a single point of infrastructure dependency.
  • Adoption uncertainty: modest GitHub stars, limited public case studies, and concentrated regional adoption suggest unverified production usage at scale. Network effects favor incumbents; switching from Laravel/Symfony is costly.
Prediction

Spiral will likely remain a specialized, high-performance alternative for teams optimizing backend throughput in PHP—not a mainstream framework replacement. Growth will plateau or continue at slow, steady rate as niche adoption stabilizes. RoadRunner ecosystem may expand faster than Spiral framework itself as more teams adopt long-running PHP models. Viability depends on continued Spiral Scout maintenance and RoadRunner success.

0 found this helpful

Newsletter

Get analyses like this every Monday

Free weekly digest of the most interesting open-source discoveries.

Languages

PHP
100%
Hack
0%

Information

Language
PHP
License
MIT
Last updated
21h ago
Created
175mo ago
Analyzed with
anthropic/claude-haiku-4-5

Stars over time

Loading…

Contributors over time

Top 100 contributors only — repos with more will plateau at 100.

Loading…

Similar repos

slimphp

slimphp/Slim

Slim is a lightweight PHP micro-framework designed for building web...

12.3k PHP
roadrunner-server

roadrunner-server/roadrunner

RoadRunner is a high-performance PHP application server and process manager...

8.5k Go DevOps
symfony

symfony/symfony

Symfony is a mature, widely-adopted PHP framework for building web and console...

31.1k PHP Web Dev
the-benchmarker

the-benchmarker/web-frameworks

This is a benchmark repository comparing HTTP framework performance across...

7.1k PHP Web Dev
cakephp

cakephp/cakephp

CakePHP is a mature PHP web framework built on MVC principles, designed for...

8.8k PHP Web Dev
vs. alternatives
Laravel

Laravel dominates mainstream PHP market share with built-in server capabilities and larger ecosystem. Spiral targets performance-critical workloads via RoadRunner; Laravel traditionally optimizes for rapid feature development and hosting simplicity. Spiral appeals to teams needing lower latency and long-running process control; Laravel is default for greenfield web apps.

Symfony

Symfony is the other incumbent, emphasizing modularity and enterprise integration. Spiral is more opinionated and smaller. Both can integrate with RoadRunner, but Spiral is purpose-built for the long-running model; Symfony adoption of that pattern is less idiomatic.

Slim

Slim is a minimalist microframework (12K stars vs. Spiral's 2K). Spiral is full-stack (ORM, queues, templates, security); Slim is lightweight routing-first. Spiral targets monolithic or long-running apps; Slim for APIs and small deployments.

RoadRunner-only approach

Teams can use RoadRunner with Laravel or Symfony via adapters rather than adopting Spiral framework. Spiral is the only framework deeply integrated from inception; switching costs are higher but performance/ergonomics may be tighter.

Flight / ThinkPHP

Both are smaller PHP frameworks (2.8K–2.9K stars, similar scale to Spiral). Flight is microframework; ThinkPHP is Chinese-market focused. Spiral differentiates via RoadRunner integration and performance positioning; none are direct replacements.