0

0

PHP中include和require区别_文件包含语句对比【详解】

雪夜

雪夜

发布时间:2026-03-12 19:36:02

|

347人浏览过

|

来源于php中文网

原创

php中include和require区别_文件包含语句对比【详解】

require 会中断脚本,include 只发警告

这是最直接的后果差异:当目标文件不存在或语法错误时,require 触发 Fatal error,整个 PHP 进程立刻终止;而 includeWarning,后续代码照常执行。

典型场景比如加载配置文件:require 'config.php' 更安全——如果连数据库连接参数都读不到,后面逻辑根本没意义;但加载一个可选的统计埋点脚本,用 include 'tracker.php' 更合理,挂了也不影响主流程。

  • 错误信息示例:Fatal error: require(): Failed opening required 'missing.php'require) vs Warning: include(missing.php): failed to open streaminclude
  • require_onceinclude_once 也遵循同样中断/警告逻辑,只是多了一层“是否已加载过”的判断
  • 别指望靠 @include 完全吞掉错误——它只压制 warning,但若文件里有 parse error(如语法错),依然会报 fatal,且无法被 @ 捕获

require 和 include 都不是函数,是语言结构

它们没有返回值(严格说,include 有,require 没有),也不能像函数那样被变量赋值或传参调用。写成 $f = include 'a.php' 是合法的(include 返回文件最后一行表达式的值),但 $f = require 'a.php' 会直接报错。

常见误用是套括号:require('file.php') 看起来像函数调用,其实括号只是分组作用,和 require 'file.php' 完全等价。PHP 解析器根本不把它当函数看。

立即学习PHP免费学习笔记(深入)”;

  • 不能用在条件表达式右侧做“短路”判断:if (include 'auth.php') { ... } 可能执行,但语义混乱,不推荐
  • 路径解析行为一致:都基于当前执行文件的位置(__DIR__),不是包含文件自身的位置
  • 它们都不受 auto_prepend_fileauto_append_file 影响——这些 ini 设置只对主入口文件生效

include_once / require_once 的“已加载”判定很粗糙

PHP 判定“是否已包含过”,只比对传入的字符串路径(经过 realpath 展开后),而不是文件内容或 inode。这意味着:

腾讯交互翻译
腾讯交互翻译

腾讯AI Lab发布的一款AI辅助翻译产品

下载
  • 同一文件用相对路径和绝对路径各引一次,会被算作两次——require_once 'config.php'require_once __DIR__ . '/config.php' 会重复加载
  • 软链接指向同一文件,但路径不同,也会被当成两个文件处理
  • 不会检测文件是否被修改过,改了内容也不会重新加载(适合部署后静态环境,不适合开发中热更)

所以线上环境用 _once 版本防重复包含没问题;但开发时如果依赖自动重载,得关掉 opcode 缓存(opcache.enable=0)或手动 clear OPCache,否则改了文件也看不到效果。

性能差异几乎可以忽略,但路径写法影响真实开销

单纯比较 requireinclude 的执行速度,差几个纳秒,毫无实际意义。真正拖慢的是路径解析过程:每次调用都要做文件系统查找、权限检查、realpath 展开。

如果你写成 include '../lib/utils.php',PHP 就得从当前目录一层层往上找;而用 include __DIR__ . '/../lib/utils.php',路径是确定的字符串拼接,跳过大量 fs 操作。

  • 所有包含语句最好都用 __DIR__dirname(__FILE__) 开头,避免相对路径歧义
  • 不要在循环里动态拼路径并 include——每次都会触发完整文件查找,哪怕内容一样
  • OPcache 启用后,require/include 的字节码会被缓存,但首次加载仍要走磁盘;_once 版本在 opcache 中也有额外哈希表查询开销,不过仍是微乎其微

路径写得随意,比选 require 还是 include 对性能的影响大得多。

相关文章

PHP速学教程(入门到精通)
PHP速学教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

WorkBuddy
WorkBuddy

腾讯云推出的AI原生桌面智能体工作台

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
if什么意思
if什么意思

if的意思是“如果”的条件。它是一个用于引导条件语句的关键词,用于根据特定条件的真假情况来执行不同的代码块。本专题提供if什么意思的相关文章,供大家免费阅读。

847

2023.08.22

require的用法
require的用法

require的用法有引入模块、导入类或方法、执行特定任务。想了解更多require的相关内容,可以阅读本专题下面的文章。

510

2023.11.27

scripterror怎么解决
scripterror怎么解决

scripterror的解决办法有检查语法、文件路径、检查网络连接、浏览器兼容性、使用try-catch语句、使用开发者工具进行调试、更新浏览器和JavaScript库或寻求专业帮助等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

492

2023.10.18

500error怎么解决
500error怎么解决

500error的解决办法有检查服务器日志、检查代码、检查服务器配置、更新软件版本、重新启动服务、调试代码和寻求帮助等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

382

2023.10.25

js 字符串转数组
js 字符串转数组

js字符串转数组的方法:1、使用“split()”方法;2、使用“Array.from()”方法;3、使用for循环遍历;4、使用“Array.split()”方法。本专题为大家提供js字符串转数组的相关的文章、下载、课程内容,供大家免费下载体验。

760

2023.08.03

js截取字符串的方法
js截取字符串的方法

js截取字符串的方法有substring()方法、substr()方法、slice()方法、split()方法和slice()方法。本专题为大家提供字符串相关的文章、下载、课程内容,供大家免费下载体验。

221

2023.09.04

java基础知识汇总
java基础知识汇总

java基础知识有Java的历史和特点、Java的开发环境、Java的基本数据类型、变量和常量、运算符和表达式、控制语句、数组和字符串等等知识点。想要知道更多关于java基础知识的朋友,请阅读本专题下面的的有关文章,欢迎大家来php中文网学习。

1566

2023.10.24

字符串介绍
字符串介绍

字符串是一种数据类型,它可以是任何文本,包括字母、数字、符号等。字符串可以由不同的字符组成,例如空格、标点符号、数字等。在编程中,字符串通常用引号括起来,如单引号、双引号或反引号。想了解更多字符串的相关内容,可以阅读本专题下面的文章。

649

2023.11.24

C# ASP.NET Core微服务架构与API网关实践
C# ASP.NET Core微服务架构与API网关实践

本专题围绕 C# 在现代后端架构中的微服务实践展开,系统讲解基于 ASP.NET Core 构建可扩展服务体系的核心方法。内容涵盖服务拆分策略、RESTful API 设计、服务间通信、API 网关统一入口管理以及服务治理机制。通过真实项目案例,帮助开发者掌握构建高可用微服务系统的关键技术,提高系统的可扩展性与维护效率。

76

2026.03.11

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
PHP课程
PHP课程

共137课时 | 13.4万人学习

JavaScript ES5基础线上课程教学
JavaScript ES5基础线上课程教学

共6课时 | 11.3万人学习

PHP新手语法线上课程教学
PHP新手语法线上课程教学

共13课时 | 1.0万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号