# Plain PHP Example

This example demonstrates the intended usage shape of `gnexus/auth-client` in a minimal non-framework PHP application.

It is not production-ready.

## What It Shows

- redirecting a user to `gnexus-auth`
- handling the authorization callback
- exchanging code for tokens
- fetching the current user
- verifying and parsing webhooks
- storing state, PKCE data and tokens in native PHP session

## Files

- `bootstrap.php` - package construction
- `stores.php` - session-backed example stores
- `index.php` - start authorization flow
- `callback.php` - handle authorization callback
- `webhook.php` - verify and parse webhook request

## Requirements

The example assumes you install compatible PSR implementations in the real package repository, for example:

- PSR-18 HTTP client
- PSR-17 request factory
- PSR-17 stream factory

The example code uses placeholders for these objects. Wire them with the implementations your project uses.

## Runtime Notes

- call `session_start()` before using the example stores;
- do not use the session stores as-is for distributed production systems;
- use persistent shared storage if your application runs on multiple nodes.

## Related Example

If you need a minimal `composer.json` for a consuming service, see:

- `../consumer-template`