方法	文件不存在时	已包含时	返回值
`include`	产生警告 (E_WARNING)	再次包含	成功返回1，失败返回false
`include_once`	产生警告 (E_WARNING)	不再包含	成功返回1，失败返回false
`require`	产生致命错误 (E_COMPILE_ERROR)	再次包含	成功返回1，失败返回false
`require_once`	产生致命错误 (E_COMPILE_ERROR)	不再包含	成功返回1，失败返回false

三、基本语法和示例

1.`include`语句

<?php // 包含文件 include 'header.php'; // 包含文件（括号可选） include('config.php'); // 包含并输出 echo include 'content.php'; // 包含文件并检查 if (include 'somefile.php') { echo "文件包含成功"; } ?>

2.`require`语句

<?php // 必须文件使用 require require 'database_config.php'; // 包含并检查 if (require 'essential.php') { // 文件存在且包含成功 } ?>

3.`_once`版本（避免重复包含）

<?php // 定义文件 constants.php define('SITE_NAME', '我的网站'); // 主文件 index.php include_once 'constants.php'; // 包含 include_once 'constants.php'; // 不会重复包含，避免重复定义错误 echo SITE_NAME; ?>

四、文件路径处理

1. 相对路径和绝对路径

<?php // 相对路径 include 'inc/header.php'; // 当前目录下的 inc 目录 include '../config.php'; // 上级目录 include './includes/func.php'; // 当前目录的 includes 目录 // 绝对路径 include __DIR__ . '/config.php'; // PHP 5.3+ include dirname(__FILE__) . '/config.php'; // PHP 5.2 // 使用文档根目录 include $_SERVER['DOCUMENT_ROOT'] . '/includes/config.php'; // 包含路径 set_include_path('/usr/lib/pear'); // 或修改 php.ini 中的 include_path // include_path = ".:/php/includes" ?>

2. 路径搜索顺序

<?php // 1. 首先查找相对路径 include 'header.php'; // 查找 ./header.php // 2. 如果没有，查找 include_path // php.ini: include_path = ".:/php/includes:/usr/share/php" // 3. 最后查找调用脚本所在目录 ?>

五、包含文件的高级用法

1. 包含文件返回值

<?php // config.php return [ 'db_host' => 'localhost', 'db_user' => 'root', 'db_pass' => 'password' ]; // index.php $config = include 'config.php'; echo $config['db_host']; // 输出: localhost ?>

2. 条件包含

<?php // 根据条件包含不同文件 $lang = 'zh_CN'; if ($lang == 'zh_CN') { include 'lang/chinese.php'; } elseif ($lang == 'en_US') { include 'lang/english.php'; } else { include 'lang/default.php'; } // 使用三元运算符 include file_exists('custom_header.php') ? 'custom_header.php' : 'default_header.php'; ?>

3. 包含文件中的变量作用域

<?php // main.php $title = "首页"; $color = "blue"; // 包含的文件可以访问当前作用域中的变量 include 'template.php'; // template.php echo "<h1 style='color: $color'>$title</h1>"; // 包含文件中的变量在主文件中也可用 $local_var = "只在template中"; // 包含后，$local_var 在 main.php 中可用 ?>

4. 函数中的包含

