别装 jieba-php，它在 php 8+ 下基本不可用；推荐使用 overtrue/pinyin 替代，支持 php 8.0+、无词典路径依赖，配合正则提取汉字块与拼音归一化即可满足关键词提取等常见需求。
直接说结论：别装 jieba-php，它在 PHP 8+ 下基本不可用
你搜“Composer 中文分词”，大概率会撞上 fukuball/jieba-php。但这个包最后一次有效更新是 2017 年，PHP 兼容只到 7.1；Composer v2+ 会跳过它的 autoload_files 注册逻辑；词典路径硬编码为 ./dict/ 却不随包发布；更致命的是，Jieba 构造函数里直接访问不存在的 $this->dict["word"]，一调就报 Fatal error: Uncaught Error: Class "Jieba\Jieba" not found 或 Undefined array key "word"。装了也白装，还拖慢调试节奏。
composer require overtrue/pinyin 是当前最稳的轻量替代方案
如果你要的是关键词提取、搜索高亮、输入清洗这类场景（不是学术级 NLP），用拼音 + 规则切分比强塞一个崩溃的分词器靠谱得多：
-
composer require overtrue/pinyin一行搞定，无词典路径依赖，PHP 8.0+ 原生支持 - 对短文本（如标题、用户名）先提取连续汉字块：
preg_match_all('/[\x{4e00}-\x{9fff}]{2,}/u', $text, $matches)，过滤掉单字虚词 - 每个汉字块用
$pinyin->permalink($word)归一化，方便后续模糊匹配或去重 - 不需要训练模型、不占内存、不依赖外部服务，适合 CI/CD 和低配环境
安装后必须立刻配镜像，否则 composer require 会卡死
国内直连 packagist.org 几乎必超时，尤其加了中文相关包后请求更敏感：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 全局换阿里云源：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 换完立刻清缓存：
composer clear-cache - 验证是否生效：运行
composer require overtrue/pinyin -v，看日志里下载地址是否变成mirrors.aliyun.com - 如果仍卡在 downloading，说明镜像没生效，检查是否漏了
-g参数，或被公司代理拦截
Windows 下 composer require 找不到命令？先查 PATH
99% 不是没装好，而是 composer.bat 路径没进系统变量：
- 打开 PowerShell，运行
where composer—— 无输出就说明 PATH 没配 - 去
C:\ProgramData\ComposerSetup\bin\看是否存在composer.bat，没有就重装并勾选 “Add to PATH” - 把
C:\ProgramData\ComposerSetup\bin加进「系统变量」里的 Path，不是用户变量 - 关掉所有终端重开，再试
composer --version和composer require overtrue/pinyin
真正难的不是装哪个包，而是判断要不要装——很多中文处理需求，用正则 + 拼音 + 长度过滤就能绕过分词陷阱。一旦开始 debug Class 'Jieba\Jieba' not found，你就已经掉进维护成本远高于收益的坑里了。
