PHPackages                             unnikrishnanbhargavakurup/hellocoop - 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 &amp; Authorization](/categories/authentication)
4. /
5. unnikrishnanbhargavakurup/hellocoop

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

unnikrishnanbhargavakurup/hellocoop
===================================

Hellō identity provider(IdP) client in PHP

v1.1.0(8mo ago)2151[2 PRs](https://github.com/hellocoop/php/pulls)MITPHPPHP &gt;=8.3 &lt;8.5CI passing

Since Dec 11Pushed 4mo ago3 watchersCompare

[ Source](https://github.com/hellocoop/php)[ Packagist](https://packagist.org/packages/unnikrishnanbhargavakurup/hellocoop)[ RSS](/packages/unnikrishnanbhargavakurup-hellocoop/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (6)Dependencies (10)Versions (11)Used By (0)

[Hellō](https://www.hello.coop/) Identity Provider (IdP) Client in PHP
======================================================================

[](#hellō-identity-provider-idp-client-in-php)

ReleaseTestsCoverage[![Latest Version](https://camo.githubusercontent.com/60f8044d5f95561c4bd3d8099709062756522b9b904c0c6892a14b2e11b95b43/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f72656c656173652f556e6e696b726973686e616e42686172676176616b757275702f68656c6c6f636f6f702e7376673f7374796c653d666c61742d737175617265)](https://github.com/UnnikrishnanBhargavakurup/hellocoop/releases)[![Test Status](https://github.com/UnnikrishnanBhargavakurup/hellocoop/actions/workflows/continuous-integration.yml/badge.svg)](https://github.com/UnnikrishnanBhargavakurup/hellocoop/actions)[![Coverage](https://camo.githubusercontent.com/26cd97d34ffa7066e99ee0fa923d322ec661e53138418334fc3ab3806a69b16b/68747470733a2f2f636f6465636f762e696f2f67682f556e6e696b726973686e616e42686172676176616b757275702f68656c6c6f636f6f702f67726170682f62616467652e7376673f746f6b656e3d4746505831334c31544d)](https://codecov.io/gh/UnnikrishnanBhargavakurup/hellocoop)Hellō enables your users to register and log in using their choice of popular social logins, email, or phone—without tracking them. Hellō is a cloud identity wallet with a mission to empower users to control their digital identities.

Key Features
------------

[](#key-features)

- **Social Login**: Support for popular providers like Google, Facebook, etc.
- **Email and Phone Authentication**: Verified email or phone login.
- **User Privacy First**: Focused on giving users control without tracking.
- **Quick Integration**: Set up authentication in minutes.

### Developer-Friendly

[](#developer-friendly)

The easiest and quickest way to onboard and authenticate your users with popular social providers, verified email, and phone. Hellō can be integrated into your application in minutes, not hours.

Getting Started
---------------

[](#getting-started)

The following example demonstrates how to integrate the Hellō client into your PHP application.

### Installation

[](#installation)

Install the library using Composer:

```
composer require unnikrishnanbhargavakurup/hellocoop
```

### Usage

[](#usage)

```
use HelloCoop\Config\HelloConfig;
use HelloCoop\HelloClient;

// Step 1: Define all required configurations
define('API_ROUTE', '/api/hellocoop'); // Define the API route
// App ID from https://console.hello.coop/
define('APP_ID', 'app_43tf7X1qHvsCVZIuPQtzQE8J_KQq');
// Add your domain name here (e.g., ngrok domain or deployed domain)
define('HOST', 'b46e-223-205-76-153.ngrok-free.app');
// Create a 32-byte hex secret key using the command: openssl rand -hex 32
define('SECRET', '1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef');

// Step 2: Create an instance of the HelloConfig class
$config = new HelloConfig(
    API_ROUTE,                              // $apiRoute: The base API route
    API_ROUTE . '?op=auth',                 // $authApiRoute: The route for authentication
    API_ROUTE . '?op=login',                // $loginApiRoute: The route for login
    API_ROUTE . '?op=logout',               // $logoutApiRoute: The route for logout
    false,                                  // CSRF protection (false to restrict cross-origin requests)
    APP_ID,                                 // Application ID
    'https://' . HOST . API_ROUTE,          // Full API URL
    HOST,                                   // Hostname
    SECRET                                  // Secret key for encryption and decryption of data
);

// Step 3: Create an instance of HelloClient
$helloClient = new HelloClient($config);

$requestUri = $_SERVER['REQUEST_URI'];
$parsedUrl = parse_url($requestUri); // Extract the path from the request URI, ignoring query parameters
$requestPath = $parsedUrl['path'] ?? '';

// Step 4: Route Hellō API requests
if ($requestPath === API_ROUTE) {
    $helloClient->route(); // Handle the routing of the API request
}
```

Code Quality: Pre-Commit Hook for Linting
-----------------------------------------

[](#code-quality-pre-commit-hook-for-linting)

To maintain code quality, this project uses a **pre-commit hook** for automatic linting before each commit.

### Setup Instructions

[](#setup-instructions)

1. **Copy the pre-commit hook to your Git hooks directory**:

    ```
    cp pre-commit .git/hooks/
    ```
2. **Make the hook executable** (if it’s not already):

    ```
    chmod +x .git/hooks/pre-commit
    ```

This ensures code quality and consistency across the project.

Contributing
------------

[](#contributing)

We welcome contributions! Please open an issue or submit a pull request with your changes. Make sure your contributions adhere to the code style guidelines enforced by the pre-commit hook.

License
-------

[](#license)

This project is licensed under the MIT License. See the [LICENSE](./LICENSE) file for details.

###  Health Score

41

—

FairBetter than 89% of packages

Maintenance68

Regular maintenance activity

Popularity13

Limited adoption so far

Community11

Small or concentrated contributor base

Maturity62

Established project with proven stability

 Bus Factor1

Top contributor holds 78.6% 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 ~43 days

Recently: every ~61 days

Total

7

Last Release

255d ago

Major Versions

v0.0.4 → v1.0.02025-08-24

PHP version history (4 changes)v0.0.1PHP &gt;=7.4 &lt;8.4.1

v0.0.2PHP &gt;=7.4 &lt;=8.4.1

v0.0.4PHP &gt;=8.1 &lt;=8.4.5

v1.0.0PHP &gt;=8.3 &lt;8.5

### Community

Maintainers

![](https://www.gravatar.com/avatar/d2345016e5ad8924a7f7c26cb9cf7c516db47b60f52034c91701e2434312cbc9?d=identicon)[unnikrishnan](/maintainers/unnikrishnan)

---

Top Contributors

[![UnnikrishnanBhargavakurup](https://avatars.githubusercontent.com/u/825646?v=4)](https://github.com/UnnikrishnanBhargavakurup "UnnikrishnanBhargavakurup (99 commits)")[![fraggerfox](https://avatars.githubusercontent.com/u/189939?v=4)](https://github.com/fraggerfox "fraggerfox (16 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (11 commits)")

---

Tags

Authenticationauthorizationsingle sign onidentity providerFederated Identity

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan

Code StylePHP CS Fixer

Type Coverage Yes

### Embed Badge

![Health badge](/badges/unnikrishnanbhargavakurup-hellocoop/health.svg)

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

###  Alternatives

[league/oauth2-client

OAuth 2.0 Client Library

3.8k118.6M1.2k](/packages/league-oauth2-client)[league/oauth1-client

OAuth 1.0 Client Library

99698.8M106](/packages/league-oauth1-client)[adam-paterson/oauth2-stripe

Stripe OAuth 2.0 Client Provider for The PHP League OAuth2-Client

172.4M4](/packages/adam-paterson-oauth2-stripe)[adam-paterson/oauth2-slack

Slack OAuth 2.0 Client Provider for The PHP League OAuth2-Client

22694.8k5](/packages/adam-paterson-oauth2-slack)

PHPackages © 2026

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