日常运维选 pkg install phpmyadmin，省事且依赖自动处理；需最新安全补丁或功能时应从 ports 编译；安装后需手动配置 Web 服务器、校准 MySQL socket 路径，并按最小权限原则设置目录组读执行权限。
phpMyAdmin 用 ports 还是 pkg？先看你的更新节奏
FreeBSD 的 phpMyAdmin 在 ports 和 pkg 里都存在，但二者维护策略不同：ports 版本通常滞后于上游（因为要等 port maintainer 提交更新），而 pkg 版本依赖 ports 构建，所以实际也滞后。如果你需要最新安全补丁或某个特定功能（比如支持 MySQL 8.4 的认证插件），别指望 pkg install phpmyadmin 能立刻给你——它大概率还是上个月编译的旧版。想快速跟进，得自己从 ports 编译，或者手动拉官方 tarball（但会失去 FreeBSD 配置集成）。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 日常运维选
pkg install phpmyadmin，省事、依赖自动处理、升级统一 - 遇到 CVE 或功能缺失，查 FreshPorts 看 ports 是否已更新；若已更新，就进
/usr/ports/databases/phpmyadmin手动make install clean - 别混用：装了 pkg 版再跑 ports make install，可能覆盖配置文件，
pkg check -s phpmyadmin会报不一致
安装后找不到 index.php？默认不启用 Apache 模块
FreeBSD 的 phpmyadmin pkg 安装完只是把文件丢到 /usr/local/www/phpMyAdmin，**不会自动配置 Apache 或 Nginx**。你访问 http://yourhost/phpmyadmin 404，不是装错了，是 Web 服务器根本没指向那个目录。
常见错误现象：
- Apache 返回 404，
error_log里有 “File does not exist” - Nginx 返回 403，因为没配
index.php或权限不足
实操建议（以 Apache 为例）：
- 确认已启用
mod_php：grep -q 'LoadModule php7_module' /usr/local/etc/apache24/httpd.conf，没有就加一行LoadModule php7_module libexec/apache24/libphp7.so - 在
httpd.conf或虚拟主机配置里加 alias：<Directory "/usr/local/www/phpMyAdmin"> AllowOverride All Require all granted </Directory> Alias /phpmyadmin "/usr/local/www/phpMyAdmin" - 别漏掉
Require all granted—— FreeBSD 默认 deny all，不加这句就是 403
登录报错 #2002：Can’t connect to local MySQL server？检查 socket 路径
mysqli_real_connect(): (HY000/2002): No such file or directory 这类错误，90% 不是 MySQL 没启，而是 phpMyAdmin 按默认路径找 socket，而 FreeBSD 上 mysql57-server 或 mysql80-server 的 socket 通常在 /var/run/mysql/mysql.sock，不是 Linux 常见的 /tmp/mysql.sock。
使用场景：
- MySQL 用 pkg 安装，默认 socket 路径写在
/usr/local/etc/my.cnf的[client]和[mysqld]段 - phpMyAdmin 的
config.inc.php里$cfg['Servers'][$i]['host']设为'localhost'时，PHP 会走 socket；设为'127.0.0.1'才走 TCP
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 查 MySQL 实际 socket：
mysql -u root -e "SHOW VARIABLES LIKE 'socket';" - 改 phpMyAdmin 的
/usr/local/www/phpMyAdmin/config.inc.php：$cfg['Servers'][$i]['host'] = '127.0.0.1'; // 改成 IP 强制走 TCP // 或保留 'localhost'，但显式指定 socket： $cfg['Servers'][$i]['socket'] = '/var/run/mysql/mysql.sock';
- 改完记得重启 web 服务：
service apache24 restart或service nginx restart
权限太松导致 403？FreeBSD 默认禁止用户 www 访问 /usr/local/www
FreeBSD 的 www 用户默认属于 www 组，但 /usr/local/www/phpMyAdmin 目录权限通常是 drwxr-xr-x root:wheel。如果没给 www 组读+执行权限，Apache/Nginx 就卡在目录遍历环节，连 index.php 都看不到。
容易踩的坑：
- 只改了
index.php权限，忘了父目录必须有x（执行）位才能 cd 进去 - 用
chown -R www:www /usr/local/www/phpMyAdmin—— 错！这会让 pkg 升级时冲突，且 PHP 脚本不该由 www 写
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 最小权限原则：
chmod -R g+rX /usr/local/www/phpMyAdmin（X只给目录和已有执行位的文件加 x） - 加组权限：
chgrp -R www /usr/local/www/phpMyAdmin - 别碰
config.inc.php的写权限 —— 如果你要保存设置，用cp config.sample.inc.php config.inc.php后chmod 644即可
