الدالة filegroup() في PHP
(PHP 4, PHP 5, PHP 7)
تعيد الدالة filegroup() رقم معرِّف المجموعة المالكة (group ID) لملف محدَّد.
الوصف
int filegroup ( string $filename )
تعيد هذه الدالة رقم معرِّف المجموعة المالكة (GID) للملف filename في الصيغة العدديَّة. استعمل الدالة posix_getgrgif() للحصول على اسم المجموعة بناءً على رقم المعرِّف GID الذي تعيده هذه الدالة.
المعاملات
filename
مسار الملف الذي ستُجرى عليه العمليَّة.
القيم المعادة
يُعاد رقم معرِّف المجموعة المالكة (GID) للملف filename أو القيمة FALSE عند حصول أي خطأ. استعمل الدالة posix_getgrgif() لإعادة اسم المجموعة المالكة بناءً على رقم المعرف GID الذي يُعاد في الصيغة العدديَّة.
أمثلة
المثال 1: إيجاد المجموعة المالكة لملف
<?php
$filename = 'index.php';
print_r(posix_getgrgid(filegroup($filename)));
?>
الأخطاء والاستثناءات
سيُصدَر تحذير E_WARNING عند فشل الدالة.
ملاحظات
ستُخزَّن نتيجة هذه الدالة. راجع صفحة الدالة clearstatcache() للمزيد من التفاصيل.
فائدة: يمكن أن تُستعمل هذه الدالة بدءًا من إصدار PHP 5.0.0 مع بعض بروتوكلات الروابط (URL wrappers).
انظر أيضًا
- الدالة
fileowner(): تعيد معلومات عن مالك الملف. - الدالة
posix_getgrgid(): تعيد معلومات عن المجموعة المالكة لملف باستعمال رقم معرف تلك المجموعة (GID).