PHP/fileowner

(PHP 4, PHP 5, PHP 7)

تعيد الدالة fileowner()‎ رقم معرِّف المستخدم المالك (usre ID) لملف محدَّد.

الوصف

int fileowner ( string $filename )

تعيد هذه الدالة رقم معرِّف المستخدم المالك (UID) للملف filename في الصيغة العدديَّة. استعمل الدالة posix_getpwuid()‎ للحصول على اسم المستخدم المالك بناءً على رقم المعرِّف GID الذي تعيده هذه الدالة.

المعاملات

filename

مسار الملف الذي ستُجرى عليه العمليَّة.

القيم المعادة

يُعاد رقم معرِّف المستخدم المالك (UID) للملف filename أو القيمة FALSE عند حصول أي خطأ. استعمل الدالة posix_getpwuid()‎ لإعادة اسم المستخدم المالك بناءً على رقم المعرف UID الذي يُعاد في الصيغة العدديَّة.

أمثلة

المثال 1: إيجاد المستخدم المالك لملف‎

<?php
$filename = 'index.php';
print_r(posix_getpwuid(fileowner($filename)));
?>

الأخطاء والاستثناءات

سيُصدَر تحذير E_WARNING عند فشل الدالة.

ملاحظات

ستُخزَّن نتيجة هذه الدالة. راجع صفحة الدالة clearstatcache()‎ للمزيد من التفاصيل.

فائدة: يمكن أن تُستعمل هذه الدالة بدءًا من إصدار PHP 5.0.0 مع بعض بروتوكلات الروابط (URL wrappers).

انظر أيضًا

• الدالة filegroup()‎: تعيد معلومات عن المجموعة المالكة لملف.
• الدالة posix_getpwuid()‎: تعيد معلومات عن المستخدم المالك لملف باستعمال رقم معرف ذلك المستخدم UID.
• الدالة stat()‎: تعيد معلومات عن ملف.

مصادر

• صفحة الدالة fileowner في توثيق PHP الرسمي.