企业官网建设流程全解析

简介：MySQL_Connection_Project是一份面向PHP初学者的数据库连接学习资源，核心围绕早期mysql_connect函数展开，同时结合现代mysqli与PDO扩展，帮助读者理解从旧式连接到安全连接方案的演进脉络。压缩包共15个文件，主体为7个VB源码文件，辅以项目配置、界面资源与解决方案文件，整体约17KB，适合有基础PHP语法、希望补全数据库实操经验的入门级开发者参考。已有215人浏览学习。通过该工程可直观看到连接建立、错误处理、资源释放等典型流程，并对照描述中关于SQL注入防护、最小权限配置与凭据管理等最佳实践，强化对数据库连接安全与规范化的理解。

1. 从 MySQL_Connection_Project.rar 开始：一个老项目的连接名场面

你手上如果出现一个叫“MySQL_Connection_Project.rar”的压缩包，多半是两种情况：课程设计/毕业设计的源码，或者某个老系统交接出来的历史代码。解压以后大概率是几个 PHP 文件加一个 .sql 脚本，打开一看，里面清一色是 MYSQL_connect 这一串。mysql_connect 是 PHP 5 时代连接 MySQL 的标准函数，PHP 7.0 起被彻底移除，所以很多人照着示例敲完第一行，就撞上 “Call to undefined function mysql_connect()”。这篇文章我不讲大道理，按我接手这类老工程时的顺序，从解压、识别连接方式、最小改动跑通，到排查连不上的具体报错，再到把它迁到 PDO，一步步说清楚。新手能跟着把项目跑起来，熟手可以直接翻参数表和最后的迁移清单。

2. 解压之后做什么：先分清 mysql_connect / mysqli / PDO 三种连接形态

2.1 一个压缩包里的四类文件：入口、配置、建库脚本和说明

拿到 .rar 包后，我习惯先建一个新目录再解压，避免直接覆盖到正在运行的老项目上。解压之后不要急着双击 index.php，先看一遍文件清单，判断这个项目是“完整可跑”还是“残缺半成品”。

mkdir -p ~/project/MySQL_Connection_Project unzip MySQL_Connection_Project.rar -d ~/project/MySQL_Connection_Project cd ~/project/MySQL_Connection_Project find . -maxdepth 2 -type f | sort

执行后你会看到一组文件。常见的构成是四类：第一类是 PHP 页面文件，比如 index.php、login.php、register.php，这是业务入口；第二类是连接文件，常被命名为 config.php、conn.php、db.php、mysqli_connect.php，这是整个项目的命脉；第三类是 SQL 脚本，通常叫 database.sql 或 mysql.sql，里面是建库建表语句；第四类是说明文件，readme.txt 或 设计文档.docx，别看它们不起眼，我经常在上面找到数据库用户名、密码和端口。

这里最容易踩的坑是：把 config.php 当普通页面直接访问。很多老项目的 config.php 没有做访问控制，直接放到 web 根目录，浏览器一打开就把数据库账号密码全部暴露了。我一般的做法是先看一眼这个文件的内容，确认里面有没有 die('非法访问') 之类的防护，如果没有，第一件事就是把它移到 web 根目录之外，或者改成只有 CLI 环境下可以读取。项目能不能跑是次要的，先别把自己的数据库钥匙挂在门口。

2.2 按代码形态识别连库方式：mysql_connect 橡皮章长什么样

打开连接文件，里面会出现三种连库写法中的一种。判断它们不需要读完整个项目，看函数名就够了。

// 形态一：老式过程化 mysql_connect（PHP 5，PHP 7 已移除） $conn = mysql_connect("localhost", "root", "123456"); mysql_select_db("bookstore", $conn); // 形态二：mysqli 过程化写法（PHP 5.3+ 到 PHP 8 都可用） $conn = mysqli_connect("localhost", "root", "123456", "bookstore", 3306); // 形态三：PDO 面向对象写法（推荐） $pdo = new PDO("mysql:host=localhost;dbname=bookstore;port=3306;charset=utf8mb4", "root", "123456");

