PHP邮箱去重校验，Codex走TaoToken复核格式-平芜编程栈

把这段 PHP 邮箱去重校验代码交给 Codex 复核之前，先得把 Codex 接上能用的 API 通道。TaoToken 官网 https://taotoken.net/?utm_source=taotoken_aicg_blog_end 上可以创建 API Key；原逻辑里用 explode 按逗号把 email 拆成数组，用 array_unique 判断有没有重复，再用 preg_match 逐个校验格式，三步全部通过才放行。这段代码本身不难，难的是 Codex 默认不认第三方 Key，鉴权一直过不去。把 Codex 的 model_provider 指到 TaoToken 后，请求才真正发出，模型也开始认真分析这段 PHP 校验逻辑。

这篇文章先顺着原始代码把「拆列表、去重、验格式」三个环节拆开，看 Codex 到底能复核出哪些坑；再回到接入侧，讲清楚 Key 从哪来、Base URL 填什么、config.toml 怎么写；最后给出修正后的 PHP 函数和验证方式。整个过程不需要你手动开一堆文档页，只要你手里有一把 TaoToken 的 API Key，剩下的就是改配置和贴代码。

1. Codex 卡在鉴权上：不是 PHP 逻辑的问题

1.1 Codex 默认端点不认第三方 Key

Codex 是 OpenAI 官方的命令行编程助手，配置文件通常放在~/.codex/config.toml。它默认使用自己的账号登录体系做认证，请求也只发到 OpenAI 官方端点。你手里如果只有一个第三方 API Key，直接往环境变量里一丢是不能生效的——Codex 不认识这个 Key，也不会因为你设置了一个环境变量就自动改走别的 Base URL。

这个连接问题在代码复核场景里特别容易误导人。你以为是自己这段 PHP 写崩了，Codex 才一直报错，实际上请求根本没到模型那一层。排查时先看 Codex 终端里的错误：如果出现鉴权失败、连接被拒绝、或者model_provider找不到这一类提示，基本可以断定是通道问题，而不是array_unique或preg_match写错了。把 Codex 指到 TaoToken 这条统一 API 通道后，Codex 会拿着你的 Key 往https://taotoken.net/api发请求，鉴权通过，PHP 复核才能往下走。

1.2 复核这段 PHP，Codex 要回答三个问题

原始代码把邮箱列表校验分成三层：explode(',', $email)负责拆列表，count($emailList) != count(array_unique($emailList))负责查重复，preg_match负责逐条验格式。Codex 复核这段逻辑时，至少要看三个点：

explode之后的元素有没有做trim。如果用户输入"a@b.com, a@b.com"，第二个邮箱前面多了一个空格，array_unique会把它们当成两个不同的字符串，重复判断直接失效。
array_unique是区分大小写的精确比对。Test@Example.com和test@example.com在邮箱语义里应当算重复，但array_unique不这么认为。
正则表达式是否覆盖了邮箱里常见的.、_、-，同时避免把user+tag@example.com这类合法邮箱误杀。

这三个问题对应到 Codex 的复核任务里，其实就是在问：去重逻辑有没有漏洞，格式正则有没有覆盖边界。明白了这个目标，再去配置通道，得到的回复才有参考价值。

2. 去 TaoToken 拿 Key：先解决 Codex 的认证来源

2.1 注册并创建 API Key

配置 Codex 之前，先打开 TaoToken 注册一个账号。登录进控制台后，创建一个 API Key，创建成功会得到一串以sk-开头的字符，这就是本文后面要用的YOUR_API_KEY。复制的时候小心别把多余空格或换行带进去，否则 Codex 发请求时鉴权会失败。

顺手在模型广场看一眼当前可用的模型 ID。这个 ID 会随着上游模型列表更新，网上旧教程里写的固定模型名不要直接抄，以 TaoToken 模型广场实际列出的为准。官网落地页和接口 Base URL 是两回事：落地页用 https://taotoken.net/?utm_source=taotoken_aicg_blog_end ，负责注册、创建 Key、看模型广场、看用量；真正填进 Codex 的 Base URL 是https://taotoken.net/api，末尾不要带/v1。

2.2 把 Key 写进 ~/.codex/config.toml

Codex 的自定义供应商配置写在~/.codex/config.toml。如果该文件不存在，直接新建。把下面的内容放进去：

model = "<替换成 TaoToken 模型广场上的实际模型 ID>" model_provider = "taotoken" [model_providers.taotoken] name = "TaoToken" base_url = "https://taotoken.net/api" env_key = "TAOTOKEN_API_KEY"

