ෆන්ක්ෂියා require_once
require_once ෆන්ක්ෂියා නිශ්චිත ගොනුව වත්මන් ස්ක්රිප්ට් එකට සම්බන්ධ කරයි. ගොනුව කලින් සම්බන්ධ කර ඇත්නම්, ෆන්ක්ෂියා එය නැවත සම්බන්ධ නොකරයි. වර්ග හෝ ෆන්ක්ෂන් අඩංගු ගොනු සම්බන්ධ කිරීමට මෙය විශේෂයෙන් ප්රයෝජනවත් වන අතර, එහිදී නැවත සම්බන්ධ කිරීම දෝෂ ඇති කළ හැකිය.
වාක්ය රචනා ක්රමය
require_once 'path/to/file.php';
නිදර්ශනය
config.php ගොනුව සම්බන්ධ කරමු:
<?php
require_once 'config.php';
echo $config['site_name'];
?>
කේතය ක්රියාත්මක කිරීමේ ප්රතිඵලය (config.php හි $config අරාව අර්ථ දක්වා ඇත්නම්):
'My Site'
නිදර්ශනය
එකම ගොනුව නැවත සම්බන්ධ කිරීමට උත්සාහ කිරීම:
<?php
require_once 'functions.php';
require_once 'functions.php'; // මෙම ඇමතුම නොසලකා හරිනු ඇත
echo sum(2, 3);
?>
කේතය ක්රියාත්මක කිරීමේ ප්රතිඵලය:
5
require ට සාපේක්ෂ වෙනස
require ට වඩා, require_once ෆන්ක්ෂියා ගොනුව දැනටමත් සම්බන්ධ කර ඇත්දැයි පරීක්ෂා කරන අතර නැවත සම්බන්ධ කිරීම සිදු නොකරයි. මෙය එකම ගොනුව කීප වරක් ඇතුළත් කිරීමේ දෝෂ වලක්වයි.
මේවාත් බලන්න
-
includeෆන්ක්ෂියා,
ගොනු සම්බන්ධ කරන නමුත් ඒවා නැවත ඇතුළත් කිරීම පරීක්ෂා නොකරයි -
include_onceෆන්ක්ෂියා,
require_once වැනි වැඩ කරන නමුත් ගොනුව නොමැති විට මාරාන්තික දෝෂයක් ඇති නොකරයි