<?php function loadTemplate($template) { // 包含文件在函数内部，变量作用域仅限于函数 include "templates/$template.php"; } // 包含的文件不能直接访问函数外部变量 function renderPage($data) { extract($data); // 将数组键名转为变量 include 'template.php'; } $pageData = ['title' => '产品', 'content' => '...']; renderPage($pageData); ?>

六、实际应用示例

1. 网站模板系统

<?php // config.php define('SITE_NAME', '我的博客'); define('SITE_URL', 'https://example.com'); // db_config.php return [ 'host' => 'localhost', 'dbname' => 'myblog', 'username' => 'root', 'password' => '' ]; // header.php ?> <!DOCTYPE html> <html lang="zh-CN"> <head> <meta charset="UTF-8"> <title><?php echo SITE_NAME; ?> - <?php echo $page_title ?? '首页'; ?></title> <link rel="stylesheet" href="css/style.css"> </head> <body> <header> <h1><?php echo SITE_NAME; ?></h1> <nav> <a href="index.php">首页</a> <a href="about.php">关于</a> <a href="contact.php">联系</a> </nav> </header> <main> <?php // footer.php ?> </main> <footer> <p>&copy; <?php echo date('Y'); ?> <?php echo SITE_NAME; ?></p> </footer> </body> </html> <?php // index.php $page_title = "首页"; $db_config = include 'db_config.php'; // 包含头部 include 'header.php'; // 页面内容 ?> <h2>欢迎来到<?php echo SITE_NAME; ?></h2> <p>这里是首页内容...</p> <?php // 包含尾部 include 'footer.php'; ?>

2. 函数库包含

<?php // functions.php function connectDB() { $config = include 'db_config.php'; try { $pdo = new PDO( "mysql:host={$config['host']};dbname={$config['dbname']}", $config['username'], $config['password'] ); return $pdo; } catch (PDOException $e) { die("数据库连接失败: " . $e->getMessage()); } } function sanitize($data) { return htmlspecialchars(stripslashes(trim($data))); } // 页面中使用 require_once 'functions.php'; $pdo = connectDB(); ?>

3. 自动加载类

<?php // 自动加载类 spl_autoload_register(function ($class_name) { // 将命名空间转换为路径 $file = __DIR__ . '/classes/' . str_replace('\\', '/', $class_name) . '.php'; if (file_exists($file)) { require_once $file; } }); // 使用自动加载 $user = new User(); $product = new Product(); ?>

七、安全注意事项

1. 避免动态包含用户输入

<?php // 危险！不要这样做 $page = $_GET['page']; include $page . '.php'; // 攻击者可以包含任意文件 // 安全的做法 $allowed_pages = ['home', 'about', 'contact']; $page = $_GET['page'] ?? 'home'; if (in_array($page, $allowed_pages)) { include 'pages/' . $page . '.php'; } else { include 'pages/404.php'; } // 或使用白名单 switch ($_GET['page']) { case 'home': include 'pages/home.php'; break; case 'about': include 'pages/about.php'; break; default: include 'pages/home.php'; } ?>

2. 文件包含攻击防护

<?php // 配置 php.ini // open_basedir = /var/www/html // disable_functions = exec,system,passthru,shell_exec // 验证文件路径 function safe_include($file) { // 检查文件是否存在 if (!file_exists($file)) { throw new Exception("文件不存在: $file"); } // 检查文件是否在允许的目录 $allowed_dir = realpath(__DIR__ . '/includes/'); $file_path = realpath($file); if (strpos($file_path, $allowed_dir) !== 0) { throw new Exception("非法文件路径"); } // 检查文件扩展名 $ext = pathinfo($file, PATHINFO_EXTENSION); if ($ext !== 'php') { throw new Exception("只允许包含 PHP 文件"); } return include $file; } // 使用 try { safe_include('includes/header.php'); } catch (Exception $e) { error_log($e->getMessage()); include 'includes/error.php'; } ?>

八、性能优化

1. 使用`opcache`缓存

; php.ini 配置 opcache.enable=1 opcache.enable_cli=1 opcache.memory_consumption=128 opcache.interned_strings_buffer=8 opcache.max_accelerated_files=10000 opcache.revalidate_freq=2

2. 减少文件包含数量

<?php // 不推荐：包含太多小文件 include 'db.php'; include 'functions.php'; include 'config.php'; include 'auth.php'; include 'utils.php'; // 推荐：合并常用文件 require_once 'common.php'; // 包含上述所有常用功能 ?>

3. 使用`require_once`避免重复包含

<?php // 在大型项目中 require_once __DIR__ . '/vendor/autoload.php'; require_once __DIR__ . '/config/database.php'; require_once __DIR__ . '/lib/functions.php'; ?>

九、常见错误和调试

1. 错误处理

<?php // 设置错误处理 error_reporting(E_ALL); ini_set('display_errors', 1); // 包含文件时捕获错误 if (!@include 'missing_file.php') { echo "包含文件失败，使用默认值"; $config = ['default' => 'value']; } // 或使用 try-catch try { if (!file_exists('config.php')) { throw new Exception('配置文件不存在'); } require 'config.php'; } catch (Exception $e) { error_log($e->getMessage()); die('系统错误，请联系管理员'); } ?>

2. 调试技巧

<?php // 检查文件是否存在 $file = 'includes/header.php'; if (file_exists($file)) { include $file; } else { echo "警告: 文件 $file 不存在"; } // 获取包含路径 echo "包含路径: " . get_include_path(); // 添加包含路径 set_include_path(get_include_path() . PATH_SEPARATOR . '/custom/path'); // 检查是否已包含 if (!in_array(realpath('config.php'), get_included_files())) { include 'config.php'; } ?>

十、现代 PHP 开发实践

1. 使用 Composer 自动加载

<?php // composer.json { "autoload": { "psr-4": { "App\\": "src/" }, "files": [ "src/helpers.php" ] } } // index.php require 'vendor/autoload.php'; // 自动加载类 use App\Controllers\UserController; $controller = new UserController(); // 自动加载函数 some_helper_function(); ?>

2. 命名空间和自动加载

<?php // 传统方式 require_once 'classes/Database.php'; require_once 'classes/User.php'; require_once 'classes/Product.php'; // 现代方式 (PSR-4) spl_autoload_register(function ($class) { $prefix = 'MyApp\\'; $base_dir = __DIR__ . '/src/'; $len = strlen($prefix); if (strncmp($prefix, $class, $len) !== 0) { return; } $relative_class = substr($class, $len); $file = $base_dir . str_replace('\\', '/', $relative_class) . '.php'; if (file_exists($file)) { require $file; } }); // 使用 $user = new MyApp\Models\User(); ?>