这三段代码逻辑上都是建连接，但底层差异很大。mysql_connect 是 PHP 5 时代的“橡皮图章”，到处复制粘贴，后面跟的 mysql_query、mysql_fetch_array 都是一条路走到黑。mysqli 和 PDO 则支持预处理、事务、面向对象调用，后面要迁移工作量完全不同。

判断完之后，你也别急着删 mysql_connect。先查一下 PHP 版本：

php -v php -m | grep -i -E "mysqli|pdo_mysql"

如果 php -v 显示 PHP 7 或 8，而项目里全是 mysql_connect，那么你再怎么改密码都跑不起来，因为函数本身不存在了。这时候只有两条路：要么装一个 PHP 5.6 的环境专门跑老代码，要么把 mysql_connect 全部改成 mysqli 或 PDO。后面第三、六章我会把这两条路的操作都补全。

2.3 定位连接参数：host、用户名、密码、端口藏在哪个文件

很多人解压一个老项目后，首先翻 readme，但 readme 里经常只有“请修改 config.php 中的数据库配置”这一句废话。真正的参数藏在四个位置：config.php / conn.php / db.php 这类文件里；SQL 脚本开头的注释里；PHP 文件开头的注释块里；如果你够走运，项目用了 .env 或 ini 配置，那么参数集中在一个文件里。判断项目里到底有哪些连接参数，用一行 grep 就能扫出来：

grep -rn -E "mysql_connect|mysqli_connect|new PDO|host|dbname" --include="*.php" .

扫完你会看到类似 “mysql_connect('localhost', 'root', '123456')” 这样的字符串。于是参数就有了：host 是 localhost，用户名是 root，密码是 123456，dbname 通常写在 mysql_select_db("bookstore", $conn) 里。端口在 mysql_connect 时代基本不动，默认 3306。需要注意的是老项目里密码可能被 md5 处理过之后再当数据库密码用，你直接拿它去连 MySQL 会 Access denied。我遇过不止一次，最后是去 SQL 脚本里翻出了 INSERT INTO user 的明文密码才算完。

参数扫出来后，建议先把这段整理成一个连接参数表：host 写 127.0.0.1 还是 localhost，端口是不是 3306，库名是哪个，字符集是什么。因为后面改配置、排查报错，全靠这张表对照。

3. 让 mysql_connect 在本地跑通：最小连接代码与 PHP 版本真相

3.1 为什么你装了 MySQL 8.0 却报 Call to undefined function mysql_connect()

这个报错可以说是这个标题下最热门的问题。现象非常统一：代码是教程或压缩包里抄来的，明明 PHP 装好了，MySQL 也启动了，但一访问页面就是 “Call to undefined function mysql_connect()”。原因不是数据库没装好，而是 PHP 版本里根本没有 mysql_connect 这个函数。

mysql_connect 诞生于 PHP 3 时代，到 PHP 5.5 被标记为 deprecated，PHP 7.0 正式移除。对应的替代函数是 mysqli_connect 和 PDO。你去看 php -m 的输出，里面只会有 mysqli 和 pdo_mysql，不会有 mysql 扩展，因为官方压根不再带它了。

解决这道坎有两个方向。方向一：如果你一定要原样跑这份老代码，就用 PHP 5.6，再开启 php.ini 里的 extension=php_mysql.dll。方向二：更现实的做法是保留现在的 PHP 版本，把项目的 mysql_connect 调用批量改成 mysqli_connect。从这里也能看出标题里“MYSQL_connect”这个写法很误导人，很多人以为是大写字母的问题，改成 mysql_Connect，其实不是大小写，是函数在 PHP 7 里根本不存在。

3.2 最小连接示例：一份经过调校的 connect.php

先给一份老语法下能跑通的最小连接代码，前提是你的 PHP 是 5.6，且 mysql 扩展已开启，MySQL 服务端允许本地连接。

