tnsnames.ora 不是必须的，PHP 可用 Easy Connect 语法（如 'localhost:1521/XE'）直连 Oracle；仅当需复用别名或统一管理时才需配置，且须正确设置 TNS_ADMIN、文件路径、权限及格式。
PHP 连接 Oracle 时 tnsnames.ora 不是必须的
PHP 用 oci_connect() 或 oci_pconnect() 连 Oracle，可以直接写连接描述符（即“Easy Connect”语法），完全绕过 tnsnames.ora。只有当你想复用别名、隐藏连接细节或配合 Oracle 客户端工具统一管理时，才需要配置它。
常见错误是：装了 Oracle Instant Client，但没设 TNS_ADMIN 环境变量，导致 PHP 找不到 tnsnames.ora；或者文件路径写错、权限不足、格式有空格/注释不规范，结果报 ORA-12154: TNS:could not resolve the connect identifier specified。
-
tnsnames.ora必须放在TNS_ADMIN指向的目录下（不是$ORACLE_HOME/network/admin） - PHP 进程（如 Apache 的 httpd 或 php-fpm）启动前就得设置好
TNS_ADMIN，运行中改无效 - Windows 下建议用绝对路径，比如
C:\oracle\network\admin；Linux 下注意 SELinux 或文件权限（web 用户需可读） - 别名里不能含下划线以外的特殊字符，且要和 PHP 中
oci_connect()第二个参数完全一致
用 Easy Connect 语法直连，省去 tnsnames.ora 配置
绝大多数场景推荐直接用 Easy Connect，格式为：host:port/service_name 或 host:port/SID。它不依赖本地配置文件，部署更轻量，也避免了环境差异引发的解析失败。
示例：
立即学习“PHP免费学习笔记（深入）”；
oci_connect('scott', 'tiger', 'localhost:1521/XE')
注意：
- Oracle 12c+ 推荐用
service_name（如XE），不是SID；旧版数据库若只知 SID，可尝试加?server=DEDICATED强制兼容 - 如果数据库启用了 SSL/TLS，Easy Connect 不支持，此时必须回退到完整描述符或
tnsnames.ora -
防火墙、监听器状态、远程访问权限（
sqlnet.ora中SQLNET.AUTHENTICATION_SERVICES）这些底层问题，和是否用tnsnames.ora无关，但常被误判为配置失败
tnsnames.ora 文件格式与典型错误
一个最小可用条目长这样：
MYDB =
(DESCRIPTION =
(ADDRESS = (PROTOCOL = TCP)(HOST = db-server)(PORT = 1521))
(CONNECT_DATA =
(SERVER = DEDICATED)
(SERVICE_NAME = orclpdb)
)
)
容易踩的坑：
- 行首/行尾多空格或制表符 —— Oracle 解析器很敏感，会静默失败
- 用中文括号、全角字符、隐藏 Unicode 字符（尤其从文档复制时）
-
SERVICE_NAME和实际数据库服务名大小写不一致（Linux 下区分） - 忘记配
CONNECT_DATA块，或拼错关键词（如写成CONNECTION_DATA）
验证 tnsnames.ora 是否生效的最快方法
不要先写 PHP 代码——先用 Oracle 自带工具确认解析通不通：
- 命令行执行
tnsping MYDB（MYDB是你在tnsnames.ora里定义的别名），看是否返回 OK 和正确地址 - 再用
sqlplus username/password@MYDB尝试登录，排除认证或权限问题 - 如果这两步都成功，PHP 中才用
oci_connect('user', 'pass', 'MYDB')；否则别急着调 PHP
很多线上问题其实卡在 tnsping 这一步，但开发者跳过去直接查 PHP 日志，徒增排查成本。
