Webman本身不内置机器学习能力，但可集成php-ai/php-ml；训练须离线执行并序列化保存，预测时应预加载模型至内存避免重复反序列化，且需确保向量化参数、缩放器配置及PHP-ML版本全程一致。
Webman 本身不内置机器学习能力，但可以像普通 PHP 项目一样引入 php-ai/php-ml。关键不是“能不能集成”，而是「训练阶段放哪」「预测请求怎么扛」「模型要不要持久化」——这三个问题没理清，直接在 Webman 控制器里 new NaiveBayes() 会出生产事故。
Webman 中模型训练不能放在请求生命周期里
每次 HTTP 请求都重新训练模型，等于用 train() 把 CPU 和内存反复拉满。尤其当 $samples 来自数据库或 CSV，还带预处理时，响应可能超时甚至 OOM。
- 训练必须离线：写成独立的 Artisan 风格命令（比如
php webman ml:train-spam-filter），用crontab或人工触发 - 训练完立刻序列化保存：用
serialize($classifier)+file_put_contents('model.spam')，别依赖var_export或 JSON - 确保模型文件权限可控：Webman 工作进程用户（如
www-data）需有读权限，但不能被 Web 目录直接访问到
预测逻辑要避免反序列化开销重复发生
如果每个请求都 unserialize(file_get_contents('model.spam'))，PHP 每次都要重建对象图，小模型还好，带权重矩阵的 MultilayerPerceptron 反序列化耗时可能达毫秒级——对高并发接口就是瓶颈。
- 用
opcache.file_cache缓存反序列化结果（PHP 8.2+ 支持opcache.preload预加载） - 更稳的做法：启动 Webman Worker 时一次性加载模型到内存（例如在
start.php或自定义Bootstrap类中） - 注意
NaiveBayes等模型不是线程安全的：多个 Worker 共享同一实例没问题，但别在协程里跨请求复用未加锁的可变状态
CSV 数据加载和特征向量化必须与 Webman 生命周期解耦
CsvDataset 默认从文件读取，TfIdfTransformer 的 fit() 会扫描全部样本——这些操作若塞进控制器，第一次请求慢、后续请求也慢（因为没缓存向量器参数）。
立即学习“PHP免费学习笔记（深入）”；
- 向量化参数（如
TfIdfTransformer的vocabulary_、idf_）必须和模型一起持久化，不能每次 predict 都重算 - Webman 路由接收原始文本时，先用已保存的
StopWordsEnglish和WhitespaceTokenizer处理，再喂给向量器transform()，最后进分类器 - 警惕
MinMaxScaler：如果训练时用了它，预测前必须用完全相同的min_和scale_值缩放新数据，否则predict()结果毫无意义
最常被忽略的一点：PHP-ML 没有内置模型版本管理。今天你用 php-ai/php-ml:^0.9 训练的 SVC 模型，明天升级到 ^1.0 后 unserialize() 可能失败，或者预测结果漂移——上线前务必在相同版本下完成训练、保存、加载全流程验证。
