PHPackages                             easyblue/easy-yousign - 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. [API Development](/categories/api)
4. /
5. easyblue/easy-yousign

AbandonedArchivedLibrary[API Development](/categories/api)

easyblue/easy-yousign
=====================

1.2.0(4y ago)337.0k↓43.3%3MITPHPPHP ^8.0

Since Oct 22Pushed 2y ago1 watchersCompare

[ Source](https://github.com/easyblueio/easy-yousign)[ Packagist](https://packagist.org/packages/easyblue/easy-yousign)[ RSS](/packages/easyblue-easy-yousign/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (6)Dependencies (8)Versions (7)Used By (0)

[![Easyblue](https://camo.githubusercontent.com/de31c2f5a4b065647db688179ed963b1b4c216e517ee9dc6dc802b5cf4a89294/68747470733a2f2f692e696d6775722e636f6d2f626f36466351372e706e67)](https://camo.githubusercontent.com/de31c2f5a4b065647db688179ed963b1b4c216e517ee9dc6dc802b5cf4a89294/68747470733a2f2f692e696d6775722e636f6d2f626f36466351372e706e67)

easyblue/easy-yousign
=====================

[](#easyblueeasy-yousign)

`easy-yousign` provide an easy way to use [YouSign API](https://dev.yousign.com/). Modern, tested and fully written in php.

Written here at [easyblue.io](https://www.easyblue.io/), a french insurtech company. Check out our website to see how we're using this package in production.

[![Latest Version](https://camo.githubusercontent.com/67d6a4894d3407c4331b083bd3a66c5f0408c8cfc7e7880404d8ae5956246f4b/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f65617379626c75652f656173792d796f757369676e2e7376673f7374796c653d666c61742d737175617265266c6162656c3d72656c65617365)](https://packagist.org/packages/easyblue/easy-yousign)[![Software License](https://camo.githubusercontent.com/80f3f4d09ebb950302e58fd3644a31e87275acefe093747cf8ddfa187ca23ef5/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f65617379626c75652f656173792d796f757369676e2e7376673f7374796c653d666c61742d737175617265)](https://github.com/easyblueio/easy-yousign/blob/master/LICENSE)[![PHP Version](https://camo.githubusercontent.com/190195d7821790b7ffe3c7b2a8d72c6517ce0cdac824200af03f325dab96f25e/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f7068702d762f65617379626c75652f656173792d796f757369676e2e7376673f7374796c653d666c61742d737175617265)](https://php.net)[![Coverage Status](https://camo.githubusercontent.com/e31b8ed615c70f87aef5dfb9e08c513eae35f12a158edf25002dcbe07fd85f43/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f436f7665726167652d2532352d79656c6c6f772e737667)](https://camo.githubusercontent.com/e31b8ed615c70f87aef5dfb9e08c513eae35f12a158edf25002dcbe07fd85f43/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f436f7665726167652d2532352d79656c6c6f772e737667)[![Total Downloads](https://camo.githubusercontent.com/5d631528b3a860775a6eb345b0d074c9069bbf80b96f79fc3937c75712084848/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f65617379626c75652f656173792d796f757369676e2e7376673f7374796c653d666c61742d73717561726526636f6c6f72423d6d656469756d76696f6c6574726564)](https://packagist.org/packages/easyblue/easy-yousign)[![github issues](https://camo.githubusercontent.com/d2dfe89cffaebaf824edda78eb4116528eb08b3d1ccfcb4e1564c57602c8ebba/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6973737565732f65617379626c7565696f2f656173792d63616368652d72656163742e7376673f7374796c653d666c61742d737175617265)](https://github.com/easyblueio/easy-yousign/issues)[![github closed issues](https://camo.githubusercontent.com/0f208139060d433a8ef0f83fd8bf7ea3b6d0d2f8b0509bfaed173645f577a83f/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6973737565732d636c6f7365642f65617379626c7565696f2f656173792d63616368652d72656163742e7376673f7374796c653d666c61742d73717561726526636f6c6f72423d343463633131)](https://github.com/easyblueio/easy-yousign/issues?q=is%3Aissue+is%3Aclosed)

Installation
------------

[](#installation)

Install this package as a dependency using [Composer](https://getcomposer.org).

```
composer require easyblue/easy-yousign
```

Usage
-----

[](#usage)

`Procedure` and `File` are supporting for basic mode but you can do a pull request to improve this library.

[Supported features](docs/features.md)

### Create procedure

[](#create-procedure)

```
use Easyblue\YouSign\Factory\Factory;
use Easyblue\YouSign\Model\File;
use Easyblue\YouSign\Model\FileObject;
use Easyblue\YouSign\Model\Member;
use Easyblue\YouSign\Model\Procedure;
use Easyblue\YouSign\Http\Client;

$ysApiKey = 'test';
$factory = new Factory($ysApiKey, Client::ENV_STAGING);

$member = (new Member())
    ->setFirstname('John')
    ->setLastname('Doe')
    ->setEmail('j.doe@domain.com')
    ->setPhone('+33611111111');

$file = (new File())
    ->setName('my_file.pdf')
    ->setContent('base64 content');
$file = $factory->file()->create();

$fileObject = (new FileObject())
    ->setFile($file)
    ->setPage(1)
    ->setPosition('230,499,464,589');
$member->addFileObject($fileObject);

$procedure = (new Procedure())->setName('My first procedure')
    ->setDescription('Awesome! Here is the description of my first procedure')
    ->addMember($member);
$procedure = $factory->procedure()->create($procedure);
```

### Get procedure

[](#get-procedure)

```
use Easyblue\YouSign\Factory\Factory;
use Easyblue\YouSign\Model\Procedure;
use Easyblue\YouSign\Http\Client;

$ysApiKey = 'test';
$factory = new Factory($ysApiKey, Client::ENV_STAGING);

/** Procedure $procedure **/
$procedure = $factory->procedure()->get('/procedures/9d1ede2b-5687-4440-bdc8-dd0bc64f668c');
```

### Download file

[](#download-file)

```
use Easyblue\YouSign\Factory\Factory;
use Easyblue\YouSign\Model\File;
use Easyblue\YouSign\Http\Client;

$ysApiKey = 'test';
$factory = new Factory($ysApiKey/*, Client::ENV_STAGING*/);

// Pdf content as binary file
$content = $factory->file()->download('/files/9d1ede2b-5687-4440-bdc8-dd0bc64f668c');

// Pdf content as base64
$content = $factory->file()->download('/files/9d1ede2b-5687-4440-bdc8-dd0bc64f668c', false);
```

Framework
---------

[](#framework)

[Symfony](docs/symfony.md)

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

[](#contributing)

Contributions are welcome! Before contributing to this project, familiarize yourself with [CONTRIBUTING.md](CONTRIBUTING.md).

To develop this project, you will need [PHP](https://www.php.net) 7.4 or greater, [Composer](https://getcomposer.org) and make.

After cloning this repository locally, execute the following commands:

```
cd /path/to/repository
composer install
```

Now, you are ready to develop!

#### Coding Standards

[](#coding-standards)

This project follows a superset of [PSR-12](https://www.php-fig.org/psr/psr-12/)coding standards, enforced by [PHP-CS-Fixer](https://github.com/FriendsOfPHP/PHP-CS-Fixer). The project PHP\_CodeSniffer configuration may be found in `.php_cs`.

You may lint the entire codebase using PHP-CS-Fixer with the following commands:

```
make php-cs-fixer
```

#### Static Analysis

[](#static-analysis)

This project uses a combination of [PHPStan](https://github.com/phpstan/phpstan), [phpmd](https://github.com/phpmd/phpmd), [phpcpd](https://github.com/sebastianbergmann/phpcpd) to provide static analysis of PHP code. Configurations for these are in `phpstan.neon.dist`, `.phpmd.xml`. respectively.

You may run static analysis manually across the whole codebase with the following command:

```
# Static analysis
make phpspan
make phpmd
make phpcpd
```

#### Pre-commit

[](#pre-commit)

This project use [composer-git-hooks](https://github.com/BrainMaestro/composer-git-hooks). It will attempt to fix any errors it can, and it will reject the commit if there are any un-fixable issues. Many issues can be fixed automatically and will be done so pre-commit.

#### Register pre-commit at first usage

[](#register-pre-commit-at-first-usage)

```
vendor/bin/cghooks add
```

### Project Structure

[](#project-structure)

This project uses [pds/skeleton](https://github.com/php-pds/skeleton) as its base folder structure and layout.

NameDescription**bin/**Commands and scripts for this project**build/**Cache, logs, reports, etc. for project builds**docs/**Project-specific documentation**resources/**Additional resources for this project**src/**Project library and application source code**tests/**Tests for this projectCopyright and License
---------------------

[](#copyright-and-license)

The easyblue/easy-yousign library is copyright © easyblue and licensed for use under the terms of the MIT License (MIT). Please see [LICENSE](LICENSE) for more information.

###  Health Score

35

—

LowBetter than 80% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity31

Limited adoption so far

Community12

Small or concentrated contributor base

Maturity63

Established project with proven stability

 Bus Factor2

2 contributors hold 50%+ of commits

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 ~100 days

Recently: every ~125 days

Total

6

Last Release

1532d ago

PHP version history (3 changes)1.0.0-alpha.1PHP ^7.4

1.1.0PHP ^7.4|^8.0

1.2.0PHP ^8.0

### Community

Maintainers

![](https://www.gravatar.com/avatar/027b1ee15fc8bdf2e06fbd9753b647e4e398212e6949c80c25e943759076dae6?d=identicon)[easyblue](/maintainers/easyblue)

---

Top Contributors

[![mathsunn](https://avatars.githubusercontent.com/u/2671074?v=4)](https://github.com/mathsunn "mathsunn (11 commits)")[![bricejulia](https://avatars.githubusercontent.com/u/7558030?v=4)](https://github.com/bricejulia "bricejulia (7 commits)")[![CedricDALAT](https://avatars.githubusercontent.com/u/27773727?v=4)](https://github.com/CedricDALAT "CedricDALAT (5 commits)")

---

Tags

php-libraryyousign

###  Code Quality

TestsPHPUnit

Static AnalysisRector

### Embed Badge

![Health badge](/badges/easyblue-easy-yousign/health.svg)

```
[![Health](https://phpackages.com/badges/easyblue-easy-yousign/health.svg)](https://phpackages.com/packages/easyblue-easy-yousign)
```

###  Alternatives

[sylius/sylius

E-Commerce platform for PHP, based on Symfony framework.

8.4k5.6M651](/packages/sylius-sylius)[craftcms/cms

Craft CMS

3.6k3.6M2.6k](/packages/craftcms-cms)[api-platform/symfony

Symfony API Platform integration

323.2M67](/packages/api-platform-symfony)[api-platform/serializer

API Platform core Serializer

223.4M31](/packages/api-platform-serializer)[fschmtt/keycloak-rest-api-client-php

PHP client to interact with Keycloak's Admin REST API.

4684.7k2](/packages/fschmtt-keycloak-rest-api-client-php)[concrete5/core

Concrete core subtree split

19159.3k48](/packages/concrete5-core)

PHPackages © 2026

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