Download the PHP package muffin/obfuscate without Composer
On this page you can find all versions of the php package muffin/obfuscate. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Informations about the package obfuscate
Obfuscate
Primary key obfuscation for CakePHP using HashIds, Optimus, Base62 and/or custom obfuscation strategies.
Installation
Install the plugin using Composer:
Load the plugin by either running this console command:
or by manually adding the following line to src/Application.php
:
Lastly, install the required obfuscation library depending on the strategy class you want to use and stated below.
Built-in obfuscation strategies
Use the HashIdStrategy if you want to:
- obfuscate your primary keys with short, unique, non-sequential ids
- present record ids like 347 as strings like “yr8”
Use the OptimusStrategy if you want to:
- obfuscate your primary keys with integers based on Knuth's integer hash
- present record ids like 347 as integers like 372555994
Use the Base62Strategy if you want to:
- obfuscate your primary keys with base62 strings and integers
- present record ids like 347 as strings like "vk"
You can also create your own strategy classes by implementing the StrategyInterface
.
Usage
1. Attaching the behavior
Prepare for obfuscation by attaching the Obfuscate behavior to your table(s) and specifying which strategy you want to use as shown in the following examples.
Please note that attaching the behavior is totally unobtrusive and will do absolutely nothing until you use one of the custom finders.
2. Using the custom finders
This plugin comes with the following two custom finders that are responsible for the actual obfuscation (cloaking) and elucidation (uncloaking) process:
findObfuscated
: used to find records using an obfuscated (cloaked) primary keyfindObfuscate
: used to obfuscate (cloak) all primary keys in a find result set
findObfuscated
Use this finder if you want to look up a record using an obfuscated id. The plugin will elucidate (uncloak) the obfuscated id and will execute the find using the "normal" primary key as it is used inside your database.
CakePHP example:
Crud plugin example:
findObfuscate
Use this finder if you want the plugin to obfuscate all "normal" primary keys found in a find result set.
CakePHP example:
Crud plugin example:
Methods
Attaching the behavior also makes the following two methods available on the table:
obfuscate(string $str)
elucidate(string $str)
Pro tips
Authentication
A fairly common use case is applying obfuscation to user ids. To ensure the
Authentication plugin properly handles obfuscated ids, specify the obfuscated
finder
using the finder
key in your identifier's resolver config.
Patches & Features
- Fork
- Mod, fix
- Test - this is important, so it's not unintentionally broken
- Commit - do not mess with license, todo, version, etc. (if you do change any, bump them into commits of their own that I can ignore when I pull)
- Pull request - bonus point for topic branches
To ensure your PRs are considered for upstream, you MUST follow the CakePHP coding standards.
Bugs & Feedback
http://github.com/usemuffin/obfuscate/issues
License
Copyright (c) 2015-Present, Use Muffin and licensed under The MIT License.