freearhey/laravel-face-detection

A Laravel Package for Face Detection and Cropping in Images.

v1.4.0 2023-12-07 19:37 UTC

This package is auto-updated.

Last update: 2024-11-07 21:31:31 UTC


README

A Laravel Package for Face Detection.

Installation

  1. Install the package via composer:
composer require freearhey/laravel-face-detection
  1. Add the service provider to the config/app.php file in Laravel:
'providers' => [
  ...
  Arhey\FaceDetection\FaceDetectionServiceProvider::class,
  ...
],
  1. Publish the config file by running:
php artisan vendor:publish

Usage

use Arhey\FaceDetection\Facades\FaceDetection;

$face = FaceDetection::extract('path/to/image.jpg');

To detect if face is found in a image:

if($face->found) {
  // face found
} else {
  // face not found
}

To get the facial boundaries:

var_dump($face->bounds);

/*
  array(
    'x' => 292.0,
    'y' => 167.0,
    'w' => 204.8,
    'h' => 204.8,
  )
*/

To save the found face image:

$face->save('path/to/output.jpg');

Testing

vendor/bin/phpunit

License

MIT