萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

解決 PHP「Failed opening required」錯誤:Windows IIS 環境下的目錄權限與路徑配置指南

錯誤現場重現

Warning: require(../includes/init.php) [function.require]: failed to open stream: No such file or directory in C:\AppServ\www\index.php on line 22

Fatal error: require() [function.require]: Failed opening required '../includes/init.php' (include_path='.;C:\php5\pear') in C:\AppServ\www\index.php on line 22

環境:Windows Server 2003 + IIS 6 + PHP 5 + MySQL + phpMyAdmin。phpWind 論壇正常,但 ECShop 專案在網站根目錄報上述錯誤。

根因分析:目錄權限繼承與「工作目錄」誤區

錯誤的目錄結構與權限

D:\ (Administrators 權限)
└── Web\ (Administrators 權限)          ← 網站根目錄父層
    └── ecshop\ (Administrators 權限)   ← 專案根目錄(錯誤:缺少 IIS 執行身分權限)
        ├── Data\ (Administrators + IUSR_ECSHOP)
        └── Web\ (Administrators + IUSR_ECSHOP)  ← 實際 Web 根目錄

問題核心

  1. require('../includes/init.php') 使用相對路徑,基準是「目前執行腳本的目錄」(getcwd()),而非腳本檔案所在目錄
  2. IIS 執行身分(IUSR_ECSHOP 或 IWAM_...)在 ecshop\ 目錄沒有讀取/遍歷權限
  3. 導致 PHP 進程無法進入 ecshop\ 解析相對路徑,../includes 解析失敗

正確的權限架構

D:\ (Administrators)
└── Web\ (Administrators)
    └── ecshop\ (Administrators + IUSR_ECSHOP)  ← 關鍵:專案根目錄必須給 IIS 身分「讀取/執行/列出資料夾內容」
        ├── Data\ (繼承父權限即可)
        └── Web\ (繼承父權限即可)  ← IIS 網站根目錄指向這裡

操作步驟(Windows GUI)

  1. 右鍵 ecshop\ 目錄 → 內容 → 安全性 標籤
  2. 點擊 編輯 → 新增 → 輸入 IUSR_ECSHOP(或 IIS_IUSRS、NETWORK SERVICE,視 IIS 版本與應用程式池身分而定)
  3. 勾選權限:讀取和執行、列出資料夾內容、讀取
  4. 點擊 進階 → 勾選 將這些權限項目傳播給所有子物件(啟用繼承)
  5. 確認 Data\、Web\ 子目錄顯示「繼承自父項目」

ICACLS 指令列快速完成(管理員權限 CMD)

REM 假設網站根目錄為 D:\Web\ecshop,IIS 應用程式池身分為 IIS_IUSRS
icacls "D:\Web\ecshop" /grant "IIS_IUSRS:(OI)(CI)(RX)" /T
icacls "D:\Web\ecshop\Data" /grant "IIS_IUSRS:(OI)(CI)(M)" /T  REM 資料目錄需寫入
icacls "D:\Web\ecshop\Web" /grant "IIS_IUSRS:(OI)(CI)(RX)" /T
  • (OI)(CI):物件繼承 + 容器繼承(子檔案/子目錄皆繼承)
  • RX:讀取 + 執行/遍歷
  • M:修改(讀寫執行刪除)

路徑處理最佳實踐:拒絕相對路徑

權限修正後,建議從程式碼層面根除相對路徑隱患:

1. 定義專案根目錄常數(入口檔案最頂端)

<?php
// index.php 或 bootstrap.php
define('APP_ROOT', __DIR__); // 當前檔案所在目錄絕對路徑
define('INC_ROOT', APP_ROOT . '/includes');

2. 全專案統一使用絕對路徑

<?php
// 錯誤
require('../includes/init.php');

// 正確
require(INC_ROOT . '/init.php');
// 或
require_once __DIR__ . '/../includes/init.php'; // 相對於當前檔案,非工作目錄

3. 設定 include_path(補充方案)

<?php
// bootstrap.php
set_include_path(get_include_path() . PATH_SEPARATOR . INC_ROOT);
// 之後可直接 require 'init.php'; 但不建議過度依賴

IIS 6 / PHP 5 時代的特殊檢查項

  1. ISAPI vs CGI: PHP 以 ISAPI 模組執行時,進程身分為應用程式池身分;CGI 模式則為 IUSR_機器名。確認正確身分獲授權。
  2. FastCGI 模式(較新): 應用程式池「進階設定」→ 處理序模型 → 身分識別,確認是 ApplicationPoolIdentity 或自訂帳號,授權給該身分。
  3. PHP 設定: php.ini 中 open_basedir 若設定,必須包含專案目錄與上層目錄(../includes 會向上跳)。
  4. 文件根目錄: IIS 網站「主目錄」指向 D:\Web\ecshop\Web,而非 D:\Web\ecshop。

驗證腳本

<?php
// test_perms.php 放在專案根目錄
echo "當前工作目錄: " . getcwd() . "\n";
echo "腳本目錄: " . __DIR__ . "\n";
echo "include_path: " . get_include_path() . "\n";
echo "open_basedir: " . ini_get('open_basedir') . "\n";

$testFile = __DIR__ . '/includes/init.php';
echo "測試檔案: $testFile\n";
echo "檔案存在: " . (file_exists($testFile) ? '是' : '否') . "\n";
echo "可讀取: " . (is_readable($testFile) ? '是' : '否') . "\n";

@include $testFile;
echo "include 結果: " . ($GLOBALS['include_ok'] ?? '失敗') . "\n";

總結

Failed opening required 在 Windows IIS 環境 90% 是目錄權限繼承缺失導致 IIS 執行身分無法進入專案根目錄解析相對路徑。雙管齊下:

  1. 修權限: 專案根目錄授予 IIS 身分 RX 權限並啟用繼承
  2. 改程式: 棄用相對路徑,全面採用 __DIR__、常數定義的絕對路徑

修正後,ECShop、Magento、Laravel 等所有依賴相對路徑的專案都能在 IIS 上正常運行。

copyright © 萬盛學電腦網 all rights reserved