FULLTEXT索引在phpEnv中需MySQL层正确配置：确认InnoDB引擎+MySQL≥5.6，中文搜索必须启用ngram解析器并显式声明WITH PARSER ngram，短词搜索需调小ft_min_word_len并重建索引，PHP仅作安全拼接传参。
FULLTEXT 索引在 phpEnv 环境下不是“开箱即用”的功能，它完全依赖底层 MySQL 的配置与表结构，PHP 本身不参与索引构建或分词逻辑。如果你发现 MATCH() AGAINST() 返回空结果或始终不命中，大概率是 MySQL 层没配对，而不是 PHP 代码写错了。
确认 MySQL 版本和存储引擎是否支持 FULLTEXT
phpEnv 默认集成的 MySQL 多为 5.7 或 8.0，但部分精简版可能仍用 MyISAM（已弃用）或未启用 InnoDB 全文支持。必须手动验证：登录 phpEnv 自带的 MySQL 客户端（如通过 phpMyAdmin 或命令行），执行：
SELECT VERSION();
再查当前表引擎：
SHOW CREATE TABLE articles;
确保输出中包含 ENGINE=InnoDB 且版本 ≥ 5.6。若为 ENGINE=MyISAM，虽能用但不推荐；若版本低于 5.6，FULLTEXT 在 InnoDB 上根本不可用，必须升级 phpEnv 或切换到官方 MySQL 8.0 包。
中文搜索必须启用 ngram 解析器
MySQL 原生FULLTEXT 对中文完全无效——它按空白和标点切词，而中文无空格分隔。phpEnv 的 MySQL 配置文件（通常是 mysqlmy.ini 或 mysqlmy.cnf）里必须添加：
[mysqld]ngram_token_size=2
重启 MySQL 服务后，建索引时要显式指定解析器：
立即学习“PHP免费学习笔记（深入）”；
ALTER TABLE articles ADD FULLTEXT(content) WITH PARSER ngram;
注意：WITH PARSER ngram 不能省略；否则即使配置了 ngram_token_size，索引仍按默认方式构建，中文查询依然失败。
常见错误现象：搜索“数据库”返回零结果，但搜“数据*”或“库”却有结果——这是未启用 ngram 的典型表现。
MATCH AGAINST 不支持参数化，PHP 中必须手动过滤
PHP 使用mysqli 或 PDO 时，MATCH() AGAINST() 的搜索词不能直接绑定参数，因为 MySQL 不允许预处理语句中将 AGAINST 的值作为占位符。你必须自己清理输入：
- 去除前后空格、换行、制表符
- 过滤掉 MySQL 布尔模式中的危险操作符（如
+、-、>、<），除非你明确开放布尔搜索 - 若用自然语言模式，还要注意默认最小词长是 4（
ft_min_word_len=4），搜“PHP”“AI”这类短词会静默忽略——需在my.ini中改为ft_min_word_len=1并重建索引
示例安全拼接（非布尔模式）：
$term = trim($_GET['q'] ?? '');<br>
$term = preg_replace('/[+-&|!(){}[]^"~*?:\\]/', '', $term);<br>
$sql = "SELECT *, MATCH(title, content) AGAINST(? IN NATURAL LANGUAGE MODE) AS score<br>
FROM articles WHERE MATCH(title, content) AGAINST(? IN NATURAL LANGUAGE MODE)";<br>
$stmt = $pdo->prepare($sql);<br>
$stmt->execute([$term, $term]);
索引字段类型和长度限制很硬，别踩坑
FULLTEXT 只接受 CHAR、VARCHAR、TEXT，且对 VARCHAR 有隐形长度上限：
在 InnoDB 中，单个 VARCHAR 字段建 FULLTEXT 时，实际可用长度 ≤ 3072 字符（不是字节）。如果定义为 VARCHAR(5000)，建索引会成功，但超出部分的内容不会被索引——查不到。
更隐蔽的问题：phpEnv 的某些 MySQL 编译版本启用了 innodb_large_prefix=OFF，会导致建表时 FULLTEXT 索引失败，报错类似 ERROR 1071 (42000): Specified key was too long。此时要么改字段为 TEXT，要么在 my.ini 中强制开启：
[mysqld]<br> innodb_large_prefix=ON<br> innodb_file_format=Barracuda<br> innodb_file_per_table=ON
然后重建表（ALTER TABLE ... ENGINE=InnoDB ROW_FORMAT=DYNAMIC）。
ft_min_word_len 修改后必须重建索引、VARCHAR 长度超限导致内容截断——这些都不会报错，只会让你反复怀疑 PHP 代码。 
