PHPackages                             railroad/usora - 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. [Authentication & Authorization](/categories/authentication)
4. /
5. railroad/usora

ActiveLibrary[Authentication & Authorization](/categories/authentication)

railroad/usora
==============

User management system.

v4.0.1(1y ago)079.1k3MITPHPPHP ^8.2

Since Apr 10Pushed 1y ago1 watchersCompare

[ Source](https://github.com/railroadmedia/usora)[ Packagist](https://packagist.org/packages/railroad/usora)[ RSS](/packages/railroad-usora/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependencies (16)Versions (162)Used By (3)

Usora
=====

[](#usora)

Usora is a user management system including auth, user settings, user information, and single sign on.

- [Usora](#usora)
    - [Single Sign On](#single-sign-on)
        - [How it Works](#how-it-works)
    - [API Reference](#api-reference)
        - [Get Index of Users](#get-index-of-users)
            - [Request Example(s)](#request-example-s-)
            - [Request Parameters](#request-parameters)
            - [Response Example(s)](#response-example-s-)
                - [`200 OK`](#-200-ok-)
        - [Get Single User by ID](#get-single-user-by-id)
            - [Request Example(s)](#request-example-s--1)
            - [Request Parameters](#request-parameters-1)
            - [Response Example(s)](#response-example-s--1)
                - [`200 OK`](#-200-ok--1)
        - [Update User's Display Name](#update-user-s-display-name)
            - [Request Example(s)](#request-example-s--2)
            - [Request Parameters](#request-parameters-2)
            - [Response Example(s)](#response-example-s--2)
                - [`200 OK`](#-200-ok--2)
        - [(todo: the rest of the endpoints)](#-todo--the-rest-of-the-endpoints-)
    - [Events](#events)
        - [`EmailChangeRequest`](#-emailchangerequest-)
        - [`UserEvent`](#-userevent-)

Single Sign On
--------------

[](#single-sign-on)

### How it Works

[](#how-it-works)

Users can be signed in on any domain running this package with a single login attempt from any of the domains as long as they are all connected to the same usora database. This is possible by setting authentication cookies on all participating domains after the login succeeds using html img tags.

API Reference
-------------

[](#api-reference)

### Get Index of Users

[](#get-index-of-users)

`GET user/index`

#### Request Example(s)

[](#request-examples)

```
$.ajax({
    url: 'https://www.musora.com' +
        '/usora/user/index?' +
        'limit=10' + '&' +
        'page=1' + '&' +
        'order_by_column=email' + '&' +
        'order_by_direction=asc',
    type: 'get',
    dataType: 'json',
    success: function(response) {
        // handle success
    },
    error: function(response) {
        // handle error
    }
});
```

#### Request Parameters

[](#request-parameters)

path|query|bodykeyrequireddefaultdescription|notesquery`limit``25`query`page``1`query`order_by_column``'created_at'`query`order_by_direction``'desc'`#### Response Example(s)

[](#response-examples)

##### `200 OK`

[](#200-ok)

```
{
   "status":"ok",
   "code":201,
   "results":{
      "id":217988,
      "content_id":202313,
      "key":"difficulty",
      "value":"1",
      "type":"integer",
      "position":1
   }
}
```

---

### Get Single User by ID

[](#get-single-user-by-id)

`GET user/show/{id}`

#### Request Example(s)

[](#request-examples-1)

```
var userId = 1;

$.ajax({
    url: 'https://www.musora.com' +
        '/usora/user/show/' . userId,
    type: 'get',
    dataType: 'json',
    success: function(response) {
        // handle success
    },
    error: function(response) {
        // handle error
    }
});
```

#### Request Parameters

[](#request-parameters-1)

path|query|bodykeyrequireddefaultdescription|notespathyesId of the user to be returned#### Response Example(s)

[](#response-examples-1)

##### `200 OK`

[](#200-ok-1)

```
{
   "id":"1",
   "email":"pascale84@schimmel.com",
   "password":"$2y$10$hh5cU.fo.Jq48A267zkjiun\\/W.TwbRs4Pg02Nm.X7k.s5yKQxVMj2",
   "remember_token":"D5mpp6aZhvi5vOD7Fs4EDMw8782Be3hXcrRa7cUEaqt6eXlmQPmKbaU1RKdy",
   "session_salt":"0bPpeEbf13tpNi5zkN6bHSQ5Oq72s7YVrCkh2rkRA65Jttd16d0RGQNJbc1R",
   "display_name":"sed accusamus dolorem ut",
   "created_at":"1526460917",
   "updated_at":"1526460917",
   "fields":[]
}
```

### Update User's Display Name

[](#update-users-display-name)

`PUT user/update/{id}`

#### Request Example(s)

[](#request-examples-2)

```
var userId = 1;
var displayNameToSet = 'sed accusamus dolorem ut';

$.ajax({
    url: 'https://www.musora.com' +
        '/usora/user/update/' . userId,
    type: 'patch',
    data: {display_name: displayNameToSet},
    dataType: 'json',
    success: function(response) {
        // handle success
    },
    error: function(response) {
        // handle error
    }
});
```

#### Request Parameters

[](#request-parameters-2)

path|query|bodykeyrequireddefaultdescription|notespathyesuser idbody`display_name`yesnew display name to set#### Response Example(s)

[](#response-examples-2)

##### `200 OK`

[](#200-ok-2)

```
{
   "id":"1",
   "email":"pascale84@schimmel.com",
   "password":"$2y$10$hh5cU.fo.Jq48A267zkjiun\\/W.TwbRs4Pg02Nm.X7k.s5yKQxVMj2",
   "remember_token":"D5mpp6aZhvi5vOD7Fs4EDMw8782Be3hXcrRa7cUEaqt6eXlmQPmKbaU1RKdy",
   "session_salt":"0bPpeEbf13tpNi5zkN6bHSQ5Oq72s7YVrCkh2rkRA65Jttd16d0RGQNJbc1R",
   "display_name":"sed accusamus dolorem ut",
   "created_at":"1526460917",
   "updated_at":"1526460917",
   "fields":[

   ]
}
```

---

### (todo: the rest of the endpoints)

[](#todo-the-rest-of-the-endpoints)

Get details from "USORA USER MANAGEMENT SYSTEM - JSON API" section of

- put, user/store
- patch, user/update/:id
- delete, user/delete/:id
- get, user-field/index/:id
- get, user-field/show/:id
- put, user-field/store
- patch, user-field/update/:id
- patch, user-field/update-or-create-by-key
- delete, user-field/delete/:id
- patch, user-field/update-or-create-multiple-by-key

Events
------

[](#events)

NameParametersListener existsResultant action(s)UserEventid, eventTypenon/aEmailChangeRequesttoken, emailnon/a### `EmailChangeRequest`

[](#emailchangerequest)

Captures that an EmailChangeRequest was made.

Trigger exists in `request` method of `EmailChangeController`

No Listener exists.

### `UserEvent`

[](#userevent)

Capture any user-account change.

Trigger exists in:...

1. Both `UserQuery`\* methods
    1. `insertGetId` (eventType param value: "created")
    2. `update` (eventType param value: "updated")
2. All three `UserFieldQuery`\* methods (eventType param value: "field-updated" in each)
    1. `insertGetId`
    2. `update`
    3. `delete`

\*namespace for each is `Railroad\Usora\Repositories\Queries`

No listener exists.

---

The End.

###  Health Score

47

—

FairBetter than 94% of packages

Maintenance34

Infrequent updates — may be unmaintained

Popularity26

Limited adoption so far

Community16

Small or concentrated contributor base

Maturity94

Battle-tested with a long release history

 Bus Factor1

Top contributor holds 76.7% 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 ~15 days

Recently: every ~36 days

Total

150

Last Release

620d ago

Major Versions

v0.1.2 → v2.0.02018-12-17

v0.0.44 → v2.1.02019-01-10

v2.0.83 → v3.0.02022-05-17

v2.0.84 → v3.0.12022-06-03

v3.0.x-dev → v4.0.02024-08-19

PHP version history (4 changes)v0.0.01PHP ^7.1.3

v2.0.0PHP ^7.1

v3.0.0PHP ^8.1

v4.0.0PHP ^8.2

### Community

Maintainers

![](https://www.gravatar.com/avatar/205e2d39157a11094e112cd3b2433bdc3449a3c30d67769f322b33169c3b8c70?d=identicon)[calebfavor](/maintainers/calebfavor)

---

Top Contributors

[![calebfavor](https://avatars.githubusercontent.com/u/5841780?v=4)](https://github.com/calebfavor "calebfavor (79 commits)")[![roxanariza](https://avatars.githubusercontent.com/u/11618485?v=4)](https://github.com/roxanariza "roxanariza (10 commits)")[![ac-bogdan](https://avatars.githubusercontent.com/u/93509975?v=4)](https://github.com/ac-bogdan "ac-bogdan (9 commits)")[![JonathanTM](https://avatars.githubusercontent.com/u/5752974?v=4)](https://github.com/JonathanTM "JonathanTM (5 commits)")

---

Tags

managementUsersmusora

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/railroad-usora/health.svg)

```
[![Health](https://phpackages.com/badges/railroad-usora/health.svg)](https://phpackages.com/packages/railroad-usora)
```

###  Alternatives

[grumpydictator/firefly-iii

Firefly III: a personal finances manager.

22.8k69.3k](/packages/grumpydictator-firefly-iii)[sulu/sulu

Core framework that implements the functionality of the Sulu content management system

1.3k1.3M152](/packages/sulu-sulu)[firefly-iii/data-importer

Firefly III Data Import Tool.

7545.8k](/packages/firefly-iii-data-importer)[open-dxp/opendxp

Content & Product Management Framework (CMS/PIM)

7310.3k29](/packages/open-dxp-opendxp)[aedart/athenaeum

Athenaeum is a mono repository; a collection of various PHP packages

245.2k](/packages/aedart-athenaeum)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)