animal-avatar/animal-avatar-generator

Generate deterministic animal SVG avatars from string seeds (PHP + Laravel)

v1.0.0 2026-02-08 23:23 UTC

Requires

• php: ^8.1

Requires (Dev)

• phpunit/phpunit: ^10.5

Suggests

• illuminate/support: Required for Laravel service provider and facade integration.

MIT

• Khojiakbar Solijonov

• generator
• laravel
• avatar
• svg
• packagist

README

PHP-порт roma-lukashik/animal-avatar-generator: детерминированная генерация SVG-аватаров животных по строковому seed.

Установка

composer require animal-avatar/animal-avatar-generator

Использование (чистый PHP)

<?php

require __DIR__ . '/vendor/autoload.php';

use AnimalAvatar\AnimalAvatarGenerator;

$generator = new AnimalAvatarGenerator();
$svg = $generator->generate('user-42', ['size' => 200]);

echo $svg;

Helper-функция

$svg = animal_avatar('user-42', ['size' => '75%']);

Опции

• size (int|string) — размер аватара, по умолчанию 150
• round (bool) — круглая или прямоугольная форма, по умолчанию true
• blackout (bool) — тень на правой стороне, по умолчанию true
• avatarColors (string[]) — палитра цветов аватара
• backgroundColors (string[]) — палитра цветов фона

Laravel

Провайдер и фасад подключаются автоматически через package discovery.

use AnimalAvatar\Laravel\Facades\AnimalAvatar;

$svg = AnimalAvatar::generate('user-42');

Опубликовать конфиг:

php artisan vendor:publish --tag=animal-avatar-config

После публикации можно менять дефолты в config/animal-avatar.php.

Тесты

composer install
vendor/bin/phpunit

Лицензия

MIT