الدالة 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()‎: تعيد مسار الملف أو المجلَّد المستهدف الذي تشير إليه الوصلة الرمزيَّة.

مصادر