codeigniter4的.env文件中数据库密码含特殊字符时需url编码，如p@ss/w0rd#123编码为p%40ss%2fw0rd%23123；引号和反斜杠转义无效，ci4通过parse_url()解析dsn故必须url编码密码部分。
CodeIgniter4 的 .env 文件本身不支持转义语法，遇到数据库密码含特殊字符（如 @, /, :, ?, # 等），不能靠加反斜杠 \ 或引号包裹来“转义”，而是要URL 编码——因为 CI4 内部用 parse_url() 解析数据库 DSN，而 DSN 本质是 URL 格式。
✅ 正确做法：对密码做 URL 编码
比如原始密码是：P@ss/w0rd#123
它包含 @、/、#，这些在 mysql://user:pass@host/db 中会破坏 URL 结构，导致解析失败（如把 @ 误认为用户名与主机分隔符）。
你需要将密码部分单独编码：
echo urlencode('P@ss/w0rd#123'); // 输出：P%40ss%2Fw0rd%23123
然后写入 .env：
database.default.password=P%40ss%2Fw0rd%23123
CI4 加载时会自动解码，无需额外处理。
⚠️ 注意：只编码密码（或用户名）本身，不要对整个 DSN 字符串编码；也不要对
database.default.hostname或database.default.database编码，除非它们也含特殊字符且作为 URL 路径/查询参数出现（极少见）。
❌ 常见错误方式（不起作用）
-
password="P@ss/w0rd#123"→ 引号在.env中无意义，CI4 不识别 shell 风格引号 -
password=P\@ss\/w0rd\#123→.env解析器不支持反斜杠转义 - 把整个
DSN写成一行并手动拼接 → 绕过 CI4 配置机制，失去可维护性，且易出错
? 验证是否生效
修改 .env 后，运行：
php spark db:connect --show
看输出的连接信息中密码是否显示为原始明文（CI4 已自动解码）。再试一个简单查询（如 php spark migrate:list），不报“Access denied”即说明密码识别正确。
? 小技巧：批量处理
如果密码复杂难记，可在本地 PHP 中快速生成：
<?php echo urlencode($argv[1] ?? 'your-pass-here'); // 命令行执行：php -f encode.php 'P@ss/w0rd#123' ?>
复制输出结果贴进 .env 即可。
