PHP数据库连接失败主因是参数配置错误，需正确设置host（数据库地址）、port（端口）、dbname（库名）、user/password（认证凭证）及charset/collation（字符集与排序规则）。
如果您在PHP项目中需要与数据库进行交互，但无法成功建立连接，则可能是由于数据库连接参数配置不正确。以下是配置PHP数据库连接的详细步骤及各参数含义说明：
一、设置数据库主机地址（host）
host参数指定数据库服务器所在的地址，可以是本地回环地址、局域网IP或远程域名。该参数直接影响PHP能否定位到数据库服务进程。
1、若数据库与PHP应用部署在同一台服务器上，使用localhost或127.0.0.1。
2、若数据库位于其他机器，填写对应服务器的IPv4地址，例如192.168.1.100。
立即学习“PHP免费学习笔记（深入）”；
3、若使用Docker容器化部署，需填写容器内可解析的服务名，如mysql-db。
二、指定数据库端口号（port）
port参数定义数据库监听的TCP端口，默认值因数据库类型而异。显式声明端口可避免因默认端口变更导致的连接失败。
1、MySQL/MariaDB默认端口为3306，连接时可省略，但建议显式写出以增强可读性。
2、PostgreSQL默认端口为5432，必须确保该端口未被防火墙拦截。
3、SQL Server默认端口为1433，使用PDO_SQLSRV扩展时需确认端口开放状态。
三、填写数据库名称（dbname）
dbname参数用于指定PHP连接后将操作的具体数据库实例。该名称必须已在数据库服务器中预先创建，且当前用户具备访问权限。
1、通过phpMyAdmin或MySQL命令行执行CREATE DATABASE myapp CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;创建库。
2、在连接字符串中填入已创建的库名，如myapp，不可拼写错误或包含空格。
3、若应用需动态切换数据库，应在连接后使用USE database_name语句切换上下文。
四、配置数据库用户名与密码（user / password）
user和password参数共同构成数据库身份认证凭证。二者需与数据库服务器中授权账户完全一致，区分大小写且不可为空（除非服务器明确允许空密码登录）。
1、创建专用账户：在MySQL中执行CREATE USER 'webuser'@'%' IDENTIFIED BY 'StrongPass123!';。
2、授予权限：运行GRANT SELECT, INSERT, UPDATE ON myapp.* TO 'webuser'@'%';限制最小必要权限。
3、在PHP配置中使用该账户，避免硬编码明文密码，应通过环境变量加载：getenv('DB_PASSWORD')。
五、选择字符集与排序规则（charset / collation）
charset参数确保PHP与数据库之间传输的数据编码一致，防止中文乱码或特殊符号异常。collation影响字符串比较和排序行为，需与表结构定义匹配。
1、推荐统一使用utf8mb4字符集，支持完整Unicode（含Emoji）。
2、连接时通过DSN添加参数：charset=utf8mb4，例如PDO连接字符串末尾追加&charset=utf8mb4。
3、验证连接后执行查询：SET NAMES utf8mb4 COLLATE utf8mb4_unicode_ci;确保会话级生效。