<?php // connect.php — 老项目最小连接示例 $db_host = '127.0.0.1'; $db_user = 'root'; $db_pass = '123456'; $db_name = 'bookstore'; $db_port = 3306; // mysql_connect 老函数：只负责建立连接 $conn = mysql_connect($db_host, $db_user, $db_pass); if (!$conn) { die('连接失败: ' . mysql_error()); } // 选择数据库 if (!mysql_select_db($db_name, $conn)) { die('选择数据库失败: ' . mysql_error()); } // 设置连接字符集 mysql_set_charset('utf8', $conn); // 验证查询 $result = mysql_query('SELECT 1 AS ok', $conn); $row = mysql_fetch_assoc($result); echo 'MySQL 连接正常, ok=' . $row['ok']; mysql_close($conn); ?>

这段代码的要点有三个：host 我特意写成 127.0.0.1 而不是 localhost，后面我会专门解释；mysql_select_db 和 mysql_set_charset 必须各写一行，缺少任何一个都可能出现“数据库里明明有数据，查出来却是空”或中文乱码的情况；mysql_error() 一定要放在 die 里，它能让你在浏览器上直接看到 MySQL 返回的错误码，省去翻日志的工夫。

如果你是 PHP 7 或 8，直接把上面这份保存下来是没有意义的。同样功能用 mysqli 写会少很多坑：

<?php // connect_mysqli.php — PHP 7/8 下的替代写法 $db_host = '127.0.0.1'; $db_user = 'root'; $db_pass = '123456'; $db_name = 'bookstore'; $db_port = 3306; $conn = mysqli_connect($db_host, $db_user, $db_pass, $db_name, $db_port); if (mysqli_connect_errno()) { die('连接失败: ' . mysqli_connect_error()); } mysqli_set_charset($conn, 'utf8mb4'); $result = mysqli_query($conn, 'SELECT 1 AS ok'); $row = mysqli_fetch_assoc($result); echo 'MySQL 连接正常, ok=' . $row['ok']; mysqli_close($conn); ?>

mysqli 版本把数据库名直接塞进 mysqli_connect 的第四个参数，省掉了 mysql_select_db 这一步，但并不建议你在项目入口处省掉它，因为后面很多老代码可能还在用 mysql_select_db 或 mysqli_select_db，页面之间会互相干扰。设置字符集这步不能跳过，而且我建议直接写 utf8mb4，而不是老代码里的 utf8，后面章节会说原因。

3.3 连不上的三类现象：服务、认证、扩展，各看什么日志

连不上的现象一般归成三类。第一类是 “Can't connect to MySQL server on '127.0.0.1'”，这说明 MySQL 服务没起来，或者监听端口不对。Windows 上我一般先跑 net start mysql，看服务是否存在；Linux 上跑 systemctl status mysqld，如果没起来，去 my.cnf 或 my.ini 看 log-error 路径，那里有服务启动失败的真正原因，比如 data 目录权限不对、端口被占用、初始化未完成。

第二类是 “Access denied for user 'root'@'localhost'”，这是认证问题。密码不对、用户 host 段不匹配、密码为空但配置里填了密码，都会产生这个错误。解决路径是先本地测试一下：mysql -uroot -p123456 -h127.0.0.1 -P3306。命令行能连而 PHP 不能连，说明 PHP 侧配置有偏差；命令行也连不上，问题出在 MySQL 用户本身，去 user 表里查。

第三类就是上一节讲的 “undefined function mysql_connect()”，这不是连接问题，是 PHP 扩展问题。执行 php -m 检查扩展列表，再用 php --ini 找到当前生效的 php.ini，确认 extension 配置。你改了 php.ini 后一定记得重启 php-fpm 或 Apache，否则改动不生效，这是我见过最多的“改了等于没改”。

4. 连接配置里的四个坑点：端口、字符集、时区、认证方式

4.1 localhost 与 127.0.0.1 的差异：TCP 与 socket 的底层区别

老项目里连接参数写 localhost 很普遍，但排错时我通常建议先改成 127.0.0.1。区别在于：PHP 解析 localhost 时，在 Linux 上优先走 Unix socket，在 Windows 上走 TCP，而且 socket 路径一旦与 MySQL 的 socket 配置不一致，连接就会失败。很多压缩包代码在 Linux 服务器上能跑，拿到你 Windows 本机就报 “Can't connect through socket”，就是这个原因。

