本文旨在探讨在 php 中引入文件（require 或 include）时如何有效传递参数。我们将分析直接在路径中附加查询字符串的常见误区，并介绍三种主要解决方案：利用变量作用域、通过 $_GET 数组模拟，以及推荐的函数或类封装方法，以实现更清晰、更可维护的代码结构。
在 PHP 开发中，当我们需要将一个文件的内容引入到另一个文件中时，通常会使用 require 或 include 语句。然而，初学者常遇到的一个问题是，尝试像 URL 查询字符串那样，在 require 或 include 的文件路径后直接附加参数，例如 require “./mypage.php?orient=$orientation&init=$initrow”。这种做法并不能将参数传递给被引入的文件，因为 require 语句处理的是文件系统路径，而非 http 请求。结果往往是被引入的文件中出现“undefined variable”的错误提示。
例如，以下代码尝试通过查询字符串传递参数，但会导致 mypage.php 中变量未定义的错误：
<?php function write_pdf($orientation, $initrow, $rowsperpage) { ob_start(); // 这种方式无法将参数传递给 mypage.php require "./mypage.php?orient=$orientation&init=$initrow&nrrows=$rowsperpage"; $html = ob_get_clean(); // ... 后续处理 } ?>
mypage.php 中会收到类似以下错误：
立即学习“PHP免费学习笔记（深入）”；
Notice: Undefined variable: orientation in C:wampwwwhtdocssitemypage.php on line 8 Notice: Undefined variable: initrow in C:wampwwwhtdocssitemypage.php on line 8 Notice: Undefined variable: rowsperpage in C:wampwwwhtdocssitemypage.php on line 8
要正确地向被引入的 PHP 文件传递数据，可以采用以下几种方法。
1. 利用变量作用域（推荐且最直接）
当一个 PHP 文件被 require 或 include 时，它的代码实际上是在引入它的那个文件的当前作用域中执行的。这意味着在 require 语句之前定义的任何变量，在被引入的文件中都是可以直接访问的。这是最简单、最常用的参数传递方式。
示例：
假设 write_pdf 函数定义了 $orientation, $initrow, $rowsperpage 三个变量。
<?php // 调用文件 (e.g., index.php 或某个函数内部) function write_pdf($orientation, $initrow, $rowsperpage) { ob_start(); // 在 require 之前定义或传入的变量，在 mypage.php 中可以直接访问 require "./mypage.php"; $html = ob_get_clean(); // ... 后续处理 } ?>
mypage.php 的内容可以直接使用这些变量：
<?php // mypage.php // 注意：这里不需要重新声明这些变量，它们已经在引入文件中定义了 echo "Orientation: " . $orientation . "<br>"; echo "Initial Row: " . $initrow . "<br>"; echo "Rows Per Page: " . $rowsperpage . "<br>"; // ... 使用这些变量生成内容 ?>
注意事项： 这种方法适用于被引入文件需要访问当前作用域中的特定变量，且这些变量的名称是固定的情况。它简单高效，但如果被引入文件逻辑复杂或需要高度解耦，可能不是最佳选择。
2. 通过 $_GET 数组模拟（不推荐用于内部文件引入）
虽然直接在 require 路径中添加查询字符串无效，但你可以在 require 语句执行前，手动向全局 $_GET 数组中添加键值对，从而模拟 $_GET 参数的效果。被引入的文件随后可以像处理普通 HTTP GET 请求一样，从 $_GET 数组中读取这些值。
示例：
<?php // 调用文件 function write_pdf($orientation, $initrow, $rowsperpage) { ob_start(); // 手动填充 $_GET 数组 $_GET['orient'] = $orientation; $_GET['init'] = $initrow; $_GET['nrrows'] = $rowsperpage; require './mypage.php'; // 此时 mypage.php 可以访问 $_GET 数组 // ... 后续处理 } ?>
mypage.php 的内容：
<?php // mypage.php $orientation = $_GET['orient'] ?? 'default_orient'; // 使用空合并运算符提供默认值 $initrow = $_GET['init'] ?? 0; $rowsperpage = $_GET['nrrows'] ?? 10; echo "Orientation from GET: " . $orientation . "<br>"; echo "Initial Row from GET: " . $initrow . "<br>"; echo "Rows Per Page from GET: " . $rowsperpage . "<br>"; // ... 使用这些变量生成内容 ?>
注意事项： 这种方法通常被认为是“不太优雅”的，因为它滥用了 $_GET 数组的用途。$_GET 专为处理 HTTP 请求参数而设计，将其用于内部文件间的参数传递可能会导致混淆，并使代码难以理解和维护。除非有特殊需求，否则不建议采用此方法。
3. 使用函数或类封装（推荐用于模块化和复用）
对于更复杂、更具模块化需求或需要高度复用的代码，最佳实践是将 require 的文件内容封装在一个函数或一个类中。这样，你可以通过函数参数或类方法参数明确地传递所需的数据。这种方式提供了清晰的接口，提高了代码的可读性和可维护性。
示例：
首先，将 mypage.php 的内容封装成一个函数：
<?php // mypage.php function generatePdfContent($orientation, $initrow, $rowsperpage) { ob_start(); // 在这里使用 $orientation, $initrow, $rowsperpage 生成 HTML 内容 echo "<h1>PDF Content</h1>"; echo "<p>Orientation: " . $orientation . "</p>"; echo "<p>Initial Row: " . $initrow . "</p>"; echo "<p>Rows Per Page: " . $rowsperpage . "</p>"; // ... 更多内容生成逻辑 return ob_get_clean(); } ?>
然后，在调用文件中引入 mypage.php 并调用其中的函数：
<?php // 调用文件 require_once "./mypage.php"; // 使用 require_once 避免重复引入函数定义 function write_pdf($orientation, $initrow, $rowsperpage) { // 调用封装的函数，并传递参数 $html = generatePdfContent($orientation, $initrow, $rowsperpage); $dompdf = new Dompdf(); $dompdf->loadHtml($html); // ... 后续处理 } // 示例调用 write_pdf('portrait', 1, 20); ?>
如果 mypage.php 的逻辑更复杂，或者需要管理状态，可以将其封装成一个类：
<?php // mypage_class.php class PdfContentGenerator { public function generate($orientation, $initrow, $rowsperpage) { ob_start(); echo "<h1>Class-based PDF Content</h1>"; echo "<p>Orientation: " . $orientation . "</p>"; echo "<p>Initial Row: " . $initrow . "</p>"; echo "<p>Rows Per Page: " . $rowsperpage . "</p>"; return ob_get_clean(); } } ?>
<?php // 调用文件 require_once "./mypage_class.php"; function write_pdf($orientation, $initrow, $rowsperpage) { $generator = new PdfContentGenerator(); $html = $generator->generate($orientation, $initrow, $rowsperpage); $dompdf = new Dompdf(); $dompdf->loadHtml($html); // ... 后续处理 } // 示例调用 write_pdf('landscape', 10, 50); ?>
总结：
在 PHP 中向被引入文件传递参数，应避免在 require 或 include 语句的文件路径后直接附加查询字符串。正确的做法是利用 PHP 的变量作用域特性，直接在引入前定义变量；或者，为了更好的模块化和可维护性，将被引入文件的逻辑封装成函数或类，并通过函数/方法参数明确地传递数据。选择哪种方法取决于你的具体需求和代码的复杂程度。对于简单的参数传递，利用变量作用域是最直接的；而对于需要高度复用和解耦的模块，函数或类封装则是更专业的选择。