PHPackages tugrul/apigen - 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. [HTTP & Networking](/categories/http) 4. / 5. tugrul/apigen ActiveLibrary[HTTP & Networking](/categories/http) tugrul/apigen ============= Generate REST API SDK libraries from annotated PHP interfaces. PSR-18 based, attribute-driven. v1.0.3(5mo ago)03MITPHPPHP >=8.1CI passing Since Feb 25Pushed 5mo agoCompare [ Source](https://github.com/tugrul/apigen)[ Packagist](https://packagist.org/packages/tugrul/apigen)[ RSS](/packages/tugrul-apigen/feed)WikiDiscussions master Synced 1w ago READMEChangelog (4)Dependencies (12)Versions (5)Used By (0) Tugrul ApiGen ============= [](#tugrul-apigen) **Generate REST API SDK clients from annotated PHP interfaces.** Define your API surface as a PHP interface, decorate methods with attributes, run the generator — done. ApiGen handles URL building, parameter binding, body encoding, authentication, and response decoding. You bring the PSR-18 HTTP client of your choice. ``` // 1. Define interface UserApi { #[GET('/users/{id}')] #[Returns('array')] public function getUser(#[Path] int $id): array; #[DELETE('/users/{id}')] public function deleteUser(#[Path] int $id): void; } // 2. Generate (once, at development time) $gen = new StubGenerator(__DIR__ . '/Generated'); $gen->generate(UserApi::class); // 3. Use $client = ClientBuilder::create('https://api.example.com') ->withPsr18($httpClient, $psr17, $psr17, $psr17) ->withBearerToken('my-token') ->build(); $api = new UserApiImpl($client); $user = $api->getUser(42); $api->deleteUser(42); ``` --- Requirements ------------ [](#requirements) RequirementVersionPHP≥ 8.1psr/http-client^1.0psr/http-factory^1.0psr/http-message^1.1 || ^2.0Installation ------------ [](#installation) ``` composer require tugrul/apigen ``` Documentation ------------- [](#documentation) TopicDescription[Quick Start](docs/quick-start.md)Define → Generate → Use in 5 minutes[Attributes Reference](docs/attributes.md)Every attribute, target, and parameter[Authentication](docs/authentication.md)Built-in strategies, OAuth 2, custom auth[Code Generation](docs/generation.md)StubGenerator, naming strategies, PSR-4 paths[CLI Tool](docs/cli.md)`apigen generate`, `apigen list`, config files[Client Configuration](docs/client.md)ClientBuilder, middleware, custom decoders[ProxyRegistry](docs/proxy.md)Group multiple stubs under one object[Error Handling](docs/errors.md)ApiException, error table[Testing](docs/testing.md)Running tests, testing your own stubs[Architecture](docs/architecture.md)Package structure, request lifecycleKey Features ------------ [](#key-features) - **Attribute-driven** — HTTP verbs, path/query/header/body binding, auth, encoding, and response types are all declared with native PHP 8 attributes. No XML, no YAML, no code to write beyond the interface. - **PSR-18 transport** — bring your own HTTP client. Guzzle, Symfony HttpClient, Buzz, or any PSR-18 implementation. - **Pluggable auth** — Bearer token, API key, Basic, HMAC, OAuth 2 client credentials, or your own `AuthStrategy`. Per-endpoint overrides with `#[UseAuth]`. - **OAuth 2 token caching** — in-memory, PHP session, filesystem, or any PSR-16 store (Redis, Memcached, APCu). Auto-refresh with configurable leeway. - **Five naming strategies** — control the generated class name and output namespace. Default, Suffix, Sub-namespace, Callable, and per-interface Map. - **PSR-4 aware output paths** — reads `composer.json` to compute the correct subdirectory offset, avoiding double-nesting of namespace roots. - **CLI tool** — `apigen generate` and `apigen list` commands with config file support. - **Middleware** — chain pre/post request hooks for logging, retry, rate-limiting, and more. At a Glance ----------- [](#at-a-glance) ``` ┌─────────────────────────────────────────────────────────────┐ │ Your PHP Interface + Attributes │ │ ↓ (apigen generate) │ │ Generated Stub Class (concrete, final, PSR-18 backed) │ │ ↓ │ │ ClientBuilder → DefaultSdkClient → PSR-18 HTTP Client │ └─────────────────────────────────────────────────────────────┘ ``` License ------- [](#license) MIT ### Health Score 33 — LowBetter than 72% of packages Maintenance70 Regular maintenance activity Popularity3 Limited adoption so far Community6 Small or concentrated contributor base Maturity47 Maturing project, gaining track record Bus Factor1 Top contributor holds 100% 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 ~2 days Total 4 Last Release 166d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/8203eaef0737a157a828b37dc85a63defa0d26e3f215135fe76cff6c67d2fa20?d=identicon)[tugrul](/maintainers/tugrul) --- Top Contributors [![tugrul](https://avatars.githubusercontent.com/u/163442?v=4)](https://github.com/tugrul "tugrul (7 commits)") --- Tags apisdkrestpsr-18generatorattributesphp8 ### Code Quality TestsPHPUnit ### Embed Badge ![Health badge](/badges/tugrul-apigen/health.svg) ``` [![Health](https://phpackages.com/badges/tugrul-apigen/health.svg)](https://phpackages.com/packages/tugrul-apigen) ``` ### Alternatives [tempest/framework The PHP framework that gets out of your way. 2.3k37.6k21](/packages/tempest-framework)[guzzlehttp/psr7 PSR-7 message implementation that also provides common utility methods 7.9k1.1B4.4k](/packages/guzzlehttp-psr7)[flow-php/flow PHP ETL - Extract Transform Load - Data processing framework 86337.5k](/packages/flow-php-flow)[telnyx/telnyx-php Official Telnyx PHP SDK — APIs for Voice, SMS, MMS, WhatsApp, Fax, SIP Trunking, Wireless IoT, Call Control, and more. Build global communications on Telnyx's private carrier-grade network. 36826.2k2](/packages/telnyx-telnyx-php)[getbrevo/brevo-php Official PHP SDK for the Brevo API. 1004.1M59](/packages/getbrevo-brevo-php)[retailcrm/api-client-php PHP client for RetailCRM API 681.1M1](/packages/retailcrm-api-client-php) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)