你可以用命令行验证 socket 路径：

mysql -uroot -p -e "SHOW VARIABLES LIKE 'socket';"

如果 PHP 里写死 localhost，而 php.ini 里 mysqli.default_socket 指向的路径与 MySQL 实际 socket 路径不同，连接必然失败。改成 127.0.0.1 后强制走 TCP，绕开 socket 路径排查，问题通常会立刻消失。要注意的副作用是走 TCP 后，MySQL 用户表的 host 字段如果是 localhost，连接会被拒绝，所以同时要确保你的用户 host 是 % 或 127.0.0.1。

另外端口也值得顺手确认：MySQL 默认 3306，但总有人为了“安全”把端口改成 3307 之类的。在 config.php 里没有显式写端口的老代码，默认就是 3306。如果登录配置改了端口，php 脚本没有相应的配置入口，建议在连接参数前用 mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT) 打开错误报告，这样端口配错时你能看到具体提示。

4.2 中文乱码：连接字符集要单独设置，光建表用 utf8mb4 不够

这个坑可以说是 mysql_connect 时代遗留下来的第一大坑。表现很典型：MySQL 命令行里查数据全是正常中文，页面上一输出全是 “????” 或 “且。原因是字符集有四层需要对齐：服务器字符集、数据库字符集、连接字符集、PHP 文件编码。老代码通常只建了库和表，却忘了设置连接字符集。

MySQL 连接建立后，两端默认使用服务器 character_set_server 的配置，你不主动设置，就可能出现中文数据写入时被按错误编码截断。所以在 mysql_connect 之后必须手动设置一次：

mysql_set_charset('utf8', $conn);

在 mysqli 里对应：

mysqli_set_charset($conn, 'utf8mb4');

注意这里我推荐 utf8mb4 而不是 utf8。MySQL 的 utf8 是 utf8mb3，最多只能存 3 字节字符，像 emoji 表情这种 4 字节字符会直接报错或变成乱码。老系统如果是 utf8，拿到新环境接手时，建议把数据库和表的字符集一并升级成 utf8mb4：

ALTER DATABASE bookstore CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; ALTER TABLE books CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

这一步会重建表，数据量大时要分批执行。字符集升级后，如果页面还是乱码，再检查 PHP 文件本身保存的编码是不是 UTF-8，用文件头的 BOM 干扰也常有。我的经验是：凡是 mysql 连接项目里出现中文乱码，先去改连接字符集，别急着动数据库结构。

4.3 时区参数：datetime 差 8 小时的根源

很多项目把当前时间直接交给 MySQL，用 NOW() 写入 datetime 字段，页面读出来却差了 8 个小时。原因在于 MySQL 的 time_zone 变量和 PHP 默认时区不一致。PHP 侧默认 UTC，MySQL 侧可能是 SYSTEM，也可能是 UTC，两边一交错，时间就不对了。

排查顺序先看 MySQL 服务端时区：

SHOW VARIABLES LIKE 'time_zone'; SELECT NOW();

如果输出是 UTC，而你的业务用户在中国，那么所有 NOW() 写入的数据都会比北京时间少 8 小时。处理方式有两个：等价的修复办法是直接设置服务端时区，Windows 上可以改 my.ini：

[mysqld] default-time-zone = '+08:00'

也可以在 PHP 连接建立后在代码里执行 SET time_zone 命令。但更推荐统一到客户端处理：PHP 里用 date_default_timezone_set('Asia/Shanghai')，写入数据库前用 PHP date 函数生成时间字符串，而不是把 NOW() 塞给 SQL。对于老项目，改动最少的是服务端直接配 default-time-zone，一行配置解决全部旧页面。

需要注意：如果这台 MySQL 上还有别的业务，全局修改会影响到与 UTC 时间相关的其他系统。改之前先看业务有没有跨时区需求，再决定是全局改还是单个连接里改。

4.4 caching_sha2_password：MySQL 8 默认认证与老 PHP 客户端握手失败

