PHP连接数据库全攻略

本文深入解析了PHP连接数据库的现代最佳实践，强调必须摒弃已彻底废弃的mysql_*函数，优先选用PDO（推荐开启异常模式、正确处理DSN特殊字符、区分127.0.0.1与localhost）或规范使用mysqli面向对象方式，并严格遵循环境隔离原则——配置绝不硬编码，敏感信息须通过环境变量安全注入；更重要的是，直击开发者普遍忽视的关键认知：数据库连接成功仅是第一步，真正的可用性必须在业务层通过健壮的异常捕获、预处理防注入、字符集统一（utf8mb4）及降级策略来保障，让动态网站的数据交互既安全又可靠。

PHP 动态网站连接数据库，核心就一条：用 PDO 或 mysqli，别碰已废弃的 mysql_* 函数——它们在 PHP 7.0+ 中彻底没了，硬写会直接报 Fatal error: Uncaught Error: Call to undefined function mysql_connect()。

用 PDO 连 MySQL 最稳妥的写法

PDO 支持多种数据库，统一接口，预处理防 SQL 注入，是现代 PHP 的事实标准。关键不是“能不能连”，而是“连错时有没有清晰反馈”。

常见错误现象：PDO::__construct(): MySQL server has gone away、Connection refused、空白页无报错（其实是 PHP 错误被静默吞了）。

• 必须开启异常模式：$pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION)，否则连接失败也不抛错
• DNS 字符串里端口不能省略默认 3306，如果改过端口（比如 Docker 映射为 3307），必须显式写上 host=localhost;port=3307
• 本地开发用 127.0.0.1 而非 localhost，避免 Unix socket 和 TCP 混淆（尤其 macOS MAMP 或 WAMP 下容易连错）
• 密码含特殊字符（如 @、/）必须用 urlencode() 处理，否则 DSN 解析失败

$dsn = 'mysql:host=127.0.0.1;port=3306;dbname=test;charset=utf8mb4';
$user = 'root';
$pass = urlencode('p@ss/w0rd'); // 必须转义
$pdo = new PDO($dsn, $user, $pass, [
    PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC,
    PDO::ATTR_EMULATE_PREPARES => false,
]);

mysqli 面向对象方式比过程式更可控

如果你项目已用 mysqli，别切到 PDO；但新项目不建议选它。过程式写法（mysqli_connect()）容易漏关连接、难做连接池模拟，而面向对象能明确生命周期。

使用场景：老系统维护、或需要精细控制连接状态（比如长连接复用、重试逻辑）。

• 构造时传参顺序固定：host, username, password, dbname, port, socket，端口和 socket 位置易错
• 连接失败后，$mysqli->connect_error 是字符串，$mysqli->connect_errno 是数字错误码，别只看前者
• 执行查询前务必检查 $mysqli->connect_errno === 0，否则 query() 可能静默返回 false
• UTF-8 支持要两步：建表用 utf8mb4，连接后立刻执行 $mysqli->set_charset('utf8mb4')

环境隔离：开发 / 测试 / 生产的配置不能混

把数据库账号密码硬编码在 index.php 里？上线就等于裸奔。真实项目中，连接参数必须从外部加载，且不同环境互不影响。

• 推荐用 .env 文件 + vlucas/phpdotenv，但注意：生产环境别用它——性能差，应提前导出为 PHP 数组或环境变量
• Apache 下用 SetEnv，Nginx 下用 fastcgi_param，把敏感配置注入 PHP-FPM 环境，再用 getenv('DB_HOST') 读取
• 配置项命名保持一致：DB_HOST、DB_PORT、DB_NAME、DB_USER、DB_PASS，别一会儿 database_password 一会儿 db_pwd
• 测试环境可强制用 SQLite 内存数据库：sqlite::memory:，避免污染 MySQL 测试库

最常被忽略的一点：连接成功不等于可用。哪怕 PDO 实例创建出来了，第一次 query() 仍可能因超时、权限不足、表不存在而失败。别在构造函数里就执行查询，把实际操作推迟到业务逻辑层，并做好 try/catch 包裹和降级处理（比如缓存兜底）。

今天关于《PHP连接数据库全攻略》的内容就介绍到这里了，是不是学起来一目了然！想要了解更多关于php动态网站开发的内容请关注golang学习网公众号！