当前位置：首页 > news >正文

PHP 引入 PHP

news 2026/5/11 20:41:47

PHP 引入 PHP

在 PHP 开发中，我们几乎不会把所有代码写在一个文件里。将配置、函数、类、视图拆分到不同文件，通过 “引入” 机制组合使用，是实现代码复用、模块化开发的核心手段。

PHP 提供了四种常用的文件引入方式：include、require、include_once、require_once。

引入方式

`include`：包含并运行文件

include是最基础的引入方式，它会将指定文件的内容 “插入” 到当前位置并执行。

include'文件路径';// 或带括号（可选，风格问题）include('文件路径');

错误处理宽松：如果引入的文件不存在，会抛出一个警告（Warning），但脚本会继续执行。
可重复引入：同一个文件可以被引入多次。

假设我们有一个公共的页头文件header.php：

<!--header.php--><!DOCTYPEhtml><html><head><title>我的网站</title></head><body><header><nav><a href="/">首页</a>|<a href="/about">关于</a></nav></header>

在首页index.php中引入它：

<!--index.php--><?phpinclude'header.php';?><main><h1>欢迎来到首页</h1></main></body></html>

`require`：必须包含文件

require的功能与include几乎完全一致，核心区别在于错误处理。

require'文件路径';

错误处理严格：如果引入的文件不存在，会抛出一个致命错误（Fatal Error），脚本会立即停止执行。
可重复引入。

配置文件（如数据库配置）是 “必须存在” 的，用require更合适：

<?php// config.php（配置文件）return['db_host'=>'localhost','db_user'=>'root','db_pass'=>'your_password','db_name'=>'test_db'];

<?php// index.php// 用 require 引入配置文件（如果 config.php 丢了，程序直接停止，避免后续错误）$config=require__DIR__.'/config.php';// 使用配置echo"数据库主机：".$config['db_host'];

`include_once`/`require_once`：避免重复引入

如果引入的文件包含函数定义、类定义，重复引入会导致 “函数 / 类已定义” 的致命错误。

*_once系列会自动检测文件是否已被引入，只引入一次。

include_once'文件路径';require_once'文件路径';

继承include/require的错误处理特性。
自动去重：同一文件只引入一次，避免重复定义错误。

假设我们有一个函数库functions.php：

<?php// functions.phpfunctionformat_money($amount){return'¥'.number_format($amount,2);}

如果不用*_once，重复引入会报错：

<?php// 错误示范：不用 onceinclude'functions.php';include'functions.php';// 这里会报错：Fatal error: Cannot redeclare format_money()

使用include_once解决：

<?php// 正确示范：用 onceinclude_once'functions.php';include_once'functions.php';// 第二次引入会被自动忽略，不会报错echoformat_money(100);// 输出：¥100.00

关键区别对比表

方式	错误处理	重复引入	适用场景
`include`	警告，继续执行	允许	引入非必需的模板（如侧边栏）
`require`	致命错误，停止	允许	引入必需的核心文件（如配置）
`include_once`	警告，继续执行	禁止	引入函数库、类库（非必需）
`require_once`	致命错误，停止	禁止	引入函数库、类库（必需）

避坑重点：路径问题

引入文件时，路径写错是最常见的错误。

PHP 路径分为 “相对路径” 和 “绝对路径”，推荐永远使用绝对路径。

使用魔术常量__DIR__（当前文件所在的目录）构建绝对路径，无论在哪里调用都不会出错。

<?php// public/index.php// __DIR__ 是 "project/public"，拼接 "/../config.php" 得到绝对路径$config=require__DIR__.'/../config.php';include_once__DIR__.'/../functions.php';

实用开发场景

MVC 中的视图模块化

在简单的 MVC 架构中，我们通常把视图拆分成header、footer和主内容：

<?php// controller.php$pageTitle='文章列表';$articles=[/* 文章数据 */];// 引入头部require__DIR__.'/views/header.php';// 引入主内容视图require__DIR__.'/views/article_list.php';// 引入底部require__DIR__.'/views/footer.php';

自动加载类

如果类文件很多，一个个require_once太麻烦，可以使用spl_autoload_register()自动加载：

<?php// autoload.phpspl_autoload_register(function($className){// 假设类文件都在 src/ 目录下，类名与文件名对应$file=__DIR__.'/src/'.$className.'.php';if(file_exists($file)){require_once$file;}});// 使用时，直接 new 类，无需手动引入require__DIR__.'/autoload.php';$user=newUser();// 自动加载 src/User.php