XAMPP部署MetInfo权限设置教程

MetInfo在XAMPP上部署失败，往往并非程序本身问题，而是被Apache权限配置“卡住”：htdocs目录所有权与Apache进程用户不一致、PHP临时上传和会话目录不可写、MySQL root密码或连接地址配置不当，以及XAMPP默认安全策略拦截admin/install路径——这四大权限陷阱只要逐一精准修复（如正确设置目录属主、显式配置可写tmp路径、调整httpd-xampp.conf授权规则并严格重启服务），90%的部署障碍即可迎刃而解。

MetInfo 在 XAMPP 上跑不起来，八成不是程序问题，而是权限卡在了三处：Apache 进程没权限读写 htdocs 目录、upload_tmp_dir 临时目录不可写、MySQL 用户没开远程访问（哪怕本地部署，MetInfo 安装向导也可能触发连接校验）。改完任意一处不重启服务，基本等于白改。

Apache 进程用户必须和 htdocs 所有者一致

Linux/macOS 下 XAMPP 默认以 daemon 用户运行 Apache，但 /opt/lampp/htdocs 所有者是 root，导致 MetInfo 安装时无法创建缓存、写入配置文件、上传 logo 等。

• 先查当前 Apache 用户：ps aux | grep -E "(httpd|apache)" | head -1，看 USER 列（常见为 daemon）
• 把 htdocs 所有者改成该用户：sudo chown -R daemon:daemon /opt/lampp/htdocs
• 别用 777 —— MetInfo 的 install/ 和 cache/ 目录需要写权限，但开放全目录 777 会触发安全拦截（XAMPP 自带的 httpd-xampp.conf 会直接 403）
• Windows 不用改所有者，但要确保 C:\xampp\htdocs 目录对 NT AUTHORITY\SYSTEM 可写（用 icacls 授权，不是右键属性点几下就行）

upload_tmp_dir 和 session.save_path 必须可写且路径明确

MetInfo 上传模板、附件、后台图片时，PHP 会先存到 upload_tmp_dir，再 move 到目标位置。如果该目录不存在或 Apache 进程无权写入，就会报 move_uploaded_file(): Unable to move 或静默失败（页面卡在“正在上传”）。

• 打开 php.ini（C:\xampp\php\php.ini 或 /opt/lampp/etc/php.ini），确认以下两行未被注释且路径存在：
• upload_tmp_dir = "C:\xampp\tmp"（Windows，双引号不能少）
• session.save_path = "C:\xampp\tmp"
• Linux 下建议设为 /opt/lampp/temp，然后执行：sudo mkdir -p /opt/lampp/temp && sudo chown daemon:daemon /opt/lampp/temp && sudo chmod 700 /opt/lampp/temp
• 改完必须重启 Apache，仅重载配置无效

MySQL root@localhost 密码为空会导致 MetInfo 安装卡在数据库连接

MetInfo 安装向导默认填 root + 空密码连 MySQL，但 XAMPP 新版（尤其 Linux/macOS）可能已强制要求设密码，或 MySQL 绑定在 127.0.0.1 而非 localhost，导致 socket 连接失败。

• 先用命令行验证能否连：/opt/lampp/bin/mysql -u root -p（Linux/macOS）或 mysql -u root -p（Windows 命令行，进入 C:\xampp\mysql\bin）
• 如果提示 Access denied，说明密码不为空 —— 别猜，直接进 phpMyAdmin（http://localhost/phpmyadmin）改 mysql.user 表里 'root'@'localhost' 的 authentication_string
• 如果连得上但 MetInfo 报 Connection refused，检查 my.cnf 里 bind-address 是否为 127.0.0.1；MetInfo 有时用 TCP 连而非 socket，需确保该地址可通
• 别动 'root'@'%' —— MetInfo 不需要远程访问，开了反而增加风险

httpd-xampp.conf 的 403 拦截常被忽略

MetInfo 安装完首页能打开，但点“后台登录”或“安装向导”就 403，大概率是 XAMPP 自带的安全策略在起作用，它默认只放行 127.0.0.1 访问 /phpmyadmin、/security、/xampp 等路径，而 MetInfo 的 admin/ 或 install/ 目录被一并拦了。

• 编辑 /opt/lampp/etc/extra/httpd-xampp.conf（Linux/macOS）或 C:\xampp\apache\conf\extra\httpd-xampp.conf（Windows）
• 找到类似 的区块，在其内部把 Require local 改成 Require all granted
• 如果 MetInfo 后台在 /admin，还要加一段针对该路径的授权： Require all granted
• 改完必须重启 Apache，否则配置不加载

MetInfo 对权限敏感的地方不止这些：比如 config/config_db.php 是安装后生成的，如果 Apache 没权限写入，整个流程就断在最后一步；又比如 cache/ 目录若不可写，后台操作会极慢甚至超时。与其反复试错，不如一开始就按进程用户统一所有权、显式声明 tmp 路径、关掉冗余安全拦截——这三件事做完，90% 的“部署失败”就消失了。

以上就是《XAMPP部署MetInfo权限设置教程》的详细内容，更多关于XAMPP的资料请关注golang学习网公众号！