Packages

Raxos is a collection of twenty-one PHP libraries. Each one solves a single concern, targets PHP 8.5, and can be installed on its own with Composer. There is no meta package to pull in.

The libraries are grouped into four areas below. Every package links to its own introduction, installation guide and API reference.

Core

Foundational building blocks that the rest of the ecosystem depends on.

FoundationBase utilities used across Raxos: access traits, network and IP helpers, an Option type and small helpers.ContractInterfaces and contracts shared by every other Raxos module.ErrorBase exception classes with a stable ExceptionId.ReflectionWrappers around PHP reflection for classes, methods, properties and types.ContainerA dependency injection container driven by PHP attributes.CollectionCollection primitives such as ArrayList, Map and Paginated.DateTimeDate and time primitives and utilities.SecurityJWT, HMAC, NanoId, ULID, TOTP two factor and token helpers.

HTTP & Web

Everything you need to build an HTTP API: a typed HTTP layer, routing, authentication, rate limiting and specification generation.

HTTPRequest and response objects, methods, validation and an HTTP client.RouterA fast, attribute based router with controllers and middleware.OAuth2OAuth2 server integration for raxos/router.Rate LimitRedis backed rate limiting for raxos/router.OpenAPIGenerates an OpenAPI 3.1 specification from PHP attributes.

Data

Persistence and retrieval: an ORM, a search layer on top of it, and a cache.

DatabaseAn ORM and query builder for MySQL, MariaDB and SQLite over PDO.SearchA search provider built on top of raxos/database.CacheA Redis based cache with tag support.

Integrations & Output

Talking to the outside world: mail, messaging, barcodes, wallet passes and a terminal framework.

MailMail delivery through Mailgun, Postmark and SMTP.Message BusA message bus with queue support.BarcodeBarcode generators such as QR and PDF417 using GD.WalletApple and Google Wallet pass generator.TerminalA CLI framework with commands, middleware and a printer.

How they fit together

Most packages build on foundation and the interfaces in contract. A few notable relationships:

• router builds on http, and oauth2, rate-limit and openapi extend the router.
• search is built on top of database.
• security, cache and datetime are used throughout the HTTP and data layers.

Install only what you need

Every package declares its own dependencies, so installing one pulls in just the Raxos modules it actually uses. Start with the Guide for installation and conventions.