PhpStorm 连接数据库失败主因是 JDBC 驱动未下载或连接参数错误；需通过“Download missing driver files”自动获取驱动，再核对 MySQL/PostgreSQL 的 URL、端口、权限及 host（localhost≠127.0.0.1）；连上后可查结构、注释、索引，但需手动刷新；SQL 执行受 Safe mode 保护，大结果集须限制行数；数据库变更不会自动同步至 PHP 类型提示，需借助插件或命令行工具生成注释。
怎么在 PhpStorm 里连上数据库
连不上，基本就卡死在第一步。不是插件没开，就是驱动或连接参数错了。
PhpStorm 自带 Database 工具窗口（View → Tool Windows → Database），但默认不自动启用 JDBC 驱动。点「+」→ Data Source → 选数据库类型（比如 MySQL 或 PostgreSQL）后，如果提示「No database drivers found」，就得手动下载驱动——点击右下角 Download missing driver files，它会自动拉取对应版本的 JDBC jar（别自己乱丢 jar 包，容易版本不匹配）。
常见错误现象：Connection refused、Access denied for user、Unknown database。这时候先确认：MySQL 是否在本地运行（mysql -u root -p 能进吗？）、端口是不是被改过（默认 3306，但 MAMP/MAMP Pro 可能是 8889）、用户名密码有没有权限访问目标库（localhost 和 127.0.0.1 在 MySQL 权限里是两个不同 host）。
- URL 格式必须写对，例如 MySQL 是
jdbc:mysql://localhost:3306/mydb?useSSL=false&serverTimezone=UTC，少一个&或参数名拼错（比如写成useSsl）都会连不上 - 如果用的是 Docker 或远程 DB，
localhost在 PhpStorm 里指的是你本机，不是容器内部；得填宿主机 IP 或配置好端口映射 - PostgreSQL 默认需要勾选
Use SSL吗？一般不用，除非服务器强制；但sslmode=prefer这种参数要写在 URL 里，不能只靠勾选项
怎么看表结构、字段注释和索引
连上之后，展开数据源节点，双击一张表就能看到结构页（Columns 标签）。但很多人不知道：字段注释（COMMENT）和索引详情（Indexes 标签）默认不显示全，得主动点开。
使用场景：查某个字段是不是 NOT NULL、有没有默认值、外键指向哪张表、联合索引顺序对不对——这些光看建表语句容易漏，图形界面点两下更直接。
立即学习“PHP免费学习笔记（深入）”；
注意兼容性影响：MySQL 8.0+ 的隐藏索引（INVISIBLE INDEX）在 PhpStorm 里会标灰显示，但老版本驱动可能直接不显示；PostgreSQL 的部分索引（WHERE 条件索引）也会显示不全，得切到 DDL 标签看原始语句。
- 右键表 →
Refresh才能同步服务端最新结构（改了字段类型或加了索引，不刷新看不到） -
Columns里点标题栏可排序，比如按PK列排，快速定位主键 - 字段类型显示为
varchar(255)是简化后的，真实定义要看DDL标签里的CREATE TABLE语句
怎么写 SQL 并安全执行
别直接在控制台狂敲 UPDATE 或 DELETE。PhpStorm 默认开启「Safe mode」，所有没有 WHERE 条件的修改语句都会被拦截，报错 Operation not allowed without WHERE clause。
这是保护机制，不是 bug。想关？可以，但不建议。真要批量操作，先写好 WHERE，再点右上角小锁图标临时解锁；或者把语句贴到 Console 里，用 Ctrl+Enter（Windows/Linux）或 Cmd+Enter（macOS）执行单条——它会弹确认框，显示预计影响行数（前提是语句能被预估，比如没用子查询或函数）。
性能影响：大结果集（比如 SELECT * 查百万行）会卡 UI。务必在 Query Console 设置里调低 Max rows to fetch（默认 500，改成 100 或 50 更稳妥）。
- 写 SQL 时支持语法高亮、字段名自动补全（基于当前连接的 schema）、
JOIN表别名也能推导 - 执行前按
Ctrl+Shift+Enter（macOS 是Cmd+Shift+Enter）可以格式化语句，避免手抖漏空格导致解析失败 - 执行结果页里右键某行 →
Copy Row是带字段名的 JSON/CSV，比手动拼INSERT快得多
为什么改了表结构，代码里没提示更新
PhpStorm 不会自动把数据库变更同步到 PHP 类型提示里。也就是说，你刚给 users 表加了个 is_verified 字段，Eloquent 模型或 Doctrine 实体里还是报「undefined property」——这不是 IDE 坏了，是它根本没这个映射逻辑。
能做的只有两件事：一是用插件（如 Laravel Idea）补全 Eloquent 属性，二是手动维护模型里的 $fillable 或注释块；数据库工具本身只管「查和改库」，不管「PHP 怎么理解它」。
容易被忽略的点：当你在 Database 工具里右键表 → Generate Persistence Code，它只能生成 Java/JPA 代码，对 PHP 完全无效。别点，点了也没反应。
真正省事的做法：用命令行工具（如 php artisan ide-helper:models）生成 PHPDoc 注释，再让 PhpStorm 读取那些注释——这才是打通数据库结构和代码提示的正路。
