Looking to hire Laravel developers? Try LaraJobs

laravel-quebec maintained by jeffersongoncalves

Description
Quebec Law 25 (private sector privacy act) for Laravel: a personal information inventory with sensitive information, communications outside Quebec and profiling flagged, export and anonymization
Last update
2026/11/18 02:45 (dev-main)
License
Downloads
209

Comments
comments powered by Disqus

Laravel Quebec

Laravel Quebec

Latest Version on Packagist Tests Total Downloads

Core of a Laravel toolkit for Quebec's Act respecting the protection of personal information in the private sector (CQLR c. P-39.1), as amended by Law 25 (Bill 64). You declare which columns of your Eloquent models hold personal information. With those declarations the package can:

  • build the personal information inventory: what you hold, for which purpose, which information is sensitive (s. 12), which is communicated outside Quebec (a privacy impact assessment first, s. 17) and which is collected with technology that identifies, locates or profiles the person (s. 8.1);
  • export a person's information, also in a structured, commonly used technological format (access and portability, s. 27);
  • destroy or anonymize a record once its purposes are achieved, choosing a strategy per column (s. 23).

Quebec's law is the strictest in Canada; following it covers most of what the federal PIPEDA asks of businesses in the other provinces.

This package gives you tooling. It does not make you compliant on its own. Note that the Act distinguishes de-identified information (s. 12) from anonymized information (s. 23, irreversible, under the regulation's criteria): hashing and masking de-identify; only nullifying everything that identifies the person anonymizes.

Installation

composer require jeffersongoncalves/laravel-quebec
php artisan vendor:publish --tag="quebec-config"

Declaring personal information

use JeffersonGoncalves\Quebec\Attributes\PersonalData;
use JeffersonGoncalves\Quebec\Concerns\InteractsWithPersonalData;
use JeffersonGoncalves\Quebec\Contracts\HasPersonalData;
use JeffersonGoncalves\Quebec\Enums\{AnonymizeStrategy, DataCategory};

#[PersonalData('name', purpose: 'Account identification', anonymize: AnonymizeStrategy::Mask)]
#[PersonalData('email', retention: '5 years', anonymize: AnonymizeStrategy::Hash, outsideQuebec: true)]
#[PersonalData('health_notes', category: DataCategory::Sensitive)]
#[PersonalData('location', profiling: true)]
class User extends Authenticatable implements HasPersonalData
{
    use InteractsWithPersonalData;
}
  • category: DataCategory::Sensitive: information that, due to its medical, biometric or otherwise intimate nature, or the context of its use, entails a high level of reasonable expectation of privacy. Using it for another purpose needs express consent.
  • outsideQuebec: communicated outside Quebec (a cloud provider elsewhere, for example). The Act requires a privacy impact assessment first and a written agreement.
  • profiling: collected with technology that identifies, locates or profiles the person. You must tell them, and how to activate those functions (they are off by default).

Register the model in config/quebec.php:

'models' => [
    App\Models\User::class,
],

Strategies

Strategy Result
Nullify (default) null
Hash HMAC-SHA256 keyed by QUEBEC_HASH_KEY (falls back to APP_KEY): a stable pseudonym (de-identified, not anonymized)
Mask Marie Tremblay → M*************
Keep untouched, for information you must keep under another law

Encrypted casts ('encrypted') work as expected: the value is decrypted, then transformed, then encrypted again.

Usage

use JeffersonGoncalves\Quebec\Facades\Quebec;

Quebec::inventory();               // one row per declared column, with outside_quebec and profiling
$user->exportPersonalData();       // ['name' => ..., 'email' => ..., ...]
$user->anonymizePersonalData();    // applies each strategy and saves

anonymizePersonalData() fires JeffersonGoncalves\Quebec\Events\PersonalDataAnonymized with the model and the columns it changed.

php artisan quebec:inventory          # table
php artisan quebec:inventory --json   # machine readable

k-anonymity

Before you publish or share a dataset as anonymized, check that nobody can be singled out by combining quasi-identifiers such as postal code, birth date and gender. A dataset is k-anonymous when every combination of those values is shared by at least k rows; l-diverse when each group also holds at least l distinct sensitive values.

use JeffersonGoncalves\Quebec\Generalize;

Quebec::kAnonymity(Patient::class, [
    'postal_code' => Generalize::prefix(3),  // H2X 1Y4 → H2X
    'birth_date' => Generalize::date('Y'),
    'gender',
], k: 5, sensitive: 'diagnosis');
php artisan quebec:k-anonymity "App\Models\Patient" postal_code birth_date --k=5 --sensitive=diagnosis

The command fails (exit code 1) when the data is below the target k.

Testing

composer test

Changelog

See CHANGELOG.

License

The MIT License (MIT). See License File.