必须加--enable-mysqlnd，因为它是启用swoole_mysql::escape等关键方法的硬性前提，否则报fatal error；且要求php已加载mysqlnd扩展，否则swoole初始化失败。
--enable-mysqlnd 是唯一需要显式指定的编译参数，用于开启 Swoole 的 mysqlnd 支持。
为什么必须加 --enable-mysqlnd？
这个参数不是可选“增强”，而是启用 swoole_mysql::escape 等关键方法的硬性前提。不加它，调用 swoole_mysql::escape 会直接报 Fatal error: Call to undefined method swoole_mysql::escape()。
它还影响底层对 mysqlnd 内存结构的访问权限——Swoole 需要直接读取 mysqlnd 的 internal buffer 来做高效转义，而不是走 PHP 用户层字符串处理。
- PHP 运行时必须已加载
mysqlnd扩展（不是mysqli或pdo_mysql单独存在就行），否则 Swoole 初始化会失败并报错：PHP Startup: Unable to load dynamic library 'swoole.so'... missing mysqlnd symbols - 该参数在 Swoole 4.0+ 中仍需手动开启，不会自动检测或 fallback
- 和
--with-mysqli=mysqlnd这类 PHP 编译参数无关，那是控制 PHP 自身扩展的；--enable-mysqlnd是 Swoole 自己的开关
--enable-mysqlnd 和 PHP 的 mysqlnd 模块怎么配？
两者必须对齐版本且共存。常见错误是 PHP 编译时没带 --enable-mysqlnd，或者用了 --with-mysql=libmysql（即 legacy MySQL client lib）。
- 确认 PHP 已启用 mysqlnd：
php -i | grep "Client API version" | grep "mysqlnd"，输出应含mysqlnd 8.3.9类字样 - 检查
php.ini中没有禁用：extension=mysqli和extension=pdo_mysql可以存在，但不能把mysqlnd本身关掉（它不是独立 extension，而是内建库） - 若用
pecl install swoole安装，交互式提问中看到enable mysqlnd support? [no]时，**必须输yes**，否则等价于没加参数
容易被忽略的兼容陷阱
这个参数看似简单，但实际部署中最常栽在环境链路上。
- Alpine Linux 上默认不带 mysqlnd：需先
apk add php83-mysqlnd（注意 PHP 主版本号匹配），再装 Swoole - PHP 8.3+ 启用
opcache.preload时，若 preload 文件里提前引用了swoole_mysql，而--enable-mysqlnd没生效，会卡在 preload 阶段失败，错误日志只显示Class 'swoole_mysql' not found，不提示根本原因 - 某些 Docker 镜像（如
php:8.3-cli）默认不启用 mysqlnd，得手动在构建时加--enable-mysqlnd到 PHP 编译参数，或改用php:8.3-apache这类预装全量的镜像
真正麻烦的从来不是加一个参数，而是确保从 PHP 编译、模块加载、到 Swoole 初始化这整条链路里，mysqlnd 始终以一致的方式存在并导出符号。漏掉任意一环，swoole_mysql::escape 就只是个不存在的方法名。
