必须检查php环境、web服务器和mysql权限三项依赖，安装时手动勾选apache2并选yes配置数据库，装完需新建mysql_native_password认证的专用用户，否则无法登录。
能直接用 apt 安装，但必须确认 php 环境已就绪、web 服务器已选对、mysql 用户权限已适配，否则装完也打不开登录页。
安装前必须检查的三个依赖项
APT 包不会自动拉起 Apache 或 PHP 运行时，它只负责把文件放进去。常见失败根源是这三项缺失：
-
apache2或nginx已安装并正在运行（systemctl is-active apache2返回active） -
php和至少php-mysql、php-mbstring已安装（php -m | grep -E "mysql|mbstring"应有输出） - MySQL/MariaDB 服务已启动，且 root 用户能用密码登录（
mysql -u root -p能进命令行）
安装时必须手动确认的两个关键选项
执行 sudo apt install phpmyadmin 后，终端会弹出交互式配置界面，跳过或误选会导致后续 404 或白屏：
- Web 服务器选择：用空格键勾选
apache2（不是lighttpd，也不是留空），再按 Tab 切到OK回车 - 数据库配置：选
Yes让dbconfig-common自动建库和用户；若选No，则需手动编辑/etc/phpmyadmin/config.inc.php填写$cfg['Servers'][$i]['host']和user/password
装完必须立即处理的 root 登录问题（Ubuntu 22.04+ / MariaDB 默认场景）
Ubuntu 22.04 及更新版本默认用 auth_socket 插件验证 MySQL root，而 phpMyAdmin 只认密码登录 —— 直接输 root 密码会提示 #1698 Cannot log in to the MySQL server：
- 不要尝试改
auth_socket，风险高；推荐新建专用用户：sudo mariadb进入后执行：CREATE USER 'pmaadmin'@'localhost' IDENTIFIED BY 'your_strong_password';GRANT ALL PRIVILEGES ON *.* TO 'pmaadmin'@'localhost' WITH GRANT OPTION;FLUSH PRIVILEGES; - 该用户比 root 更安全，且可限制访问来源（如只允
'pmaadmin'@'127.0.0.1'）
访问路径和常见 404 原因
APT 安装后默认路径是 /usr/share/phpmyadmin，但 Apache 不会自动映射到 /phpmyadmin —— 实际能否访问取决于是否启用符号链接或别名配置：
- Debian/Ubuntu 系统通常在安装时自动创建
/etc/apache2/conf-enabled/phpmyadmin.conf，若没生效，手动启用：sudo a2enconf phpmyadmin再sudo systemctl restart apache2 - 如果仍 404，检查是否存在软链：
ls -l /var/www/html/phpmyadmin；若无，补上：sudo ln -s /usr/share/phpmyadmin /var/www/html/phpmyadmin - 注意：Nginx 用户不能靠 APT 自动配置，必须手动加
location /phpmyadmin { alias /usr/share/phpmyadmin; }
最常被忽略的是 MySQL 用户认证方式与 phpMyAdmin 的不兼容，而不是安装步骤本身。装完打不开，先查 mariadb -u pmaadmin -p 能否连，再查 Apache 日志里有没有 PHP Fatal error: Uncaught mysqli_sql_exception 类报错。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
