MySQL数据库名长度上限为64字节,非PHP限制;utf8mb4下emoji或生僻汉字占4字节,最多16个;需过滤非法字符、强制小写、预留后缀余量,并注意权限、反引号包裹及云厂商额外限制。

MySQL 中 PHP 创建数据库时的库名长度上限是 64 个字符
这个限制来自 MySQL 服务端,不是 PHP 本身。PHP 的 mysqli_query() 或 PDO::exec() 只是把建库语句发给 MySQL,真正校验长度的是 MySQL 的 CREATE DATABASE 解析逻辑。
实操中要注意:
- 64 是字节数,不是 Unicode 字符数;如果用 utf8mb4 编码(推荐),一个 emoji 或生僻汉字占 4 字节,那最多只能放 16 个这样的字符
- MySQL 5.7+ 默认校验严格,超长会直接报错:
ERROR 1102 (42000): Incorrect database name - 库名不能以数字开头,也不能含斜杠
/、反斜杠\、控制字符或空格(即使没超长也会被拒)
PHP 动态拼接库名前必须做长度和字符过滤
很多人用用户输入(比如子域名、租户 ID)直接拼库名,容易触发越界或非法字符问题。
安全做法包括:
立即学习“PHP免费学习笔记(深入)”;
- 用
mb_strlen($name, 'utf8mb4')检查字符长度,而非strlen()(后者按字节算,对中文不准确) - 用正则过滤:只保留字母、数字、下划线、短横线 ——
preg_replace('/[^a-zA-Z0-9_-]/', '', $input) - 强制小写(MySQL 库名在 Linux 下区分大小写,Windows 不区分,统一小写可避免跨平台问题)
- 建议预留 5–10 字符余量,方便后期加环境后缀如
_prod、_test
PHP 使用 PDO 或 mysqli 创建数据库时的典型错误场景
常见失败不是因为长度超限,而是没处理好上下文:
- 连接用户没有
CREATE DATABASE权限 → 报错:ERROR 1044 (42000): Access denied for user - SQL 语句里库名没用反引号包裹,且含短横线(如
my-app)→ 必须写成`my-app`,否则解析失败 - 用
mysql_query()(已废弃)在 PHP 7+ 直接 fatal error,必须改用mysqli或PDO - 事务中执行
CREATE DATABASE会失败,MySQL 不允许 DDL 在事务内运行
不同 MySQL 版本对库名的实际兼容性差异
虽然文档说上限 64,但实际行为受版本和配置影响:
- MySQL 5.6 及更早:默认使用 latin1,64 字节 ≈ 64 ASCII 字符;但若设了 utf8mb4,仍受限于 64 字节总长
- MySQL 8.0+:引入角色权限模型,但库名长度规则未变;不过
information_schema表结构字段(如SCHEMATA.SCHEMA_NAME)仍是varchar(64),硬性约束 - Percona Server / MariaDB:完全兼容 MySQL 的 64 字节限制,无扩展
- 注意:有些云厂商(如阿里云 RDS)会在控制台额外限制为 32 或 48 字符,需查对应文档,不能只信本地测试结果
lower_case_table_names 这类参数——这些都可能让“理论上合法”的库名在上线后突然报错。











