Download the PHP package softan/users-php-sdk without Composer
On this page you can find all versions of the php package softan/users-php-sdk. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Informations about the package users-php-sdk
Softan Users SDK (PHP)
Descripción
SDK oficial para integrar aplicaciones con Softan Users en PHP. Expone métodos estáticos de alto nivel para gestionar usuarios, asociaciones de aplicación y datos comunes (países, tipos de identificación).
Las credenciales de acceso a la API están embebidas en el SDK (sdk_meta.json). No se requiere ninguna configuración manual de API keys.
Requisitos
- PHP 8.1 o superior
- Composer 2
- Extensiones:
ext-curl,ext-json
Instalación
Listo. No se necesita ningún paso adicional — las credenciales están embebidas.
Alternativa: instalación desde GitHub (VCS)
Quickstart
Uso en código
Users
Filtrar usuarios (server-side)
Campos filtrables: user_id, identification_type, user_identification, user_name, user_last_name, user_email, user_phone, country_id, user_status, created_at (range), updated_at (range)
Modos de filtrado:
- Exacto:
'user_status' => 1 - LIKE:
'user_email' => '%@softansol.com' - IN:
'user_status' => [1, 2] - Rango:
'from_created_at' => '2025-01-01', 'to_created_at' => '2025-12-31'
Users Apps (asociaciones usuario-aplicación)
Filtrar asociaciones usuario-aplicación (server-side)
Campos filtrables: user_app_id, user_id, app_identifier, user_app_status, user_email, user_name, user_last_name, user_status, created_at (range), updated_at (range)
Commons
Autenticación
El SDK usa dos modos de autenticación según el tipo de operación:
| Modo | Headers enviados | Uso |
|---|---|---|
| Internal | X-API-KEY + X-App-Id |
Escritura y lectura de recursos (users, usersapps) |
| Public | Solo X-API-KEY |
Lectura de datos comunes (countries, id-types) |
Las credenciales están embebidas en el SDK y se seleccionan automáticamente según el entorno activo.
Entornos
El SDK incluye credenciales para stg y prod. El entorno por defecto es stg.
El entorno activo se resuelve en este orden (mayor a menor prioridad):
| Prioridad | Mecanismo |
|---|---|
| 1 | SDK::$CONFIG['active_environment'] — override programático |
| 2 | sdk_config.json → active_environment — escrito por users-set-env.php |
| 3 | sdk_meta.json → default_environment (valor del paquete: stg) |
Opción A — CLI (recomendado)
Escribe sdk_config.json en la raíz del proyecto. El cambio persiste entre requests y sobrevive composer update.
Opción B — Override programático
Útil cuando el entorno se determina en código (multi-tenant, flags de configuración, etc.). Debe ejecutarse antes de la primera llamada a Services::*.
TLS
La verificación TLS está habilitada por defecto. Para desarrollo puedes desactivarla por llamada:
Compatibilidad
- PHP: 8.1+
- Sistemas: Windows, Linux, macOS
Desarrollo
CI: el workflow en .github/workflows/ci.yml valida Composer e integra PHPUnit en PHP 8.1/8.2/8.3.
Licencia
MIT (ver composer.json).
All versions of users-php-sdk with dependencies
ext-curl Version *
ext-json Version *