mysql_connect 老项目如果新装的是 MySQL 8.0，会遇到一个非常隐蔽的报错：PHP 连接时报 “The server requested authentication method unknown to the client”。这是 MySQL 8.0 默认认证插件从 mysql_native_password 改成了 caching_sha2_password，老客户端不认新插件。

解决方式有两种。推荐方案是给项目专用的 MySQL 用户保留老认证方式，而不是全局关闭：

CREATE USER 'appuser'@'%' IDENTIFIED WITH mysql_native_password BY 'your_password'; GRANT ALL PRIVILEGES ON bookstore.* TO 'appuser'@'%'; FLUSH PRIVILEGES;

如果用户已经存在，直接改认证插件：

ALTER USER 'appuser'@'%' IDENTIFIED WITH mysql_native_password BY 'your_password'; FLUSH PRIVILEGES;

这样只在 appuser 一个账号上使用老协议，其余账号继续保持 strong 认证。MySQL 8.4 里 mysql_native_password 默认被禁用，如果连这个方案都失效，那就只有一个正路：把代码迁移到 mysqli 或 PDO，并让连接走 caching_sha2_password 兼容的客户端。

这里要提醒一个我踩过的坑：折腾认证插件之前，先确认 php.ini 里的 mysqli.default_socket 与 MySQL 的 socket 路径一致。有时候报错信息没有直接说认证失败，而是笼统地显示 “Connection refused”，误导你去查认证，查了半天是 socket 配置问题。

5. 避坑排查：MySQL 连不上的六条血泪经验

5.1 密码正确却 Access denied：user 表 host 段与空密码策略

现象：mysql -uroot -p123456 在命令行能进，PHP 连同样账号密码却报 Access denied。原因：MySQL 用户认证的主键由 user 和 host 联合决定。root 用户可能同时存在 root@localhost 与 root@% 两条记录，PHP 走 127.0.0.1 时匹配的是 root@localhost，走 socket 时匹配的又是另一条。而你的密码可能只设置在了 % 的记录上。解决：先查 user 表确认匹配路径：

SELECT user, host, plugin FROM mysql.user WHERE user = 'root';

然后对需要的 host 重新设置密码：

ALTER USER 'root'@'localhost' IDENTIFIED BY '123456'; FLUSH PRIVILEGES;

如果 PHP 连的是 127.0.0.1，要确认 root@localhost 和 root@127.0.0.1 都存在，否则就统一使用一个 host 值。

5.2 mysql ssl连接错误：CA 文件缺失与模式不匹配

现象：MySQL 8 常见报错为 “SSL connection error: unknown error number” 或 “[ERROR] [MY-014060] Invalid mysql server upgrade”。原因：MySQL 默认开启 SSL，客户端连接时如果没有指定 CA 文件，或服务端 SSL 证书过期，就会因握手协商失败而中断。解决：不需要用 SSL 的本地环境，可以跳过 SSL 校验：

<?php // mysqli 连接关闭 SSL 校验 $conn = mysqli_init(); mysqli_options($conn, MYSQLI_OPT_SSL_VERIFY_SERVER_CERT, false); mysqli_real_connect($conn, '127.0.0.1', 'root', '123456', 'bookstore', 3306, null, MYSQLI_CLIENT_SSL);

如果业务要求强制 SSL，那要确保 CA 证书放入指定目录，并在 my.ini 里配置 ssl-ca 路径。Windows 上还常见 MySQL 服务启动时 SSL 证书路径写反斜杠导致解析失败，建议统一用正斜杠或双反斜杠。

5.3 MySQL 服务无法启动：my.ini 与权限问题的自查路径

现象：Windows 上运行 net start mysql 提示服务无法启动，或 Linux 上 systemctl start mysqld 直接失败。原因主要有三个：my.ini 配置项写错、data 目录权限不对、上次异常退出留下 binlog 或 pid 文件冲突。解决：先看错误日志，Windows 默认在 MySQL 安装目录下的 data 文件夹，Linux 在 /var/log/mysqld.log 或 my.cnf 里指定位置。日志里若提示 “unknown variable”，去 my.ini 把对应项删掉或改成正确写法；提示 “Permission denied”，Linux 上把 data 目录属主改成 mysql 用户：

