566E
首页 包列表 提交包 常见问题 关于

cable8mm/view-transformer 问题修复 & 功能扩展

解决BUG、新增功能、兼容多环境部署，快速响应你的开发需求

邮箱：yvsm@zunyunkeji.com | QQ：316430983 | 微信：yvsm316

cable8mm/view-transformer

Composer 安装命令：

composer require cable8mm/view-transformer

包简介

View Transformer make profile image or name if client's information is empty.

关键字：

#php #sdk #free #avatar #cat #dog

README 文档

README

code-style run-tests Packagist Version Packagist Downloads Packagist Dependency Version Packagist Stars License: CC BY-NC-ND 4.0 Packagist License

A PHP library for generating pet (dog/cat) avatar images and nicknames. Provides consistent images and nicknames based on user IDs, and includes WordPress content transformation features.

Features

  • 4,080 dog/cat nicknames (breed names + descriptive adjectives)
  • 80 dog avatar images
  • 41 cat avatar images
  • 3 image sizes supported (large, medium, small)
  • Transform WordPress content to HTML (YouTube embed, caption tag processing)
  • Laravel Blade support
  • Deterministic algorithm (same ID always returns same result)

Installation

composer require cable8mm/view-transformer

Quick Start

use Cable8mm\ViewTransformer\PrettyProfile;

// Generate nickname
$nickname = PrettyProfile::getInstance()->nickname(12345);
// Output: "Happy Poodle" (example)

// Get dog image URL
$dogImage = PrettyProfile::getInstance()->dog(12345);
// Output: "https://cabinet-pets.palgle.com/avatars/dog/61.png"

// Get cat image URL (medium size)
$catImage = PrettyProfile::getInstance()->cat(12345, 'medium');
// Output: "https://cabinet-pets.palgle.com/avatars/cat/medium/13.png"

API Reference

PrettyProfile

Generates nicknames and pet image URLs based on user ID.

Methods

nickname(int $id): string

Generates a nickname from user ID.

Parameters:

  • $id (int): User ID (must be >= 1)

Returns: Adjective + breed name combination (e.g., "Ordinary Nebelung")

Throws: InvalidArgumentException - If ID is 0 or negative

Example:

echo PrettyProfile::getInstance()->nickname(1);
//=> Ordinary Nebelung

echo PrettyProfile::getInstance()->nickname(2);
//=> Sexy Norwegian Forest
cat(int $id, ?string $size = null): string

Returns a cat image URL.

Parameters:

  • $id (int): User ID (must be >= 1)
  • $size (string|null): 'large', 'medium', 'small', or null (original size)

Returns: Image URL

Throws: InvalidArgumentException - If ID is invalid or size is not valid

Example:

echo PrettyProfile::getInstance()->cat(1);
//=> https://cabinet-pets.palgle.com/avatars/cat/1.png

echo PrettyProfile::getInstance()->cat(1, 'medium');
//=> https://cabinet-pets.palgle.com/avatars/cat/medium/1.png
dog(int $id, ?string $size = null): string

Returns a dog image URL.

Parameters:

  • $id (int): User ID (must be >= 1)
  • $size (string|null): 'large', 'medium', 'small', or null (original size)

Returns: Image URL

Throws: InvalidArgumentException - If ID is invalid or size is not valid

Example:

echo PrettyProfile::getInstance()->dog(1);
//=> https://cabinet-pets.palgle.com/avatars/dog/1.png

echo PrettyProfile::getInstance()->dog(1, 'large');
//=> https://cabinet-pets.palgle.com/avatars/dog/large/1.png
cats(?string $size = null): array

Returns array of all cat image URLs.

Parameters:

  • $size (string|null): 'large', 'medium', 'small', or null (original size)

Returns: Array of image URLs (41 items)

Example:

$cats = PrettyProfile::getInstance()->cats();
// Array of 41 image URLs

$cats = PrettyProfile::getInstance()->cats('medium');
// Array of 41 medium-sized image URLs
dogs(?string $size = null): array

Returns array of all dog image URLs.

Parameters:

  • $size (string|null): 'large', 'medium', 'small', or null (original size)

Returns: Array of image URLs (80 items)

