php全文检索需先选对方案：中小项目用mysql fulltext索引（引擎为innodb、字段为text/varchar），大型项目用elasticsearch；建索引要合规，搜索需过滤停用词、调优分词、预处理文本，避免因配置错误或数据脏导致查不到结果。
MySQL FULLTEXT 索引建不起来？检查这几点
FULLTEXT 不是加个关键字就能用的，它对表结构和数据类型有硬性要求：
- 存储引擎必须是
InnoDB（5.6+）或MyISAM，MEMORY或ARCHIVE不支持 - 字段类型只能是
CHAR、VARCHAR、TEXT；TINYTEXT可以，但ENUM、JSON不行 - 建索引语句要写在
CREATE TABLE里，或者用ALTER TABLE ... ADD FULLTEXT，不能用CREATE INDEX - 中文搜索默认效果差，因为 MySQL 内置分词器按空白和标点切词，不是按字或词切——“数据库优化”会被当成一个词，搜“数据库”就匹配不上
ERROR 1214 (HY000): The used table type doesn't support FULLTEXT indexes 就是引擎不对；Warning: #1287 'FULLTEXT' is deprecated 是用了老版本 MyISAM 的布尔模式语法。
用 match() against() 搜不到结果？重点看参数和数据
MATCH(title, body) AGAINST(:term IN NATURAL LANGUAGE MODE) 看似简单，但实际容易卡在细节：
- 自然语言模式下，MySQL 会自动过滤停用词（如“的”“和”“在”），且词长小于 4 的词默认不索引（可通过
ft_min_word_len调整，但需重启 MySQL） - 搜索词如果全是停用词，比如搜“PHP 的使用”，可能整个查询返回空——不是代码错，是 MySQL 直接跳过匹配
-
IN BOOLEAN MODE支持+、-、*等操作符，但字段值里含+符号时（如标题含“C++教程”），需转义或改用自然语言模式 - 相关性得分（
relevance）是浮点数，值可能非常小（如 0.0002），排序时容易被忽略，建议显式加上ORDER BY MATCH(...) AGAINST(...) DESC
ft_min_word_len = 2，然后重建索引，不是改完配置就生效。
文件级搜索用 file() + strpos()，为什么一搜大文件就卡死？
这种写法适合几百 KB 以内的文本，比如配置文件或日志片段：
-
file()会把整个文件读进内存，10MB 文件 ≈ 占用 10MB PHP 内存，超限直接Fatal error: Allowed memory size exhausted -
strpos()是逐行匹配，无法处理跨行关键词（如关键词换行断开），也不支持模糊或近义匹配 - 用户输入没过滤就拼进
exec("grep '$kw' file.txt")，等于敞开命令注入大门——$kw = "test; rm -rf /"就能跑通
fopen() + fgets() 流式读取，每行只存一行内容，内存可控；若需高亮或正则，用 preg_match() 替代 strpos()，但记得加 PREG_OFFSET_CAPTURE 获取位置。
Elasticsearch 客户端连不上？先确认三件事
PHP 调 Elasticsearch 报cURL error 7: Failed to connect 或空响应，90% 是环境链路问题：
- PHP 进程能否访问 ES 地址？用
curl -X GET http://localhost:9200在 CLI 下手动测，别只信浏览器能打开 - ES 是否监听了外部地址？默认只绑
127.0.0.1，Docker 或远程部署时需改network.host: 0.0.0.0并开防火墙端口 - PHP 客户端是否用了过期的 API？
elasticsearch/elasticsearchv8.x 已移除type参数，还写'type' => 'doc'就会 400 错误
analyzer，比如：
"mappings": {
"properties": {
"title": { "type": "text", "analyzer": "ik_smart" }
}
}
否则还是走默认的 standard 分析器，照样按字切。
全文检索最常被忽略的一点：**没有预处理就没有好结果**。不管是 MySQL 还是 ES，原始文本里的 HTML 标签、多余空格、全角标点、乱码字符，都会污染分词和匹配。上线前至少做一次 strip_tags() + mb_convert_kana()（转全角为半角）+ preg_replace('/\s+/', ' ', $text) 清洗，比调参有用得多。php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
