php如何包含另一个php文件？php文件包含include/require用法

使用include或require可包含文件，区别在于失败时include发出警告而脚本继续，require则抛出致命错误并终止；为避免重复包含，应使用include_once或require_once；路径推荐用__DIR__构建绝对路径以确保稳定性。

PHP通过

include

require

解决方案

在PHP中，要包含另一个PHP文件，我们主要使用

include

require

// 使用 include 包含文件
include 'path/to/your/file.php';

// 使用 require 包含文件
require 'path/to/your/another_file.php';

当PHP解析器遇到这些语句时，它会暂停当前文件的执行，转而去读取并执行被包含文件中的所有代码。一旦被包含文件执行完毕，PHP会继续执行当前文件中剩余的代码。这意味着被包含文件中的变量、函数、类等都将在当前文件中可用。

例如，如果你有一个

config.php

立即学习“PHP免费学习笔记（深入）”；

// config.php
<?php
$dbHost = 'localhost';
$dbUser = 'root';
$dbPass = 'password';
$dbName = 'my_database';
?>

然后，在你的

index.php

// index.php
<?php
require 'config.php'; // 包含配置文件

// 现在你可以在这里使用 $dbHost, $dbUser 等变量了
echo "数据库主机: " . $dbHost;
// ... 进行数据库连接等操作
?>

这种机制是构建任何复杂PHP应用的基础，它允许我们把代码拆分成小的、可管理的部分，比如头部、底部、功能模块、配置信息等，大大提高了代码的可维护性和复用性。

include

登录后复制

和

require

登录后复制

有什么核心区别，我该怎么选择？

这确实是初学者常问的问题，也是我在实际开发中需要反复考量的地方。

include

require

当使用

include

E_WARNING

<?php
echo "脚本开始执行。\n";
include 'non_existent_file.php'; // 文件不存在，会发出警告
echo "脚本继续执行到这里。\n"; // 这行会正常输出
?>

而

require

require

E_ERROR

<?php
echo "脚本开始执行。\n";
require 'non_existent_critical_file.php'; // 文件不存在，会抛出致命错误
echo "脚本继续执行到这里。\n"; // 这行不会被执行
?>

那么，我个人在选择时通常是这样考虑的：

• 对于核心、不可或缺的文件，我总是倾向于使用

  require

  登录后复制
  。 比如数据库连接配置、用户认证模块、关键的类定义文件等。如果这些文件缺失，整个应用程序就失去了运行的基础，那么直接终止脚本并显示错误信息反而是更好的做法，这能帮助我快速定位问题，而不是让应用在不稳定的状态下运行。
• 对于非核心、可有可无的组件，或者某些模板片段，

  include

  登录后复制
  可能更合适。 比如网站侧边栏的某个广告模块、某个可选的统计代码片段。即使这些文件丢失，网站的主体功能仍然可以正常工作，用户体验虽然受损，但不会导致整个网站崩溃。

不过，说实话，在现代应用开发中，我发现自己更多地在使用

require

require_once

require

include_once

登录后复制

和

require_once

登录后复制

是什么，它们解决了什么痛点？

include_once

require_once

include

require

想象一下，你有一个

functions.php

// functions.php
<?php
function greet($name) {
    return "Hello, " . $name . "!";
}
?>

如果你的

index.php

another_script.php

functions.php

another_script.php

index.php

TTS Free Online免费文本转语音

免费的文字生成语音网站，包含各种方言（东北话、陕西话、粤语、闽南语）

37

查看详情

// index.php
<?php
include 'functions.php'; // 第一次包含
include 'another_script.php'; // 假设这个脚本也包含了 functions.php
?>

// another_script.php
<?php
include 'functions.php'; // 第二次包含
?>

当

functions.php

greet

E_PARSE

_once

• include_once 'path/to/file.php';

  登录后复制
  ：如果文件不存在，发出

  E_WARNING

  登录后复制
  警告；如果文件已包含，则跳过；如果文件存在且未包含，则包含。

• require_once 'path/to/file.php';

  登录后复制
  ：如果文件不存在，抛出

  E_ERROR

  登录后复制
  致命错误；如果文件已包含，则跳过；如果文件存在且未包含，则包含。

在实际开发中，尤其是在使用自动加载器（Autoloader）不那么普遍的老项目或特定场景下，

require_once

require_once

_once

文件包含时，相对路径和绝对路径的写法有什么讲究？

