WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / PHP

Schlüsselwort include_once

Bindet eine Datei nur ein, wenn sie in dieser Anfrage noch nicht geladen wurde, auch nicht per include oder require.

Version: PHP 8.4; repository runtime, production runtime not attested

Syntax

include_once $filename

Bindet eine Datei nur ein, wenn sie in dieser Anfrage noch nicht geladen wurde, auch nicht per include oder require. Beim ersten Mal kann sie einen Wert liefern. Ein übersprungener Wiederholungsaufruf liefert true ohne erneute Nebenwirkungen. Eine fehlende Datei ergibt Warnung und false. Bei lokalen Dateien entscheidet der aufgelöste Pfad: /dir/./file und /dir/file sind dieselbe Einbindung.

$file=tempnam(sys_get_temp_dir(),"once"); file_put_contents($file,'<?php ++$count; return 8;'); $count=0;
$a=include $file; $b=include_once dirname($file)."/./".basename($file); unlink($file); echo json_encode([$a,$b,$count]);
[8,true,1]

Beispiele

<?php
$file=tempnam(sys_get_temp_dir(),"once"); file_put_contents($file,'<?php ++$count; return 8;'); $count=0;
$a=include $file; $b=include_once dirname($file)."/./".basename($file); unlink($file); echo json_encode([$a,$b,$count]);

Ergebnis

[8,true,1]

Quellen