{"id":450,"date":"2025-06-10T20:36:56","date_gmt":"2025-06-10T12:36:56","guid":{"rendered":"https:\/\/www.zhaozhao123.cn\/php\/php-application-manual\/jcyy\/450.html"},"modified":"2025-06-10T20:36:56","modified_gmt":"2025-06-10T12:36:56","slug":"php-require-require_once-include-include_once","status":"publish","type":"my1js","link":"https:\/\/www.zhaozhao123.cn\/php\/my1js\/450.html","title":{"rendered":"PHP: require(), require_once(), include(), include_once()"},"content":{"rendered":"

<\/p>\n

介绍<\/h2>\n
理解如何在PHP脚本中包含外部文件对于模块化编程至关重要。PHP函数require(), require_once(), include(),和include_once()在此方面非常重要，但知道何时以及如何使用它们可能会让人困惑。本文将解释它们的用法、差异以及最佳实践，并提供相关代码示例。<\/p>\n

理解include()<\/h2>\n

在PHP中，include()函数用于从一个PHP文件中拉取内容，然后在服务器执行之前进行处理。通常情况下，被包含的内容对脚本的运行并不是必需的。<\/p>\n

<?php\n\/\/ Include the file\ntitle.php;\necho 'The rest of the code.';\n?>\n<\/code><\/pre>\n如果title.php文件不存在或有错误，脚本会发出警告并继续执行。<\/p>\n
require() 是一个用于加载JavaScript模块的函数，通常在Node.js环境中使用。<\/h2>\n与include()函数类似，require()函数会从指定的文件中引入内容到当前文件中。但是，如果目标文件不存在或包含错误，脚本将会停止执行并产生致命错误。<\/p>\n
<?php\n\/\/ Require the file\ntitle.php;\necho 'The script ends here if title.php is missing.';\n?>\n<\/code><\/pre>\n使用 include_once()<\/h2>\ninclude_once() 函数是对 include() 函数的扩展，确保文件只被包含一次，从而防止如果代码不小心多次调用导致重复内容。<\/p>\n
<?php\n\/\/ Using include_once\ntitle.php;\nntitle.php; \/\/ This will not include the file again\necho 'This will only include title.php once.';\n?>\n<\/code><\/pre>\nrequire_once() 函数<\/h2>\nrequire_once() 是 require() 的限制性双胞胎，与 include_once() 类似，确保文件只被包含一次。如果你需要使用重要的功能或类，则通常建议使用 require_once()。<\/p>\n
<?php\n\/\/ Require the file only oncerequire_once('header.php');\n\n\/\/ Even if we try to require it again, it won't\nrequire_once('header.php');\necho 'The header.php file will only be required a single time.';\n?>\n<\/code><\/pre>\n比较例子<\/h2>\n以下是几个比较代码示例，以便更好地理解：<\/p>\n
\/\/ Example with include\n<?php\ninclude('navigation.php');\ninclude('navigation.php'); \/\/ This will include the navigation again\necho 'Navigation may be duplicated.';\n?>\n\n\/\/ Example with include_once\n<?php\ninclude_once('navigation.php');ninclude_once('navigation.php'); \/\/ No duplicate navigation\necho 'Navigation is included just once.';\n?>\n\n\/\/ Example with require\n<?php\nrequire('config.php');nrequire('config.php'); \/\/ The script will halt here if config.php is not found twice\necho 'If config.php is missing, this will not be displayed.';\n?>\n\n\/\/ Example with require_once\n<?php\nrequire_once('config.php');require_once('config.php'); \/\/ No error, but the file won't be required againnecho 'This ensures config.php is loaded just once without errors.';\n?>\n<\/code><\/pre>\n最佳实践<\/h2>\n在整合外部PHP文件时，请遵循以下最佳实践：<\/p>\n
使用include()函数处理非必需资源，例如模板部分或菜单文件，这些资源可能需要更改且不必要用于您的脚本正常运行。<\/p>\n
使用require_once()函数对关键依赖项，如配置文件、功能库或类定义进行处理，以避免重复和错误。<\/p>\n
高级用法<\/h2>\n高级使用这些功能可以包括根据变量或逻辑条件动态包含：<\/p>\n
<?php\n\/\/ Dynamic inclusion with include_once\n$page = 'about';ninclude_once($page . '.php');\necho 'The ' . $page . ' content has been included.';\n?>\n<\/code><\/pre>\n总结<\/h2>\n本指南详细介绍了PHP的文件包含函数：require()、require_once()、include()和include_once()。每个函数都有其特定的功能，可以根据需要选择使用，以确保文件被正确地包括并且只被包括一次或多次。了解何时何地使用哪些函数可以显著提高您的PHP开发效率。<\/p>\n
<\/body><\/p>\n","protected":false},"excerpt":{"rendered":"
介绍 理解如何在PHP脚本中包含外部文件对于模&#22..<\/p>\n","protected":false},"author":1,"featured_media":0,"menu_order":0,"template":"","meta":{"_acf_changed":false},"tags":[],"my1js2nav":[38],"tuisongtax":[],"class_list":["post-450","my1js","type-my1js","status-publish","hentry","my1js2nav-jcyy"],"acf":{"qian_art_seotitle":"","qian_art_seotitle_source":{"label":"SEO\u6807\u9898","type":"text","formatted_value":""},"qian_art_seokws":"","qian_art_seokws_source":{"label":"SEO\u5173\u952e\u8bcd","type":"text","formatted_value":""},"qian_art_stzhong":"","qian_art_stzhong_source":{"label":"\u4e2d | \u77ed\u6807\u9898","type":"text","formatted_value":""}},"_links":{"self":[{"href":"https:\/\/www.zhaozhao123.cn\/php\/wp-json\/wp\/v2\/my1js\/450","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.zhaozhao123.cn\/php\/wp-json\/wp\/v2\/my1js"}],"about":[{"href":"https:\/\/www.zhaozhao123.cn\/php\/wp-json\/wp\/v2\/types\/my1js"}],"author":[{"embeddable":true,"href":"https:\/\/www.zhaozhao123.cn\/php\/wp-json\/wp\/v2\/users\/1"}],"wp:attachment":[{"href":"https:\/\/www.zhaozhao123.cn\/php\/wp-json\/wp\/v2\/media?parent=450"}],"wp:term":[{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.zhaozhao123.cn\/php\/wp-json\/wp\/v2\/tags?post=450"},{"taxonomy":"my1js2nav","embeddable":true,"href":"https:\/\/www.zhaozhao123.cn\/php\/wp-json\/wp\/v2\/my1js2nav?post=450"},{"taxonomy":"tuisongtax","embeddable":true,"href":"https:\/\/www.zhaozhao123.cn\/php\/wp-json\/wp\/v2\/tuisongtax?post=450"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}