Semitexa

Product Introduction

1. Definition: Semitexa is an open-source, high-performance PHP 8.4 web application framework designed for building long-running, scalable server-side applications. It is a Swoole-native framework, meaning it leverages the Swoole extension to provide asynchronous, coroutine-based performance, moving beyond the traditional request-per-process PHP model.
2. Core Value Proposition: Semitexa exists to enable developers and AI agents to build, understand, and modify complex applications faster and with greater confidence. Its primary value lies in integrating a live project graph for impact analysis, a unified server-driven rendering model that eliminates separate frontend frameworks, and built-in enterprise features like tenancy and queues, all verified by a robust testing and tracing system.

Main Features

1. Swoole-Native Runtime & Async Architecture: Semitexa is built from the ground up for the Swoole extension. This allows it to handle thousands of concurrent connections on a single process, support Server-Sent Events (SSE) for live updates natively, and manage background queues efficiently. How it works: It runs as a persistent application server, drastically reducing bootstrap overhead per request and enabling true asynchronous programming patterns within PHP.
2. AI-Optimized Project Graph: The framework includes or integrates with a semitexa-project-graph package that creates a structural map of the entire codebase. This graph allows developers or AI coding assistants to query routes, class dependencies, and the "blast radius" of potential changes before editing. This feature directly tackles codebase comprehension and safe refactoring in large-scale PHP applications.
3. Unified Server-Side Rendering (SSR) with Deferred Delivery: Semitexa promotes a "no second frontend" philosophy. Pages are rendered on the server and can stream to the browser in stages. It uses deferred blocks (parts of the page that load asynchronously after the initial render) and live SSE updates to create dynamic, app-like experiences without requiring a separate JavaScript framework like React or Vue.js. The ORM, templates, and data flow are all part of the same coherent server-driven model.
4. Built-in Multi-Tenancy & Isolated Data Layers: Tenancy is not an afterthought but a foundational layer. Semitexa provides built-in mechanisms for tenant context resolution, ensuring strict data isolation and tenant-aware configuration for SaaS applications. This eliminates the need to bolt on third-party packages and ensures tenancy logic is consistent across HTTP requests, queues, and CLI commands.
5. Attribute-Driven Declarative Programming: Configuration is done primarily through PHP 8.4 attributes. Routes are defined with attributes on payload classes, dependency injection is managed via property attributes, and data models are mapped using attributes. This leads to zero-config routing, declarative DI contracts validated at boot, and cleaner, more self-documenting code compared to XML/YAML config files.

Problems Solved

1. Pain Point: The complexity and risk of modifying large, monolithic PHP applications. Developers struggle to understand dependencies and the full impact of a change, leading to bugs and system instability.
2. Pain Point: The frontend-backend split overhead. Maintaining separate JavaScript frontend frameworks, APIs, and state management doubles the cognitive load and tooling required for full-stack development.
3. Target Audience: Senior PHP Developers and Architects building scalable SaaS platforms, real-time applications, or complex internal systems. DevOps Engineers managing long-running application servers. Teams leveraging AI-assisted development who need a codebase that is queryable and predictable for AI agents.
4. Use Cases: Building a multi-tenant B2B SaaS application with real-time dashboard updates. Creating a high-throughput API gateway or microservice with Swoole. Developing an internal admin panel with complex data relationships and live notifications without a separate frontend build step. Onboarding new developers or AI tools onto a large legacy PHP monolith by using the project graph for exploration.

Unique Advantages

1. Differentiation: Unlike traditional PHP frameworks (Laravel, Symfony) that are request-lifecycle bound, Semitexa is a persistent application server like Node.js or Go frameworks, offering superior performance for I/O-bound tasks. Compared to other Swoole frameworks, its integrated project graph and AI/LLM module for agentic development are unique. Unlike full-stack frameworks that use a separate frontend, Semitexa's server-driven rendering model unifies the stack.
2. Key Innovation: The deep integration of a structural project graph as a first-class citizen within the development workflow. This transforms the codebase from a collection of files into a queryable knowledge graph, enabling precise impact analysis ("blast radius") and providing a structured context window for AI-powered development and refactoring, which is a novel approach in the PHP ecosystem.

Frequently Asked Questions (FAQ)

1. Is Semitexa a replacement for Laravel or Symfony? Semitexa targets a different niche: long-running, high-concurrency applications. It is not a direct replacement but an alternative for projects where Swoole's performance benefits are critical and where its integrated project graph and server-rendered UI model align with team workflows. Traditional frameworks are better for simpler, request-response applications.
2. How does Semitexa handle frontend interactivity without JavaScript? Semitexa does use JavaScript, but minimally. It leverages modern browser capabilities like Server-Sent Events (SSE) for live data pushes and deferred blocks loaded via fetch. This allows for highly interactive, real-time user interfaces while keeping the rendering logic and component state primarily on the server, simplifying state management and data consistency.
3. What is the learning curve for Semitexa compared to traditional PHP? The learning curve is significant for developers only familiar with traditional PHP. Concepts like Swoole's event loop, coroutines, and persistent application state require study. However, for developers experienced with Node.js, Go, or Swoole itself, and for teams valuing the project graph and AI-assisted features, the long-term productivity gains can justify the initial investment.
4. Is Semitexa production-ready for enterprise SaaS applications? Based on its feature set—built-in multi-tenancy, robust ORM, queue system, and comprehensive tracing/testing—Semitexa is architecturally designed for enterprise SaaS. Its "live demo" with 81 feature routes demonstrates maturity. However, as a newer open-source framework, its community size and package ecosystem are smaller than established giants, which is a factor for some enterprises.
5. How does the Semitexa Project Graph work with AI coding assistants? The project graph creates a machine-readable map of your application's structure (classes, methods, routes, dependencies). An AI assistant (like those using the semitexa/llm module) can query this graph to understand code context, answer questions about the codebase, and predict the impact of changes before they are made, making AI-assisted refactoring and feature development more accurate and safe.