HaveIBeenPwned PHP client

, _(*1)

Install

``` json { "require": { "xsist10/haveibeenpwned": "~1.0" } }, _(*2)


## Usage

### Create manager instance
``` php
use xsist10\HaveIBeenPwned\HaveIBeenPwned;
use xsist10\HaveIBeenPwned\Adapter\Curl;
use xsist10\HaveIBeenPwned\Adapter\FileGetContents;

// By default the $manager will use a Curl adapter
$manager = new HaveIBeenPwned();

// You can create a new manager with a specified adapter
$manager = new HaveIBeenPwned(new Curl());

// You can also set the adapter after creation
$manager->setAdapter(new FileGetContents());

Check if you've been pwned

``` php $manager->checkAccount("your_email_address");, _(*3)


### Check if your account has been leaked in a paste
``` php
$manager->getPasteAccount("your_email_address");

Check if your password has been leaked before

``` php // Your password is not sent to the remote API. Only a partial of the SHA1 // value is sent and all matching full SHA1 results are returned and compared. $numberOfTimesCompromised = $manager->isPasswordCompromised("your_password");, _(*4)


### List all breaches that have are on record
``` php
$manager->getBreaches();

$manager->getBreach('specific_breach_by_name');

List the types of data that are covered when describing a leak

``` php $manager->getDataClasses();, _(*5)


## Logger Support

The adapters support [PSR-3 Logger](http://www.php-fig.org/psr/psr-3/). I recommend using [monolog](https://github.com/Seldaek/monolog).

### Install Monolog
```bash
$ composer require monolog/monolog

Use Monolog with HaveIBeenPwned

use xsist10\HaveIBeenPwned\HaveIBeenPwned;
use xsist10\HaveIBeenPwned\Adapter\Curl;

use Monolog\Logger;
use Monolog\Handler\StreamHandler;

$log = new Logger('name');
// Push all logging up to the level of DEBUG to our log file
$log->pushHandler(new StreamHandler('[full log filename]', Logger::DEBUG));

$adapter = new Curl();
$adapter->setLogger($log);
$manager = new HaveIBeenPwned($adapter);

// Calls made to HaveIBeenPwned will be logged to your log file now