Função include_once

A função include_once inclui o arquivo especificado no script PHP atual, mas somente se ele não tiver sido incluído anteriormente. Isso é especialmente útil ao trabalhar com arquivos que contêm declarações de funções ou classes, para evitar erros de redeclaração. O parâmetro da função recebe o caminho para o arquivo a ser incluído.

Sintaxe

phpinclude_once 'path/to/file.php';

Exemplo

Vamos incluir o arquivo config.php apenas uma vez:

php<?php
  include_once 'config.php';
  include_once 'config.php'; // Esta chamada será ignorada
?>

Exemplo

Tentativa de incluir um arquivo que não existe:

php<?php
  include_once 'nonexistent.php'; // Gerará um aviso, mas não interromperá a execução do script
  echo 'O script continua...';
?>

Resultado da execução do código:

phpWarning: include_once(nonexistent.php): failed to open stream: No such file or directory
O script continua...

Exemplo

Usando uma variável para especificar o caminho:

php<?php
  $filePath = 'lib/functions.php';
  include_once $filePath;
?>

Veja também