許多開發者嘗試 include 'file.php?param=value' 來傳遞參數,但這在本地檔案包含中完全無效。本文解析原因、提供正確的參數傳遞模式、分析 allow_url_include 風險,並給出現代化的替代架構。
include 'a.php?x=1' 不工作?include/require 是檔案系統層面的操作,解析路徑並編譯執行?x=1 是 HTTP 協定概念,檔案系統不認得a.php?x=1 的實體檔案 (通常不存在)$_GET 只在 HTTP 請求時由 SAPI 自動填充,include 非 HTTP 請求<?php
// caller.php
$param = 'value';
$items = [1,2,3];
$config = ['debug' => true];
include __DIR__ . '/inc.php';
// inc.php 直接使用 $param, $items, $config
// 因為 include 在相同作用域執行,繼承所有區域變數
echo $param; // value
?>
<?php
// inc.php
function renderCard(array $data, string $template = 'default'): string {
// 業務邏輯
return "<div>{$data['title']}</div>";
}
// caller.php
require_once __DIR__ . '/inc.php';
echo renderCard(['title' => 'Hello'], 'compact');
<?php
// services/Renderer.php
class Renderer {
public static function card(array $data): string { ... }
}
// caller.php
echo Renderer::card(['title' => 'Hello']);
// 或依賴注入
$renderer = new Renderer($db, $cache);
echo $renderer->card($data);
<?php
// 模擬 $_GET 風格
$_GET['param'] = 'value'; // 汙染超全域,不推薦
include 'inc.php';
// 較好:區域陣列 + extract() (謹慎使用)
$params = ['param' => 'value', 'items' => [1,2,3]];
extract($params, EXTR_SKIP); // 不覆蓋現有變數
include 'inc.php';
; php.ini
allow_url_include = On ; 預設 Off,強烈建議保持 Off
// 此時可用
include 'https://example.com/inc.php?param=value';
include 發起 HTTP 請求,阻塞、延遲、無快取現代 PHP (8.0+) 已移除 allow_url_include 指令,此路徑徹底封死。
<?php
// 使用 Twig / Blade / Latte
$twig->render('card.html.twig', ['title' => 'Hello', 'items' => [1,2,3]]);
// 優點:沙箱隔離、繼承/區塊、自動逃逸、快取編譯、前後端分離
<?php
// Laravel Blade 風格
@component('components.card', ['title' => 'Hello'])
@slot('body')
Content here
@endslot
@endcomponent
// 原生 PHP 簡易實作
function view(string $path, array $data = []): string {
extract($data, EXTR_SKIP);
ob_start();
include __DIR__ . "/views/$path.php";
return ob_get_clean();
}
echo view('card', ['title' => 'Hello']);
<?php
$a = 1;
function test() {
// $a 在此不可見 (函數獨立作用域)
global $a; // 引入全域 (不推薦)
$GLOBALS['a']; // 另一種方式
}
include 'inc.php'; // 相同作用域,可見 $a
?>
| 包含方式 | 作用域 | 變數可見性 |
|---|---|---|
include / require | 當前區域作用域 | 繼承所有區域變數 |
函數內 include | 函數區域作用域 | 僅見函數區域變數 + global/$GLOBALS |
include_once / require_once | 同 include | 同 include,但僅載入一次 |
return 陳述式:$result = include 'calc.php'; 在 calc.php 中 return $a + $b;。但僅限非函數作用域,函數中 include 返回值為 include 成功與否。include 失敗發出 Warning 繼續執行;require 失敗拋出 Fatal Error 停止。建議統一用 require_once。extract($arr, EXTR_PREFIX_ALL, 'prefix') 加前綴。拒絕 include 'file.php?param=value'。正確路徑:
理解作用域機制,善用現代工具,才能寫出可維護、安全、高效的 PHP 代碼。