chown -R mysql:mysql /var/lib/mysql chmod 750 /var/lib/mysql

提示 pid 文件冲突，删掉旧 pid 文件再启动。这个排查顺序能解决 80% 的启动问题。

5.4 查询慢与锁等待：排序、事务与连接被长时间占用

现象：连接成功后，页面执行同样的查询在本地很快，在服务器上却要几十秒，甚至报 “Lock wait timeout exceeded”。原因：老项目里 SELECT 往往没有索引，ORDER BY 在大表上做 filesort；或者事务开启后忘记提交，行锁一直不释放，后续查询全部排队等待。解决：先用 SHOW PROCESSLIST 看有没有长时间 Sleep 的连接：

SHOW FULL PROCESSLIST;

如果有大量 Sleep 超过 10 秒的连接，说明代码里连接没有释放，需要检查 mysql_close 有没有被调用。锁等待要找到持锁事务，靠 PERFORMANCE_SCHEMA 里的 innodb_trx 表定位，然后把对应事务提交或回滚。排序慢则是在查询频繁的字段上补索引，老项目里最常缺的是 order_time 和 status 这类条件字段的组合索引。

5.5 更换 MySQL 小版本后功能变化：SQL 行为要重测

现象：把同一套项目从 MySQL 5.7 升到 8.0 后，原来好好的 SQL 突然报错或结果集顺序不对。原因：8.0 里排序规则默认变成 utf8mb4_0900_ai_ci，GROUP BY 行为更严格，隐式类型转换的规则也变了。解决：升级前先用 EXPLAIN 跑一遍项目里的关键查询，重点看 ORDER BY、GROUP BY、以及字符串和数字比较的字段。比如老代码里常见的 WHERE phone = 13800000000，phone 是 varchar，MySQL 8 会直接报或走全表扫描，需要在 SQL 里改写为 WHERE phone = '13800000000'。这类问题靠测试兜底，别指望升级后一条 SQL 都不改。

6. 收尾技巧：把 mysql_connect 项目平滑升级到 PDO/MySQLi

既然 mysql_connect 已经进了历史垃圾桶，那这个标题的项目最后一步必然是迁移。迁移前先把整个目录备份，数据库导出一份，然后按我给的下面这张对应关系改。

<?php // 旧: $conn = mysql_connect($host, $user, $pass); // 新: $pdo = new PDO("mysql:host=$host;dbname=$dbname;charset=utf8mb4", $user, $pass); // 旧: mysql_select_db($dbname, $conn); // 新: 已包含在 DSN 的 dbname 参数里，无需单独调用 // 旧: mysql_query($sql, $conn); // 新: $stmt = $pdo->query($sql); // 旧: mysql_fetch_assoc($result); // 新: $row = $stmt->fetch(PDO::FETCH_ASSOC); // 旧: mysql_num_rows($result); // 新: $count = $stmt->rowCount(); // 旧: mysql_error(); // 新: $pdo->errorInfo(); ?>

迁移后验证不能只验证连接成功，要把建库脚本里所有表的增删改查各跑一遍。我的习惯是写一个临时 verify.php，里面按顺序测 SELECT、INSERT、UPDATE、DELETE 四条语句，再专门插入一条带中文和 emoji 的数据读出来对比，确认字符集没丢。事务类场景也要测：开启事务、插入一条数据、回滚，然后查库确认这条数据不存在，这一步能提前暴露 MySQL 8 行为差异带来的问题。

迁移时最容易翻车的是连接对象作用域。mysql_connect 时代很多人把 $conn 当全局变量在各函数里用，PDO 迁移后如果在每个函数里 re-new 一个 PDO，连接数会被瞬间打满，直接报 “Too many connections”。我把整个迁移的底线定为：全局只创建一次 PDO，后续页面通过参数传递或单例获取。这个习惯也救了我后来的项目，只要你还在做 MySQL 连接的活，尽早把连接收敛到一处，就不会再遇到连接泄漏的问题。希望帮到你。

本文还有配套的精品资源，点击获取