Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / PHP

Palavra-chave include_once

Inclui o ficheiro se ainda não tiver sido carregado no pedido, mesmo por include ou require.

Versão: PHP 8.4; repository runtime, production runtime not attested

Sintaxe

include_once $filename

Inclui o ficheiro se ainda não tiver sido carregado no pedido, mesmo por include ou require. A primeira execução pode devolver um valor do ficheiro. Uma repetição ignorada dá true sem repetir efeitos. Um ficheiro em falta gera aviso e false. Para ficheiros locais conta o caminho resolvido: /dir/./file e /dir/file são a mesma inclusão.

$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]

Exemplos

<?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]);

Resultado

[8,true,1]

Fontes