الدالة is_link()
في PHP
< PHP
(PHP 4, PHP 5, PHP 7)
تتحقَّق الدالة is_link()
إن كان الملف وصلةً رمزيَّةً أم لا.
الوصف
bool is_link ( string $filename )
تتحقَّق هذه الدالة فيما إذا كان الملف filename
هو وصلة رمزيَّة.
المعاملات
filename
مسار الملف المراد التحقُّق منه.
القيم المعادة
تُعاد القيمة TRUE
إن كان الملف filename
موجودًا ونوعه هو وصلة رمزيَّة، أو تُعاد القيمة FALSE
خلاف ذلك أو عند وجود خطأ.
أمثلة
المثال 1: التحقُّق إن كان الملف المُنشأ وصلةً رمزيَّة
<?php
$link = 'uploads';
if (is_link($link)) {
echo(readlink($link));
} else {
symlink('uploads.php', $link);
}
?>
الأخطاء والاستثناءات
سيُصدر تحذير من المستوى E_WARNING
عند فشل العمليَّة.
ملاحظات
- ستُخزَّن نتيجة هذه الدالة. راجع الدالة
clearstatcache()
للمزيد من التفاصيل. - يمكن أن تُستعمل هذه الدالة بدءًا من إصدار PHP 5.0.0 مع بعض بروتوكلات الروابط (URL wrappers).
انظر أيضًا
- الدالة
is_dir()
: تتحقَّق إن كان مسار الملف أو المجلَّد المُمرَّر إليها مجلَّدًا أم لا. - الدالة
is_file()
: تتحقَّق إن كان الملف هو ملفٌّ عاديٌّ. - الدالة
readlink()
: تعيد مسار الملف أو المجلَّد المستهدف الذي تشير إليه الوصلة الرمزيَّة.