包简介

A simple and configurable string formatting pipeline for PHP.

README 文档

README

A simple and configurable string formatting pipeline for PHP.

Define formatting rules using a compact, readable DSL like:

padLeft:10:0;replace:_:space;padAfterFirst:11:0

This library lets you manipulate strings in a declarative and reusable way — ideal for formatting ticket numbers, codes, IDs, or any value that needs structured transformation.

🚀 Installation

composer require ferryhopper/php-string-formatter

🧪 Usage

use StringFormatter\StringFormatter;

$formatted = StringFormatter::apply('K563793', 'remove:space;replace:K:A;padAfterFirst:11:0');
// Returns: "K 00000563793"

🛠 Supported Formatters

Formatter	Description
`padLeft:length:char`	Left-pads the string to `length` using `char`.
`padRight:length:char`	Right-pads the string to `length` using `char`.
`replace:search:replace`	Replaces all occurrences of `search` with `replace`.
`remove:target`	Removes all occurrences of `target`.
`padAfterFirst:length:char`	Pads the part after the first character to `length` using `char`.

🔤 Special Keywords

Use "space" instead of a literal space character.
- replace:_:space → replaces _ with a space
- remove:space → removes all spaces

🧪 Testing

vendor/bin/phpunit

📦 Roadmap Ideas

Custom formatter registration
Support for named pipelines
Optional error handling modes (fail-fast vs silent)

👨‍💻 Authors

Maintained by the Ferryhopper engineering team.
Initial development by @vlahanas.

📝 License

MIT — see LICENSE for details.

ferryhopper/php-string-formatter 适用场景与选型建议

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

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

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

围绕 ferryhopper/php-string-formatter 我们能提供哪些服务？

定制开发 / 二次开发

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

BUG 修复 & 性能优化

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

项目外包 & 长期维护

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

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

与 ferryhopper/php-string-formatter 相关的其它包

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

floor12/yii2-phone 3

Yii2 phone formatter and validator.

gskema/elasticsearch-query-dsl-php 7

Feature complete, object oriented, composable, extendable Elasticsearch query DSL builder for PHP.

biano/elasticsearch-dsl 3

Elasticsearch DSL library

shadowbane/laravel-datadog-logger 1

Custom laravel monolog logger for datadog logs management, both api and agent ways

xakepehok/expression-executor 4

Expression executor, which allow to implement domain-specific language

matthiasnoback/code-sniffer-sniff-dsl 10

DSL for writing sniffs for PHP_CodeSniffer

ferryhopper/php-string-formatter

包简介

关键字：