composer安装cocur/slugify失败主因是php版本＞7.4或未启用intl扩展；中文转slug为空需显式设locale='zh'并确保intl启用；推荐迁移到brick/slugify以获php 8.2+支持及自动去重音等现代特性。
Composer 安装 cocur/slugify 失败的常见原因
直接运行 composer require cocur/slugify 失败，大概率是因为 PHP 版本或 Composer 仓库配置问题。这个库已停止维护（最后更新是 2021 年），官方推荐迁移到 brick/slugify，但如果你必须用 cocur/slugify，得确认两点：
一是你的 PHP 版本 ≤ 7.4（它不支持 PHP 8+）；二是 Composer 源没被墙（国内建议先切阿里云镜像：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/）。
安装后调用 Slugify::slugify() 报 “Class not found”
这是自动加载没生效的典型表现。确保你已执行过 composer install 或 composer update，且项目根目录下存在 vendor/autoload.php。使用时必须显式引入：
require_once 'vendor/autoload.php';
use Cocur\Slugify\Slugify;
$slugify = new Slugify();
echo $slugify->slugify('Hello World! 你好'); // 输出 hello-world-ni-hao
漏掉 require_once 或没写 use 声明，就会触发 Class 'Cocur\Slugify\Slugify' not found 错误。
中文、特殊字符和空格处理不符合预期
cocur/slugify 默认只转义 ASCII 字符，对中文支持依赖于 intl 扩展（PHP 的 ICU 库）。如果输出是 hello-world-4f60-597d 这种 Unicode 码点，说明 intl 未启用。检查方式：php -m | grep intl。没输出就需安装（Ubuntu： sudo apt-get install php-intl；macOS + Homebrew + PHP 8.1：brew install icu4c && pecl install intl，并在 php.ini 加 extension=intl）。
另外，它的默认分隔符是 -，若想改成下划线，传参即可：
-
$slugify->slugify('Foo Bar', '_')→foo_bar -
$slugify->slugify('café', '', ['lowercase' => false])→Café（保留大小写和重音）
为什么建议优先考虑 brick/slugify
不是不能用 cocur/slugify，而是它已归档，不再修复 bug，也不适配新 PHP 版本。换成 brick/slugify 只需两步：composer require brick/slugify，然后：
use Brick\Slugify\Slugify;
$slugify = new Slugify();
echo $slugify->slugify('Beyoncé & naïve'); // beyonce-naive（自动去重音、支持 PHP 8.2+）
它的规则更现代，比如默认移除所有标点（包括 &）、智能处理连字符、原生支持多语言而无需额外扩展。老项目迁移只需改命名空间和类名，其余调用完全一致。
真正麻烦的不是安装命令，而是确认运行环境是否满足底层依赖——尤其是 intl 和 PHP 版本对齐。没验证这点就开干，后面 URL 生成乱码或报错，排查起来反而更费时间。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