Example:

$dogs = PrettyProfile::getInstance()->dogs();
// Array of 80 image URLs

$dogs = PrettyProfile::getInstance()->dogs('small');
// Array of 80 small-sized image URLs
profileImage(int $id, ?string $image = null, string $animal = 'dog'): string

Helper method for Laravel Blade templates.

Parameters:

  • $id (int): User ID
  • $image (string|null): Custom image URL (used if provided)
  • $animal (string): 'dog' or 'cat' (default: 'dog')

Returns: Image URL

Throws: InvalidArgumentException - If animal is not 'dog' or 'cat'

Example:

{{ PrettyProfile::profileImage(4123, animal: 'dog') }}
{{-- Output: https://cabinet-pets.palgle.com/avatars/dog/43.png --}}

{{ PrettyProfile::profileImage(4123, animal: 'cat') }}
{{-- Output: https://cabinet-pets.palgle.com/avatars/cat/10.png --}}

{{ PrettyProfile::profileImage(4123, image: 'https://example.com/custom.png') }}
{{-- Output: https://example.com/custom.png --}}
backgroundImage(?string $background_image = null): string

Returns a background image URL.

Parameters:

  • $background_image (string|null): Custom background image URL

Returns: Background image URL

Example:

echo PrettyProfile::backgroundImage();
//=> https://cabinet-pets.palgle.com/bg/bg-1.png

echo PrettyProfile::backgroundImage('https://example.com/bg.png');
//=> https://example.com/bg.png

WordBinder

Transforms WordPress content to HTML.

Methods

view(string $content): string

Transforms WordPress shortcodes to HTML.

Supported features:

  • Extract only images from [caption] tags
  • Convert [embed] tags to YouTube iframes
  • Remove empty paragraphs (<p>&nbsp;</p>)

Parameters:

  • $content (string): WordPress content

Returns: Transformed HTML

Example:

use Cable8mm\ViewTransformer\WordBinder;

// YouTube embed transformation
$content = '[embed]https://www.youtube.com/watch?v=XsJ9GFGkEOk[/embed]';
echo WordBinder::view($content);
//=> <iframe width="100%" height="100%" src="https://www.youtube.com/embed/XsJ9GFGkEOk" frameborder="0" allow="accelerometer; autoplay; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>

// Extract image from caption tag
$content = '[caption width=80]<img src="image.jpg" />[/caption]';
echo WordBinder::view($content);
//=> <img src="image.jpg" />

// Remove empty paragraphs
$content = '<p>Content</p><p>&nbsp;</p><p>More</p>';
echo WordBinder::view($content);
//=> <p>Content</p><p>More</p>
addBanner(string $content, string $bannerHtml, int $nthPTag = 0): string

Inserts banner HTML after the nth <p> tag in HTML content.

Parameters:

  • $content (string): HTML content
  • $bannerHtml (string): Banner HTML to insert
  • $nthPTag (int): Insert position (0 = at the beginning, default: 0)

Returns: HTML with banner inserted

Example:

$banner = '<a href="https://example.com">Banner</a>';
$content = '<p>Para1</p><p>Para2</p><p>Para3</p>';

// Insert banner at the beginning
echo WordBinder::addBanner($content, $banner, 0);
//=> <a href="https://example.com">Banner</a><p>Para1</p><p>Para2</p><p>Para3</p>

// Insert banner after 2nd paragraph
echo WordBinder::addBanner($content, $banner, 2);
//=> <p>Para1</p><p>Para2</p><a href="https://example.com">Banner</a><p>Para3</p>

// If n exceeds number of <p> tags, insert at beginning
echo WordBinder::addBanner($content, $banner, 10);
//=> <a href="https://example.com">Banner</a><p>Para1</p><p>Para2</p><p>Para3</p>

Usage Examples

Generate User Profile Images

use Cable8mm\ViewTransformer\PrettyProfile;

$userId = 393939;

// Generate nickname
$nickname = PrettyProfile::getInstance()->nickname($userId);
echo $nickname; // "Ordinary Nebelung"

// Get dog profile image
$dogImage = PrettyProfile::getInstance()->dog($userId);
echo $dogImage; // "https://cabinet-pets.palgle.com/avatars/dog/64.png"

// Get cat profile image (medium size)
$catImage = PrettyProfile::getInstance()->cat($userId, 'medium');
echo $catImage; // "https://cabinet-pets.palgle.com/avatars/cat/medium/10.png"

Get All Images

use Cable8mm\ViewTransformer\PrettyProfile;

// Get all dog images (original size)
$allDogs = PrettyProfile::getInstance()->dogs();

// Get all cat images (medium size)
$allCatsMedium = PrettyProfile::getInstance()->cats('medium');

// Generate preview
foreach ($allDogs as $index => $url) {
    echo "![Dog $index]($url)\n";
}

Laravel Blade Integration

{{-- Basic usage --}}
<img src="{{ PrettyProfile::profileImage($user->id, animal: 'dog') }}" alt="Profile">

{{-- Cat image --}}
<img src="{{ PrettyProfile::profileImage($user->id, animal: 'cat') }}" alt="Profile">

{{-- Custom image (takes priority) --}}
<img src="{{ PrettyProfile::profileImage($user->id, image: $user->custom_avatar) }}" alt="Profile">

WordPress Content Transformation

use Cable8mm\ViewTransformer\WordBinder;

// WordPress content with YouTube video
$wordpressContent = '
    <p>First paragraph</p>
    [embed]https://www.youtube.com/watch?v=abc123&t=30[/embed]
    <p>Second paragraph</p>
';

$html = WordBinder::view($wordpressContent);
// YouTube embed is converted to iframe

// Insert banner ad
$banner = '<div class="ad-banner">Advertisement</div>';
$contentWithBanner = WordBinder::addBanner($html, $banner, 1);
// Banner inserted after first paragraph

Exception Handling

use Cable8mm\ViewTransformer\PrettyProfile;

try {
    // Invalid ID (0 or negative)
    PrettyProfile::getInstance()->cat(0);
} catch (\InvalidArgumentException $e) {
    echo $e->getMessage();
    // "The value must be over 0, so a value of 0 is not valid."
}

try {
    // Invalid size
    PrettyProfile::getInstance()->dog(1, 'huge');
} catch (\InvalidArgumentException $e) {
    echo $e->getMessage();
    // "The value must be "large" or "medium" or "small", so a value of "huge" is not valid."
}

try {
    // Invalid animal
    PrettyProfile::profileImage(1, animal: 'rabbit');
} catch (\InvalidArgumentException $e) {
    echo $e->getMessage();
    // "The value must be dog or cat. rabbit is not valid."
}

Algorithm

Image Selection Algorithm

Uses the remainder of dividing user ID by the number of images. This ensures:

  • Deterministic: Same ID always returns the same image
  • Uniform distribution: If IDs are evenly distributed, images are evenly distributed
  • Unlimited: Works correctly even if ID exceeds image count
// Example: Dog images (80 total)
$id = 827342;
$imageNumber = ($id - 1) % 80 + 1; // 62
// User #827342 always uses image #62

Nickname Generation Algorithm

Selects prefix (adjective) and suffix (breed name) independently using modular arithmetic.

// Example: ID 1
$prefixIndex = (1 - 1) % 40; // 0 → First adjective
$nicknameIndex = (1 - 1) % 66; // 0 → First breed name
// Result: "Ordinary Nebelung" (example)

Preview

Dog artworks

Dog 1 Dog 2 Dog 3 Dog 4 Dog 5 Dog 6 Dog 7 Dog 8 Dog 9 Dog 10 Dog 11 Dog 12 Dog 13 Dog 14 Dog 15 Dog 16 Dog 17 Dog 18 Dog 19 Dog 20 Dog 21 Dog 22 Dog 23 Dog 24 Dog 25 Dog 26 Dog 27 Dog 28 Dog 29 Dog 30 Dog 31 Dog 32 Dog 33 Dog 34 Dog 35 Dog 36 Dog 37 Dog 38 Dog 39 Dog 40 Dog 41 Dog 42 Dog 43 Dog 44 Dog 45 Dog 46 Dog 47 Dog 48 Dog 49 Dog 50 Dog 51 Dog 52 Dog 53 Dog 54 Dog 55 Dog 56 Dog 57 Dog 58 Dog 59 Dog 60 Dog 61 Dog 62 Dog 63 Dog 64 Dog 65 Dog 66 Dog 67 Dog 68 Dog 69 Dog 70 Dog 71 Dog 72 Dog 73 Dog 74 Dog 75 Dog 76 Dog 77 Dog 78 Dog 79 Dog 80

Cat artworks

Cat 1 Cat 2 Cat 3 Cat 4 Cat 5 Cat 6 Cat 7 Cat 8 Cat 9 Cat 10 Cat 11 Cat 12 Cat 13 Cat 14 Cat 15 Cat 16 Cat 17 Cat 18 Cat 19 Cat 20 Cat 21 Cat 22 Cat 23 Cat 24 Cat 25 Cat 26 Cat 27 Cat 28 Cat 29 Cat 30 Cat 31 Cat 32 Cat 33 Cat 34 Cat 35 Cat 36 Cat 37 Cat 38 Cat 39 Cat 40 Cat 41

Formatting

composer lint
# Modify all files to comply with the PSR-12.

composer inspect
# Inspect all files to ensure compliance with PSR-12.

Test

composer test

License

The View Transformer project is open-sourced software licensed under the MIT license.

Artworks © 2020 by Samgu Lee is licensed under CC BY-NC-ND 4.0. To view a copy of this license, visit http://creativecommons.org/licenses/by-nc-nd/4.0/

cable8mm/view-transformer 适用场景与选型建议

cable8mm/view-transformer 是一款 基于 PHP 开发的 Composer 扩展包，目前已累计 12 次下载、GitHub Stars 达 1， 最近一次更新时间为 2025 年 03 月 11 日， 在 PHP 生态内属于活跃度较高的组件。

它主要适用于以下技术方向： 「php」 「sdk」 「free」 「avatar」 「cat」 「dog」 等业务场景。在实际项目中，围绕这些方向常见需要落地的问题包括：接口对接、性能调优、并发安全、与既有框架（Laravel / ThinkPHP / Yii / Webman 等）的兼容适配，以及生产环境的日志埋点与稳定性保障。

我们在过去多个企业项目中使用过 cable8mm/view-transformer 或与其功能相近的方案，如果你在选型或落地过程中遇到问题，例如 版本兼容、二次改造、私有化封装、与内部系统对接、生产 BUG 排查，欢迎联系我们协助评估。

围绕 cable8mm/view-transformer 我们能提供哪些服务？
定制开发 / 二次开发

基于 cable8mm/view-transformer 在你已有业务上做功能扩展、字段裁剪、UI 适配、与内部账号 / 权限 / 日志系统的深度对接。

BUG 修复 & 性能优化

线上偶发问题、内存泄漏、慢查询、并发异常等排查修复；针对高流量场景做缓存、队列、索引层面的调优。

项目外包 & 长期维护

承接完整的项目从需求 → 设计 → 开发 → 上线 → 长期运维；也可按月提供技术保姆服务。

yvsm@zunyunkeji.com QQ：316430983 微信：yvsm316 西安尊云信息科技 · 专注 PHP / Go / 分布式系统研发

与 cable8mm/view-transformer 相关的其它包

同方向 / 同关键字的高下载量 PHP Composer 包推荐，方便对比选型：

net_bazzline/component_requirement 1

free as in freedom php component requirement

net_bazzline/php_component_locator_generator 1

Free as in freedom php component that generates configuration based hard coded locator

jeromeklam/freews 0

Free PHP WebSocket

esc-company/view-transformer 0

View Transformer make profile image or name if client's information is empty.

foxtes/alfabank-rest 1

Alfabank REST API integration

lablnet/logger 3

PHP logger package.

统计信息

  • 总下载量： 12
  • 月度下载量： 0
  • 日度下载量： 0
  • 收藏数： 1
  • 点击次数： 24
  • 依赖项目数： 0
  • 推荐数： 0

GitHub 信息

  • Stars： 1
  • Watchers： 1
  • Forks： 0
  • 开发语言： PHP
访问仓库

其他信息

  • 授权协议： MIT
  • 更新时间： 2025-03-11