注意model_provider的值"taotoken"必须和下方[model_providers.taotoken]方括号里的名字保持一致。env_key告诉 Codex 从哪个环境变量读 Key，所以还需要把 Key 放进环境变量。macOS 或 Linux 下执行：

export TAOTOKEN_API_KEY=YOUR_API_KEY

Windows PowerShell 下执行：

$env:TAOTOKEN_API_KEY = "YOUR_API_KEY"

这里的YOUR_API_KEY就是你在 TaoToken 控制台创建的那串字符。不建议把 Key 明文写进 config.toml，环境变量方式更好，原因很简单：配置文件可能被同步到 Git 仓库或分享给同事，环境变量只存在当前会话里，泄露面小很多。

2.3 Base URL 不要加 /v1

https://taotoken.net/api这个地址末尾没有/v1，也不要手滑加上/v1/。Codex 会根据wire_api自动在 Base URL 后面拼接实际请求路径，你只写根地址就好。很多人之前配过别的兼容通道，习惯性补一个/v1，结果 Codex 请求落在不存在的路径上，返回 404，然后误以为是 Key 的问题，来回折腾。如果你以前在别的工具里用过「粘贴 Base URL + Key + 模型 ID」这种填空式配置，TaoToken 对应填法就是：Base URL 填https://taotoken.net/api，Key 填YOUR_API_KEY，模型 ID 从模型广场复制。

3. 走 TaoToken 让 Codex 复核 PHP 邮箱去重与格式

3.1 给 Codex 的复核提示词怎么组织

配置完成后，在终端里运行codex，把原始 PHP 代码贴进对话。贴代码前建议先补一个函数外壳，把$email、$name、ApiException的上下文交代清楚，否则 Codex 只知道中间几行逻辑，不知道这段代码从哪里来，也不知道异常类已经定义过。贴完代码后附上复核要求：

「检查 explode 出来的列表没做 trim 时，array_unique 会不会漏掉重复邮箱；preg_match 的正则是否覆盖 . _ - 等常见合法字符；列出你能想到的所有边界样本。」

Codex 收到请求后，对话文本会经过 TaoToken 通道发往模型，返回结果同样经 TaoToken 回传。你在终端看到正常流式输出，说明配对 Key、Base URL、模型 ID 这一串动作全部生效了。

3.2 Codex 复核结果一：array_unique 漏判重复邮箱

原代码比较count($emailList)和count(array_unique($emailList))，思路没问题，但 Codex 会指出两个漏判来源。

第一个是空格。表单里用户可能输入"a@b.com,b@c.com, a@b.com"，第三个邮箱前面带一个空格。explode只按逗号切分，不会去掉空格，于是" a@b.com"和"a@b.com"被array_unique当成两个不同字符串，重复邮箱顺利通过校验。第二个是大小写。array_unique做的是精确字符串比对，邮箱域名部分理论上不区分大小写，所以Test@Example.com和test@example.com应当算重复，但当前逻辑会把它们当成两个联系人，最终写入联系人列表时造成一真一假两条记录。

Codex 给的修改方向很直接：explode之后先trim去掉首尾空格，再统一转小写，然后才轮到array_unique。这一步不做，后面所有格式校验都是建立在脏数据上。

3.3 Codex 复核结果二：preg_match 正则覆盖不完整

原正则允许字母、数字、下划线、点号、中划线分段出现，并且要求点号、中划线、下划线后面必须跟词字符，所以a..b@example.com这种连续点会被拦下来，这一点设计得不错。但 Codex 会指出两个覆盖缺口。

第一个缺口是加号标签。很多系统会给邮箱加上user+tag@example.com这种别名格式，加号后面是备注标签，原正则的字符组里没有+，这类合法邮箱会被误判为格式不正确。第二个缺口是域名部分允许了下划线，user@my_domain.com会被放行，而下划线并不是域名中的合法字符。严格来说，域名段应该只允许字母、数字、中划线和点。

Codex 的复核结论是：原正则覆盖了. _ -，但边界不够干净，需要补充+支持，同时收紧域名段。另外还可以考虑用filter_var($val_email, FILTER_VALIDATE_EMAIL)做第一道格式校验，正则做第二道边界控制，双保险比单靠一个手写正则省心。

4. 按复核结果改写 PHP 邮箱校验

4.1 拆完先 trim 再小写，array_unique 才可靠

把原始逻辑重写成带函数上下文的版本，先解决空格和大小写问题：

