PHP/chgrp

(PHP 4, PHP 5, PHP 7)

تغيِّر الدالة chgrp()‎ المجموعة المالكة لملف.

الوصف

bool chgrp ( string $filename , mixed $group )

تحاول هذه الدالة تغيير المجموعة المالكة للملف fileneame إلى المجموعة group.

الجدير بالذكر أنَّ المستخدم ذا امتيازات مدير النظام الذي يملك كافَّة صلاحيات الوصول (superuser) قادرٌ وحده على تغيير المجموعة المالكة لملف إلى أي مجموعة كانت. من جهة أخرى، يستطيع المستخدمون الآخرون تغيير المجموعة المالكة لملف إلى أي مجموعة شرط أن يكونوا أعضاء فيها.

المعاملات

filename

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

group

اسم المجموعة أو رقمها.

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

تُعاد القيمة TRUE عند نجاح العملية، والقيمة FALSE خلاف ذلك.

أمثلة

المثال 1: استعمال الدالة chgrp()‎ لتغيير المجموعة المالكة لملف

<?php
$filename = 'shared_file.txt';
$format = "%s's Group ID @ %s: %d\n";
printf($format, $filename, date('r'), filegroup($filename));
chgrp($filename, 8);
clearstatcache(); //المخزَّنة مؤقتًا filegroup() مسح نتيجة الدالة
printf($format, $filename, date('r'), filegroup($filename));
?>

ملاحظات

• لا تعمل هذه الدالة مع الملفات البعيدة إذ يجب أن يكون الملف قابلًا للوصول عبر نظام ملفات الخادم.
• إن كان الوضع الآمن (safe mode) مفعَّلًا، فستتحقَّق PHP فيما إذا كان الملف أو المجلَّد الذي ستُجرى عليه العمليَّة يملك مُعرِّف المستخدم المالك (UID) ذاته الذي يملكه السكربت الذي ينفَّذ آنذاك.

انظر أيضًا

• الدالة chown()‎: تغيير مالك الملف.
• الدالة chmod()‎: تغيير أذونات الملف.

مصادر

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