每个拥有数据库的 KapsuleHost 网站都可以通过 phpMyAdmin 获得基于浏览器的数据库访问权限,该访问通过单点登录打开,因此无需保留第二个密码。本指南将介绍如何打开它、如何查看连接详情、哪些操作值得在其中进行,以及在 WordPress 网站上绝不应在 phpMyAdmin 中执行的两项数据库操作。
打开 phpMyAdmin
- 登录 KPanel,点击左侧边栏中的网站。
- 点击您的网站。
- 在该网站自己的菜单中,打开数据库。
- 点击打开 phpMyAdmin。
phpMyAdmin 会在新标签页中打开,已自动登录并指向您网站的数据库。无需登录表单,也无需存储单独的凭据。
如果页面显示未为此网站类型配置数据库,这属于正常情况。静态 HTML 网站和某些应用类型在创建时本来就没有数据库。使用数据库的网站类型,包括 WordPress 和 WooCommerce,则始终配有数据库。
您的连接详情
同一屏幕会显示您应用程序所使用的凭据,每项都带有复制按钮,密码则隐藏在显示控件之后:
| 字段 | 值 |
|---|---|
| 主机 | 127.0.0.1 |
| 端口 | 3306 |
| 数据库 | 您的数据库名称 |
| 用户名 | 您的数据库用户 |
| 密码 | 点击显示之前为隐藏状态 |
这些就是应填入 wp-config.php、.env 文件或任何框架的数据库配置中的值。
127.0.0.1 的意思是“本服务器”。它无法从您的笔记本电脑访问,无论如何配置防火墙都无法改变这一点:按照设计,该数据库根本不会监听公网地址。若要用 TablePlus 或 Sequel Ace 等桌面客户端连接,请通过 SSH 建立隧道。请参阅通过 SSH 隧道连接您的数据库。
使用场景
phpMyAdmin 在以下这些特定工作中确实有其用武之地:
- 读取数据。确认某个插件实际存储了什么内容,检查某行记录是否存在,统计记录数量。
- 在迁移或恢复过程中导入数据库。
- 导出数据库,作为额外的安全副本,或交给开发人员使用。
- 修复单个损坏的值,例如被错误输入、导致您无法登录 wp-admin 的
siteurl。 - 诊断体积问题。按大小对表排序,可以立即看出日志表或临时数据表是否已经失控增长。
导入数据库
- 从数据库标签页打开 phpMyAdmin。
- 在左侧面板中点击您的数据库名称。
- 点击顶部的导入。
- 选择
.sql文件,然后点击执行。
导入操作会替换匹配的表,而不是合并数据。
在正在使用的数据库上执行导入具有破坏性且立即生效。匹配表中的每一行都会被文件中的内容替换,且 phpMyAdmin 内部没有撤销功能。请先在网站的备份页面中进行备份:创建备份。
对于较大的转储文件,请先压缩为 .sql.gz,phpMyAdmin 支持该格式,通常也能将文件大小压缩到上传限制以下。如果文件仍然过大,可按表拆分为多个文件,或提交工单,由我们在服务器端为您完成导入。
导出数据库
- 在左侧面板中点击您的数据库名称。
- 点击导出。
- 若需直接复制,选择 Quick 并采用 SQL 格式即可。如果需要特定的表,或希望输出经过 gzip 压缩,请选择 Custom。
- 点击执行。
phpMyAdmin 导出的文件是一份有用的额外副本,而非备份策略。它仅捕获数据库本身,不包含您的文件,且保存在您所选择的位置。您的网站每天都会自动将两者一起备份,您也可以随时手动创建备份:创建备份。
这两件事请勿在此操作
请勿使用 SQL 执行搜索和替换
WordPress 将插件和主题设置存储为 PHP 序列化字符串,其中记录了每个值的长度。REPLACE() 查询会改变文本内容却不会更新所记录的长度,导致 PHP 无法再读取该选项,并悄悄将其还原为空。于是主题设置消失、滑块内容清空、许可证被注销。
请使用网站 WordPress 标签页中的搜索和替换卡片,它能正确处理序列化问题,并会先创建备份。完整说明请参阅:执行搜索和替换。
请勿通过编辑 wp_users 来重置密码
较旧的教程会让您在 phpMyAdmin 下拉菜单中使用 MD5 函数来设置 user_pass。现代 WordPress 不再使用 MD5 哈希,一旦操作有误,账户将被锁定而不是被重置。
KPanel 在网站的 WordPress 标签页下的用户部分提供了专门的工具:可直接使用以此身份登录登录、发送重置邮件,或复制重置链接自行发送。请参阅重置丢失的 WordPress 管理员密码。
KPanel 中的 WordPress 数据库工具
对于日常的 WordPress 数据库操作,WordPress 标签页下的数据库部分比 phpMyAdmin 更安全、更快捷。它可以让您一目了然地查看表大小,在自动先创建备份的前提下进行优化和修复,将旧表转换为现代存储引擎,还能一键清理文章修订版本、自动草稿、过期的临时数据以及已放入回收站的文章。搜索和替换功能则位于相邻的快速操作部分。
需要查看原始数据行时,请使用 phpMyAdmin。需要修改内容时,请使用数据库部分。
疑难排解
phpMyAdmin 无法打开。该按钮需要对网站具有写入权限。如果您的 KapsuleHost 账户角色为只读,请联系账户所有者。如果您拥有写入权限但仍然失败,该网站可能仍在配置中:请查看网站顶部的状态指示标签。
我无法用数据库标签页上的信息从笔记本电脑连接。这是正确且刻意为之的设计。该数据库不会对外公开暴露。请使用 SSH 隧道:通过 SSH 隧道连接您的数据库。
导入过程中止且没有报错。几乎总是文件大小的问题。请将其压缩为 gzip 格式或进行拆分。
我修改了一个值,结果网站出错了。请从最近的备份中恢复:从备份中恢复。这正是为何务必先创建备份的原因。
数据表体积变得异常庞大。在 phpMyAdmin 中按大小排序以找出问题所在,然后从 WordPress 标签页的数据库部分进行清理,而不要手动删除数据行。