include_once文は、外部ファイルを一度だけ読み込む制御構文。include文は、何度でも再読み込みできるが、include_once文は、一度読み込んだファイルを再読み込みすることはない。
使い方
丸括弧なし
include_once 'ファイル名';
「ファイル名」の外部ファイルを一度だけ読み込む。
丸括弧あり
include_once ( 'ファイル名' );
「ファイル名」の外部ファイルを一度だけ読み込む。
サンプル
includeとinclude_onceの比較サンプル
「sample.php」から、include文とinclude_once文で読み込む比較サンプル。
include.php
include文で読み込むPHPファイル。
<?php
$varA = 'おはよう(^ｏ^)';
?>
$varA = 'おはよう(^ｏ^)';
?>
include_once.php
include_once文で読み込むPHPファイル。
<?php
$varB = 'おはよう(^ｏ^)';
?>
$varB = 'おはよう(^ｏ^)';
?>
sample.php
<?php
include 'include.php';
include_once 'include_once.php';
echo '<p>$varA: ' . $varA . '</p>';
echo '<p>$varB: ' . $varB . '</p>';
$varA = 'おやすみ(-＿-)';
$varB = 'おやすみ(-＿-)';
include 'include.php';
include_once 'include_once.php';
echo '<p>$varA: ' . $varA . '</p>';
echo '<p>$varB: ' . $varB . '</p>';
?>
include 'include.php';
include_once 'include_once.php';
echo '<p>$varA: ' . $varA . '</p>';
echo '<p>$varB: ' . $varB . '</p>';
$varA = 'おやすみ(-＿-)';
$varB = 'おやすみ(-＿-)';
include 'include.php';
include_once 'include_once.php';
echo '<p>$varA: ' . $varA . '</p>';
echo '<p>$varB: ' . $varB . '</p>';
?>
↓↓↓出力結果↓↓↓
$varA: おはよう(^ｏ^)
$varB: おはよう(^ｏ^)
$varA: おはよう(^ｏ^)
$varB: おやすみ(-＿-)
$varB: おはよう(^ｏ^)
$varA: おはよう(^ｏ^)
$varB: おやすみ(-＿-)
return文なし、丸括弧なし
return文のないPHPファイル「noreturn.php」を、「sample.php」から、丸括弧なしのinclude_once文で一度だけ読み込むサンプル。
noreturn.php
return文のないPHPファイル。
<?php
$varA = 'こんにちは♪';
?>
$varA = 'こんにちは♪';
?>
sample.php
<?php
$varB = include_once 'noreturn.php';
echo '<p>$varA: ' . $varA . '</p>';
echo '<p>$varB: ' . $varB . '</p>';
?>
$varB = include_once 'noreturn.php';
echo '<p>$varA: ' . $varA . '</p>';
echo '<p>$varB: ' . $varB . '</p>';
?>
↓↓↓出力結果↓↓↓
$varA: こんにちは♪
$varB: 1
$varB: 1
return文なし、丸括弧あり
return文のないPHPファイル「noreturn.php」を、「sample.php」から、丸括弧ありのinclude_once文で一度だけ読み込むサンプル。
noreturn.php
return文のないPHPファイル。
<?php
$varA = 'こんにちは♪';
?>
$varA = 'こんにちは♪';
?>
sample.php
<?php
$varB = include_once ( 'noreturn.php' );
echo '<p>$varA: ' . $varA . '</p>';
echo '<p>$varB: ' . $varB . '</p>';
?>
$varB = include_once ( 'noreturn.php' );
echo '<p>$varA: ' . $varA . '</p>';
echo '<p>$varB: ' . $varB . '</p>';
?>
↓↓↓出力結果↓↓↓
$varA: こんにちは♪
$varB: 1
$varB: 1
return文あり、丸括弧なし
return文のあるPHPファイル「return.php」を、「sample.php」から、丸括弧なしのinclude_once文で一度だけ読み込むサンプル。
return.php
return文のあるPHPファイル。
<?php
$varA = 'こんにちは♪';
return $varA;
?>
$varA = 'こんにちは♪';
return $varA;
?>
sample.php
<?php
$varB = include_once 'return.php';
echo '<p>$varA: ' . $varA . '</p>';
echo '<p>$varB: ' . $varB . '</p>';
?>
$varB = include_once 'return.php';
echo '<p>$varA: ' . $varA . '</p>';
echo '<p>$varB: ' . $varB . '</p>';
?>
↓↓↓出力結果↓↓↓
$varA: こんにちは♪
$varB: こんにちは♪
$varB: こんにちは♪