先说一个关键点：username 这个参数，其实跟 PHP 8.5.5 本身没啥关系——它只是你写连接代码时，传递给 PDO 或 mysqli 的一个普通参数。PHP 版本本身不负责管理数据库账号，真正起作用的，是你用的扩展和具体的连接方式。
那问题来了：到底该怎么传这个参数，才能让数据库乖乖认账？下面分几种常见场景拆开讲。
用 PDO 连 MySQL 时怎么传 username
关键就一句话：必须作为构造函数第二个参数显式传入，不能指望 DSN 里带，更不能靠环境变量自动注入。
PDO构造函数的签名是new PDO($dsn, $username, $password, $options)，$username就是你要填的字符串值。- DSN 字符串里塞用户名是无效的——像
'mysql:host=localhost;dbname=test;user=root'这种写法，user=会被直接忽略，框架根本不认。 - 如果从
.env读，得手动取出来：$username = $_ENV['DB_USERNAME'] ?? 'root';，不能指望框架自动绑定。
用 mysqli 连 MySQL 时 username 怎么写
两种写法，本质一样，都是把用户名当作明确的位置参数传进去。
- 面向对象：
new mysqli($host, $username, $password, $dbname, $port)—— 第二个参数就是$username。 - 过程式：
mysqli_connect($host, $username, $password, $dbname, $port)—— 同样是第二个参数。 - 需要留个心眼：如果省略了
$dbname，$username仍然是第二个，别把位置搞错。漏掉数据库名会导致连接成功但没选库，后面执行query()时会报No database selected，查起来挺头疼。
ThinkPHP 8 配置里 username 放哪儿
这事很容易踩坑。不是写在 .env 的任意键就能自动生效，而是必须落在 config/database.php 的具体 connection 数组里。
- 错误示范：在
.env里写个DB_USERNAME=root，然后指望 TP8 自动映射到 Oracle 或 SQL Server 的连接配置中——结果就是连不上，框架根本不认。 - 正确位置：
'mysql' => ['username' => 'root', 'password' => '123456', ...]，这个数组必须手写、硬编码，且键名严格为username。 - 大小写敏感：
Username或USER_NAME都无效，框架直接跳过，降级用默认值，连接认证自然失败。
Oracle 连接时 username 为什么总连不上
OCI 驱动对 username 参数极其敏感，有几个常见的静默失败点，值得提前注意：
PDO::__construct()的第二个参数必须是非空字符串，null或空格都会触发ORA-12154，而且错误信息不会直接告诉你“用户名有问题”。- 不能用
oci:dbname=//...;user=xxx这种写法——OCI DSN 不支持user=，只认构造函数参数里的username。 - 如果用户名里包含特殊字符（比如
/、@），必须做 URL 编码，否则 OCI 初始化直接崩溃，连个详细错误都不给。
实际开发中最常被忽略的一点，是把 username 当成一个“全局配置项”去设，而忘了它永远只是某次连接动作里的一个输入参数——传错位置、类型不对、被覆盖、大小写不一致，都直接导致认证拒绝，并且错误信息往往不指向 username 本身。排查的时候，不妨从“这个参数到底传没传对位置”开始。
