phpmyadmin安装教程

phpMyAdmin 是安装管理 MySQL 数据库最常用的网页工具。很多人卡在安装上，教程其实坑就那几个。安装我装过不下二十次，教程把最容易出错的安装地方直接标出来。

先去官网下载。教程别去第三方网站，安装那些捆绑了乱七八糟的教程东西。phpMyAdmin 官网提供 zip 和 tar.gz 两种压缩包，安装Windows 用户下 zip，教程Linux 用户随意。安装下载后解压，教程把文件夹重命名成你记得住的安装名字，比如 phpmyadmin，教程然后放进你的安装网站根目录。用 XAMPP 的话就是 C:\xampp\htdocs\phpmyadmin，用 LAMP 就是 /var/www/html/phpmyadmin。

解压完别急着打开浏览器。先得改配置文件。phpMyAdmin 解压后有个 config.sample.inc.php 文件，复制一份，重命名为 config.inc.php。用文本编辑器打开这个新文件，找到 $cfg['blowfish_secret'] 这一行，里面是空的，随便填一串字符，至少 32 位。这一步是加密 cookie 用的，不填会报错。我见过有人跳过这步，结果页面一片红字。

接下来是连接数据库的设置。大多数情况下默认配置就能用，因为 phpMyAdmin 默认通过 localhost 连接 MySQL。但如果你改了 MySQL 端口，或者数据库跑在远程服务器上，就得改 $cfg['servers'][$i]['host'] 和 $cfg['servers'][$i]['port']。这里有个细节容易忽略——MySQL 8.0 以上版本默认用 caching_sha2_password 认证插件，而老版本 phpMyAdmin 不兼容。如果你用的 MySQL 是 8.0+，务必下载 phpMyAdmin 5.2 以上版本，否则登录会直接报 "mysqli::real_connect(): The server requested authentication method unknown" 错误。

文件权限也常出问题。config.inc.php 如果权限太松，phpMyAdmin 会警告你，但不影响使用。真正要命的是 tmp 目录。phpMyAdmin 需要临时目录存放导出文件，默认是 ./tmp。你需要在 phpMyAdmin 根目录下手动创建一个 tmp 文件夹，并确保 Web 服务器有写权限。Linux 下执行 chmod 755 tmp，Windows 下基本不用管。

现在打开浏览器，输入 http://localhost/phpmyadmin。如果看到登录界面，说明安装成功了一半。用 MySQL 的 root 账号登录——默认密码为空，直接回车就能进。但强烈建议你给 root 设置密码，否则等于裸奔。设置完密码后，记得在 config.inc.php 里把 $cfg['Servers'][$i]['auth_type'] 改成 'cookie'，这样每次登录都要输密码，而不是写死在配置文件里。

最后说个大多数人不知道的坑。如果你用的是 Nginx 而不是 Apache，可能会遇到 404 错误。因为 phpMyAdmin 依赖 .htaccess 做重写，Nginx 不认这个。解决办法是在 Nginx 配置里加一段 location 规则，指向 phpMyAdmin 的实际路径。具体写法网上搜 "nginx phpmyadmin location"，照着抄就行。这个问题当年困扰了我一整个下午，最后发现是伪静态没开。

装完之后测试一下：登录进去，随便点几个数据库，导出个表试试。如果一切正常，那就完事了。要是报错，看页面顶部的红色提示，八成是权限问题或者 PHP 扩展缺失——检查一下 php-mysql 扩展装了没，Debian/Ubuntu 下执行 sudo apt install php-mysql，CentOS 用 yum install php-mysqlnd。装完重启 Apache 或 PHP-FPM，基本都能解决。