FreeBSD Ports 安裝 PHP GD 擴充失敗：/usr/X11R6 非符號連結解決方案

錯誤訊息

/usr/X11R6 exists, but it is not a symlink. Installation cannot proceed.
This looks like an incompletely removed old version of X.
Please read /usr/ports/UPDATING (entry of 20070519) for the procedure to upgrade X.org related ports.
*** Error code 1
Stop in /usr/ports/x11/xorg-libraries.
*** Error code 1
Stop in /usr/ports/graphics/php4-gd.
*** Error code 1
Stop in /usr/ports/lang/php4-extensions.

原因分析

Ports 系統檢測到 /usr/X11R6 為實體目錄而非符號連結。新版 X.org (7.2+) 要求該路徑必須是指向新架構目錄的 symlink，殘留舊版 X11R6 目錄導致編譯中止。

解決方案

方法一：移除舊目錄（推薦，乾淨徹底）

rm -rf /usr/X11R6
# 重新執行 ports 安裝
cd /usr/ports/graphics/php4-gd
make install clean

方法二：編譯時排除 X11 相關支援（保留舊目錄，功能受限）

make WITHOUT_X11=yes install clean

此選項會跳過 GD 對 X11 字型/繪圖功能的依賴，適合純 CLI/Server 環境。

後續驗證

php -m | grep gd
# 應顯示 gd 模組已載入
php -r "phpinfo();" | grep -i "gd support"
# 應顯示 GD Support => enabled

避坑指南

• 升級 X.org 前請先閱讀 /usr/ports/UPDATING 相關條目（20070519 條目）。
• 使用 portmaster 或 portupgrade 等工具可自動處理相依與衝突。
• 定期 portsnap fetch update 同步 Ports 樹，減少版本落差。