# XamiLib PHP — Instalación

**XamiLib para PHP** es la librería que permite a tu aplicación PHP firmar a través del
servicio local del xamiSDK. Tu aplicación habla con el servicio local (nunca con Xami
directamente); el documento no sale de tu red.

## Requisitos

- PHP 8.0 o superior.
- El servidor xamiSDK instalado, pareado y corriendo (`xamisdk serve`).
- Una credencial de aplicación (`xamisdk wrapper:create --name mi-app`), que te da un
  `wrapper_key` y un `wrapper_secret`.

## Instalación

Descarga XamiLib para PHP desde https://sdk.xami.run y descomprímela en tu proyecto.
Incluye el `autoload.php`:

```php
require 'ruta/al/xamilib-php/autoload.php';
```

Si usas Composer, puedes registrarla con PSR-4 (`Xami\SDK\` → `src/`).

## Primer uso

```php
use Xami\SDK\XamiSDK;

$xami = new XamiSDK([
    'endpoint'       => 'http://127.0.0.1:8300',
    'wrapper_key'    => 'wrp_...',
    'wrapper_secret' => 'wsec_...',
]);

echo $xami->health()->self()['paired'] ? "pareado" : "sin parear";
```
