$cfg['UploadDir']是phpMyAdmin导入页从服务器目录读取SQL文件的配置项，需路径存在、Web用户有读权限且在open_basedir范围内；设为相对路径如'upload'并确保目录权限和PHP限制匹配才生效。
phpMyAdmin 的 $cfg['UploadDir'] 是什么，为什么不能直接用
它只是个配置项，不是上传功能开关。设了 $cfg['uploaddir'] 后，phpmyadmin 才会在数据库导入页显示「从服务器上传目录选择文件」的下拉框——但前提是：路径必须存在、web 服务器用户（如 www-data）有读取权限、且路径在 phpmyadmin 进程能访问的范围内（不能是绝对路径却越出 open_basedir 限制）。
常见错误现象：
– 配置写对了，页面上没出现上传目录选项
– 选中文件后点击「执行」，报错 File not found 或 Access denied
– 导入按钮灰掉，或下拉菜单为空
- 路径必须是相对于 phpMyAdmin 安装目录的相对路径（比如
'upload'），或 Web 可访问的绝对路径（如/var/www/phpmyadmin/upload），但后者需确保不在 open_basedir 外 - 目录得手动创建，并
chown给 Web 用户（如sudo chown www-data:www-data /var/www/phpmyadmin/upload） - PHP 的
open_basedir如果启用了，必须包含该路径，否则即使权限对也会被拒绝读取 - Apache/Nginx 需允许对该目录的 GET 访问（phpMyAdmin 不走 HTTP 请求读文件，但部分旧版本或 SELinux 环境会检查）
怎么配 $cfg['UploadDir'] 才真正生效
别改错文件：修改的是 config.inc.php（在 phpMyAdmin 根目录），不是 libraries/config.default.php。加在 $cfg['Servers'][$i]['auth_type'] = 'cookie'; 之后任意位置即可。
实操建议：
- 先在 phpMyAdmin 根目录建子目录：
mkdir upload && chmod 755 upload - 在
config.inc.php中加一行：$cfg['UploadDir'] = 'upload';（注意末尾分号） - 如果想用全局路径（不推荐），写成：
$cfg['UploadDir'] = '/var/www/shared/sql_dumps';，然后确保该路径在php_admin_value open_basedir白名单里 - 改完重启 Web 服务（
sudo systemctl restart apache2或nginx），再清浏览器缓存——配置不热加载
导入时选不到文件？检查这三处硬性条件
即使配置正确，仍看不到下拉菜单里的文件，大概率卡在这三个地方：
立即学习“PHP免费学习笔记（深入）”；
- 目录里没有
.sql或.csv文件（phpMyAdmin 默认只列这些后缀；.gz和.zip需额外开启 zlib/zip 支持） - 文件权限不对：Web 用户必须对文件有
read权限（chmod 644 xxx.sql），仅目录可读不够 - SELinux 启用时，目录上下文可能被限制（CentOS/RHEL 常见）：
sudo semanage fcontext -a -t httpd_sys_rw_content_t "/var/www/phpmyadmin/upload(/.*)?"，再restorecon -Rv upload
典型错误信息：The uploaded file exceeds the upload_max_filesize directive in php.ini —— 这其实是 PHP 上传限制，和 $cfg['UploadDir'] 无关，别被误导。
为什么从 UploadDir 导入比浏览器上传更可靠
它绕过了 PHP 的 post_max_size 和 upload_max_filesize 限制，因为文件压根不走 HTTP POST，而是由 phpMyAdmin 直接 fopen() 本地路径读取。适合导大 SQL（几百 MB 级）。
- 但代价是：你得先通过其他方式（
scp、rsync、SFTP）把 SQL 文件丢到服务器那个目录里 - 不支持带密码的加密 ZIP；也不支持自动解压嵌套子目录——文件必须平铺在
UploadDir下 - MySQL 用户权限仍起作用：如果当前登录账号没权限写目标表，照样失败，和怎么导入无关
最易被忽略的一点：phpMyAdmin 的 $cfg['UploadDir'] 只影响「导入」页，不影响「导出」行为；而且它不会自动清理目录，旧 SQL 文件堆多了得自己定期删。
