CKTIS / PHP
Keyword require_once
Require a file only on its first inclusion in the request.
Version: PHP 8.4; repository runtime, production runtime not attested
Syntax
require_once $filenameRequire a file only on its first inclusion in the request. The file is tracked across include and require variants. If its first execution returns configuration data, a later require_once returns true instead of returning those data again. Failure to open a required file raises Error in PHP 8. For a local file the resolved path determines identity, so /dir/./file and /dir/file count as the same inclusion.
$file=tempnam(sys_get_temp_dir(),"req"); file_put_contents($file,'<?php return ["mode"=>"quiet"];');
$first=require_once $file; $again=require_once dirname($file)."/./".basename($file); unlink($file); echo json_encode([$first,$again]);
[{"mode":"quiet"},true]
Examples
<?php
$file=tempnam(sys_get_temp_dir(),"req"); file_put_contents($file,'<?php return ["mode"=>"quiet"];');
$first=require_once $file; $again=require_once dirname($file)."/./".basename($file); unlink($file); echo json_encode([$first,$again]);
Result
[{"mode":"quiet"},true]