mysql的create database语句不支持sql内联注释，必须将注释移至php代码层，用变量命名、php注释或外部元数据表等方式记录建库意图。
CREATE DATABASE 语句里不能加 SQL 注释
直接在 CREATE DATABASE 语句中写 -- 注释 或 /* 注释 */ 会报语法错误，MySQL 不允许在该语句末尾或中间插入注释。这不是 PHP 的限制，而是 MySQL 服务端解析规则决定的——CREATE DATABASE 是 DDL 语句，不支持语句级注释嵌入。
用 PHP 变量或注释说明代替 SQL 内联注释
真正能落地的做法是把注释放在 PHP 代码层，而不是塞进 SQL 字符串里：
- 用 PHP 单行注释
// 创建用户库，字符集 utf8mb4，用于存储前端注册数据紧挨着CREATE DATABASE执行前 - 把库名、字符集、排序规则等参数抽成变量，用变量名自带语义，比如：
$dbname = 'app_users'; $charset = 'utf8mb4'; $collation = 'utf8mb4_unicode_ci'; - 拼接 SQL 时保持简洁清晰：
"CREATE DATABASE `$dbname` CHARACTER SET $charset COLLATE $collation"，不掺杂任何注释符号
想“记录建库意图”？用单独的元数据表或外部文档
如果需要长期留存建库原因、负责人、时间、业务用途等信息，SQL 本身不是合适载体。更可靠的方式是：
- 在数据库里建一张
db_metadata表，INSERT 一条记录说明本次建库目的 - 把建库脚本保存为
create_db_app_users.php，文件名和 PHPDoc 注释已隐含上下文 - 配合部署工具（如 Ansible、Laravel Migrations）在任务描述字段写清楚用途，比 SQL 注释更易追踪
注意 mysqli 和 PDO 对空格与分号的敏感度
有些开发者尝试用换行+注释“模拟”可读性，比如：
立即学习“PHP免费学习笔记（深入）”；
CREATE DATABASE `mydb`<br>/* 生产环境主库 */<br>CHARACTER SET utf8mb4
这在部分客户端可能侥幸通过，但属于未定义行为。实际执行时：
-
mysqli::query()会严格按单条语句解析，遇到换行后非关键字直接报错 -
PDO::exec()同样不支持多行混合注释的 DDL - 即使成功，注释也不会被 MySQL 存储或返回，纯属客户端显示假象
真正要留痕，就得脱离 SQL 字符串本身——注释不在数据库里，而在你写的 PHP 文件、Git 提交信息、或运维文档里。