public function validateContactEmails(string $email, string $name): void { if ($email === '') { return; } // 先 trim 再转小写，避免空格和大小写干扰 array_unique $emailList = array_map( fn(string $item): string => strtolower(trim($item)), explode(',', $email) ); $emailList = array_filter($emailList, fn(string $item): bool => $item !== ''); if (count($emailList) !== count(array_unique($emailList))) { throw new ApiException( ApiException::CONTACT_EMAIL_NOT_REPEATING_CODE, '联系人邮箱不能重复' ); } foreach ($emailList as $val_email) { $pattern = '/^\w+([\.\-\_\+]\w+)*@\w+([\.\-\_]\w+)*\.\w+([\.\-\_]\w+)*$/'; if (!preg_match($pattern, $val_email)) { throw new ApiException( ApiException::ERROR_EMAIL_FORM_CODE, '联系人' . $name . '邮箱格式不正确，请重新输入' ); } } }

array_filter是用来过滤空串的。如果用户输入"a@b.com,,b@c.com"，第二个元素是空字符串，参与去重比较没有意义，先过滤掉再统计重复更准确。

4.2 正则补上 + 标签并收紧域名段

上面的$pattern在原正则基础上加入了+，让user+tag@example.com能通过校验，同时保留了「标点后面必须跟词字符」的约束，避免a..b、a--b这类连续标点混进来。域名段收紧为只能由字母、数字、点、中划线构成，不再放行下划线。

如果你项目里希望更严格，可以再叠加一层filter_var判断，但要注意filter_var对国际化域名 IDN 支持有限。普通中文联系人的场景下，先trim、去重、再正则校验，已经能覆盖绝大多数输入。Codex 复核时真正关注的是「重复检测到底稳不稳」和「合法邮箱会不会被误伤」，这两点上面都处理到了。

4.3 保留 ApiException 的异常码和文案

改写过程中不要动两个异常码：CONTACT_EMAIL_NOT_REPEATING_CODE和ERROR_EMAIL_FORM_CODE。它们很可能是前端提示或日志报警的判据，代码可以改，常量名和业务文案要保持原样。如果 Codex 在返回建议时顺手改了文案，记得在对话里提醒它只改校验逻辑，不要动异常码和消息字符串。另外，$name是用户提交的原始值，拼进异常消息前最好做一下 HTML 转义，避免把异常内容变成可注入的字符串。

5. 验证调用：确认 Codex 真的走了 TaoToken

5.1 发一条短请求并去控制台看用量

配置完成后，在 Codex 里发一条极短的消息，比如「用五个字解释 array_unique」，看它是否正常返回。如果正常输出，说明 TaoToken 通道已经通了。然后去 https://taotoken.net/?utm_source=taotoken_aicg_blog_end 控制台的用量页面，看刚才这次请求是否记上了一笔调用记录。用量页能看到真实请求计数，比任何终端输出都可靠。

5.2 遇到 401、404、model not found 怎么处理

如果 Codex 返回invalid_api_key或 401，先检查TAOTOKEN_API_KEY环境变量是否等于你从 TaoToken 控制台复制的 Key，有没有多余空格，config.toml里的model_provider是不是还保持着"taotoken"。如果返回 404，几乎可以断定是 Base URL 多写了/v1，把https://taotoken.net/api里的路径清干净就好。如果 Codex 能连上但提示model not found，说明model字段填的 ID 不在模型广场列表里，回到 https://taotoken.net/?utm_source=taotoken_aicg_blog_end 模型广场复制当前实际提供的 ID 再试。

5.3 Codex 只看代码文本，不执行 PHP

最后提醒一点：Codex 经 TaoToken 通道看到的只是你贴进对话的代码文本，它不应该也不需要在你服务器上执行 PHP。凡是需要跑通这段校验逻辑的验证，都在你自己本地的 PHP 环境或测试环境里跑，把执行结果贴回对话，让 Codex 继续对照分析。这样既拿到了模型对array_unique和正则的复核意见，也不会把代码执行权交给一个命令行工具。

这轮用 Codex 复核 PHP 邮箱去重校验，本质上只是把对话走了一把 TaoToken 的通道。后面你如果还要处理联系人导入去重、批量格式清洗、异常码枚举这类需求，可以在同一个 Codex 会话里继续贴代码、贴报错、贴边界样本。还没拿 Key 的话，去 https://taotoken.net/?utm_source=taotoken_aicg_blog_end 注册并创建 API Key，把config.toml里的YOUR_API_KEY一换，第一轮复核就能跑起来。