正确命令是 composer require cakephp/string，该包由 CakePHP 团队维护，提供 Text::slug() 和 Text::truncate() 等静态方法，需确保 autoload.php 已加载，且 HTML 实体需手动解码。
直接执行 composer require cakephp/string，不是 stringy/stringy
Stringy 项目早在 2019 年就移交给了 CakePHP 团队并重命名为 cakephp/string。如果你按旧文档搜索 “stringy composer”，尝试运行 composer require stringy/stringy，会收到 Could not find package stringy/stringy 错误——这个包早已从 Packagist 移除。正确命令只有一条：
composer require cakephp/string
安装后，CakeStringStringifier 和核心类 CakeStringText 就可用了，它们是原 Stringy 功能的延续，API 高度兼容。
使用前必须手动加载或确认自动加载已生效
Composer 默认启用 PSR-4 自动加载，但如果你在非标准结构（比如没用 index.php 引入 vendor/autoload.php）中测试，会遇到 Class 'CakeStringText' not found。这不是库问题，而是加载链断了：
- 确保脚本开头有
require 'vendor/autoload.php'; - 检查
composer.json中是否意外删掉了"autoload": {"psr-4": {"Cake\": "src/"}}类似配置（通常不需要改，除非你自定义了命名空间） - 若用在 Laravel 或 CakePHP 项目里，无需额外操作；但纯 PHP 脚本中漏掉
autoload.php是最常见失败原因
Text::slug() 和 Text::truncate() 是高频替代点
原 Stringy 的 create()->slugify() 和 create()->truncate() 现在对应 Text::slug() 和 Text::truncate()。注意参数顺序和默认行为变化：
立即学习“PHP免费学习笔记（深入）”；
-
Text::slug('Hello World!', '-', ['en'])—— 第二个参数是分隔符，第三个是语言代码（影响字符转换逻辑） -
Text::truncate('Long text here', 10, ['ellipsis' => '…', 'exact' => false])——exact=false表示截断到词边界，避免切开单词 - 不传选项数组时，
truncate()默认不加省略号，容易误以为“没截断”，建议显式传['ellipsis' => '…']
别在循环里反复 new Text()，复用静态方法更轻量
虽然 Text 类支持实例化（new Text('foo')），但所有字符串方法都是静态的。实例化不仅无必要，还会多一次对象分配：
// ❌ 不推荐
$s = new Text('hello');
$result = $s->slugify();
// ✅ 推荐
$result = Text::slug('hello');
尤其在处理大量字符串（如导出 CSV、批量清洗日志）时，避免实例化能减少内存压力。原 Stringy 的 fluent 接口（create()->trim()->lower()）在这里不适用——cakephp/string 设计为函数式调用，每个方法独立接收字符串参数。
真正容易被忽略的是：它不处理 HTML 实体解码，默认把 & 当普通字符。如果输入含 HTML 实体，得先用 html_entity_decode() 清洗，否则 slug() 会生成类似 foo-amp-bar 的结果。
