PHPackages                             crucifyer/facedetector-php - 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. [Image & Media](/categories/media)
4. /
5. crucifyer/facedetector-php

ActiveLibrary[Image & Media](/categories/media)

crucifyer/facedetector-php
==========================

Detect the position of a human face using GD.

5201PHP

Since Jul 31Pushed 3y ago1 watchersCompare

[ Source](https://github.com/crucifyer/facedetector-php)[ Packagist](https://packagist.org/packages/crucifyer/facedetector-php)[ RSS](/packages/crucifyer-facedetector-php/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependenciesVersions (1)Used By (0)

Face Detector PHP
=================

[](#face-detector-php)

GD 를 이용해 이미지의 얼굴 위치를 식별합니다.

- [mauricesvay/php-facedetection](https://github.com/mauricesvay/php-facedetection) 프로젝트를 기반으로 만들었습니다.
- [js 로 포팅](https://github.com/crucifyer/facedetector-js)하며 개선한 사항들을 적용하여 error\_reporting = E\_ALL safe 하게 php 코드를 새로 작성했습니다.
- 라이센스가 GPL-2.0 인 이유는 [원본의 라이센스](https://github.com/mauricesvay/php-facedetection/issues/18)를 유지해야하기 때문입니다.
- 이미지 크기에 따라 인식률에 큰 차이가 생깁니다. 알고리즘의 원리를 이해하지 못해서 크기 외의 인식률 개선 작업을 하지 못했습니다. 테스트에 사용된 이미지들은 대부분 281px 일 때의 결과가 가장 좋기 때문에 기본값이 281 입니다.
- 자원소모가 심한편이기 때문에 썸네일 정렬 용도로 사용하려면, 실시간 적용 보다는 업로드시 검출하여 direction 값을 함께 저장하는것이 좋습니다.

```
$ php composer.phar require "crucifyer/facedetector-php" "dev-main"
```

```
$detector = new \Xeno\Image\FaceDetector(imagefile or gdresource or imagebinary);
$face = $detector->FaceDetect();
['x' => int, 'y' => int, 'w' => int]

$faces = $detector->FaceDetect(true);
[
	['x' => int, 'y' => int, 'w' => int],
	['x' => int, 'y' => int, 'w' => int],
	['x' => int, 'y' => int, 'w' => int],
	['x' => int, 'y' => int, 'w' => int],
	['x' => int, 'y' => int, 'w' => int],
]

FaceDetector::FaceDetect([multiplue bool], [resSize int])
```

- gif, jpeg, png, webp 이미지 파일, gd 리소스, 이미지 바이너리가 가능합니다.

#### multiple

[](#multiple)

- multiple 값을 true 로 주면 얼굴위치를 최대 10개까지 더 찾아서 배열로 반환합니다.
- true 대신 숫자를 입력할 수 있고, 2~50으로 제한됩니다.
- 여러 얼굴 인식률이 특히 안좋아서 이미지 크기를 바꿔도 모든 얼굴을 인식하지 못할 확률이 높습니다.

#### resSize

[](#ressize)

- 원본 이미지를 그대로 사용하지 않고 이미지 크기를 줄여서 사용합니다. 가로,세로 중 작은쪽 기준으로 줄이며, 기본값은 281 입니다.

```
$face = $detector->FaceDetect();
$size = $detector->getImageSize();
$direction = \Xeno\Image\FaceDetector::AlignDirection($size['width'], $size['height'], $face['x'], $face['y'], $face['w']);
```

- 얼굴쪽으로 정렬을 하기 위한 방향을 반환합니다.
- 가로가 길면 left, center, right, 세로가 길면 top, middle, bottom 중 얼굴이 감지된 위치를 반환합니다.
- 약 30% 이상 치우쳤는지로 판단합니다.

```
$faces = \Xeno\Image\FaceDetector::FilterSmallFaces($faces);
```

- 가장 큰 것 대비 60% 이상 작은것을 걸러냅니다.

```
$detector = new \Xeno\Image\FaceDetector(imagefile or gdresource or imagebinary);
$direction = $detector->getDirection();
```

- 방향 인식까지의 과정을 자동화 합니다. 여러 얼굴을 인식하면 중앙정렬 합니다.

```
$detector = new \Xeno\Image\FaceDetector(imagefile or gdresource or imagebinary);
[gd resource or boolean] = $detector->cropThumbnail(size, [direction], [file], [type]);
```

- 크롭된 썸네일을 반환합니다. size 보다 원본이 작아도 키워서 맞추지 않고, 비율대로 자르기만 합니다.

#### direction

[](#direction)

- 생략하면 getDirection 을 해서 채웁니다.

#### file

[](#file)

- 생략하면 gd resource 를 반환합니다.

#### type

[](#type)

- gif, jpg, png, png8, webp 를 지원하고 생략하면 file 의 확장자로 판별합니다.
- png8 은 gif 와 같은 방식인 indexed colors 라서 용량이 작고 화질이 안좋습니다.

### 전반적인 예제가 tests/example.php 에 들어있습니다. autoload.php 위치를 수정하고 콘솔에서 테스트하세요.

[](#전반적인-예제가-testsexamplephp-에-들어있습니다-autoloadphp-위치를-수정하고-콘솔에서-테스트하세요)

### js project:

[](#js-project-httpsgithubcomcrucifyerfacedetector-js)

###  Health Score

18

—

LowBetter than 8% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity13

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity25

Early-stage or recently created project

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

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.

### Community

Maintainers

![](https://www.gravatar.com/avatar/63a41dd6bd6505e111344d4fa8ff1b62cdd0da2be3433adbdc4d7bcda1e63a82?d=identicon)[xenoside](/maintainers/xenoside)

---

Top Contributors

[![crucifyer](https://avatars.githubusercontent.com/u/1300668?v=4)](https://github.com/crucifyer "crucifyer (10 commits)")

---

Tags

face-detectionphpphp-library

### Embed Badge

![Health badge](/badges/crucifyer-facedetector-php/health.svg)

```
[![Health](https://phpackages.com/badges/crucifyer-facedetector-php/health.svg)](https://phpackages.com/packages/crucifyer-facedetector-php)
```

###  Alternatives

[milon/barcode

Barcode generator like Qr Code, PDF417, C39, C39+, C39E, C39E+, C93, S25, S25+, I25, I25+, C128, C128A, C128B, C128C, 2-Digits UPC-Based Extention, 5-Digits UPC-Based Extention, EAN 8, EAN 13, UPC-A, UPC-E, MSI (Variation of Plessey code)

1.5k13.3M39](/packages/milon-barcode)[bkwld/croppa

Image thumbnail creation through specially formatted URLs for Laravel

510496.0k23](/packages/bkwld-croppa)[goat1000/svggraph

Generates SVG graphs

132849.6k3](/packages/goat1000-svggraph)[cohensive/embed

Media Embed (for Laravel or as a standalone).

120370.4k](/packages/cohensive-embed)[netresearch/rte-ckeditor-image

Image support in CKEditor for the TYPO3 ecosystem - by Netresearch

63991.3k4](/packages/netresearch-rte-ckeditor-image)[humanmade/tachyon-plugin

Rewrites WordPress image URLs to use Tachyon

87338.5k2](/packages/humanmade-tachyon-plugin)

PHPackages © 2026

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