文件包含时的路径问题，可以说是我在职业生涯中遇到过无数次，也困扰过无数同事的“小坑”。路径写错了，轻则文件找不到，重则应用逻辑混乱。这里面的讲究，确实值得深入聊聊。

首先，我们要理解PHP在处理包含路径时的基准点。这和我们直觉中的“当前文件所在目录”可能有些出入。

1. 相对路径（Relative Path）：

   • 例如：

     include 'config.php';

     登录后复制
     或

     include '../lib/functions.php';

     登录后复制
   • 关键点：PHP解析相对路径时，默认是相对于当前执行脚本的目录，而不是包含语句所在文件的目录。这听起来有点绕，我举个例子：
     • 假设你的项目结构是：

       /project/
       ├── index.php
       ├── includes/
       │   └── header.php
       └── lib/
           └── utils.php

       登录后复制
     • 如果你在

       index.php

       登录后复制
       中写

       include 'includes/header.php';

       登录后复制
       ，这很正常。
     • 但如果在

       header.php

       登录后复制
       中又写

       include '../lib/utils.php';

       登录后复制
       ，这里就可能出问题了。如果

       index.php

       登录后复制
       是入口文件，那么

       ../lib/utils.php

       登录后复制
       是相对于

       index.php

       登录后复制
       所在的

       /project/

       登录后复制
       目录，所以它会正确找到

       /project/lib/utils.php

       登录后复制
       。
     • 然而，如果另一个脚本，比如

       /project/admin/dashboard.php

       登录后复制
       也包含了

       header.php

       登录后复制
       ，那么

       header.php

       登录后复制
       中的

       ../lib/utils.php

       登录后复制
       就会相对于

       /project/admin/

       登录后复制
       去解析，试图找到

       /project/lib/utils.php

       登录后复制
       ，这仍然是正确的。
     • 真正的坑在于：如果

       header.php

       登录后复制
       自己被直接访问（这通常不推荐，但可能发生），或者被一个在不同深度的脚本包含，那么

       ../lib/utils.php

       登录后复制
       的解析结果就会因“当前执行脚本”的不同而不同，导致文件找不到。

2. 绝对路径（Absolute Path）：

   • 例如：

     include '/var/www/html/project/includes/header.php';

     登录后复制
   • 优点：明确，不会因执行脚本位置变化而改变。
   • 缺点：不灵活，如果项目部署在不同路径（比如开发环境和生产环境），需要修改代码。

为了解决相对路径的潜在混乱和绝对路径的硬编码问题，PHP提供了两个非常有用的魔术常量：

__DIR__

__FILE__

• __DIR__

  登录后复制
  ：包含当前文件（即包含

  __DIR__

  登录后复制
  这个常量的文件）的目录的绝对路径。

• __FILE__

  登录后复制
  ：包含当前文件（即包含

  __FILE__

  登录后复制
  这个常量的文件）的绝对路径和文件名。

我个人最推荐，也是我日常开发中几乎总是使用的模式，是结合

__DIR__

// 假设这是 /project/includes/header.php
<?php
// 无论 header.php 被哪个文件包含，它都能正确找到相对于它自己的 utils.php
// __DIR__ 在这里就是 /project/includes/
require_once __DIR__ . '/../lib/utils.php'; // 这样就能找到 /project/lib/utils.php

// 或者包含同目录下的文件
require_once __DIR__ . '/another_include_in_same_dir.php';
?>

这种写法的好处是，包含路径不再依赖于“入口脚本”的位置，而是依赖于“包含语句所在文件”的位置。这使得模块之间的引用关系变得清晰和稳定，无论你的

header.php

另一个常见的绝对路径构建方式是使用

$_SERVER['DOCUMENT_ROOT']

// 假设你的Web根目录是 /var/www/html，项目就在这里
require_once $_SERVER['DOCUMENT_ROOT'] . '/includes/header.php';

这种方式在Web应用中很常见，尤其是在Apache/Nginx配置了虚拟主机的情况下。但它也有局限性：只适用于通过Web服务器访问的PHP脚本，如果你的PHP脚本是通过CLI（命令行接口）运行的，

$_SERVER['DOCUMENT_ROOT']

总结一下我的经验：优先使用

__DIR__

以上就是php如何包含另一个php文件？php文件包含include/require用法的详细内容，更多请关注php中文网其它相关文章！