الدالة lchgrp()‎ في PHP

(PHP 5 >= 5.1.3, PHP 7)

تغيِّر الدالة lchgrp()‎ المجموعة المالكة لوصلة رمزيَّة (symlink).

الوصف

bool lchgrp ( string $filename , mixed $group )

تحاول هذه الدالة تغيير المجموعة المالكة للوصلة الرمزيَّة filename إلى المجموعة group.

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

المعاملات

filename

مسار الوصلة الرمزيَّة التي ستُجرى عليها العمليَّة.

group

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

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

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

أمثلة

المثال 1: استعمال الدالة lchgrp()‎ لتغيير المجموعة المالكة لوصلة رمزيَّة

<?php
$target = 'output.php';
$link = 'output.html';
symlink($target, $link);

lchgrp($link, 8);
?>

ملاحظات

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

انظر أيضًا

• الدالة chgrp()‎: تغيير المجموعة المالكة لملف.
• الدالة chown()‎: تغيير مالك الملف.
• الدالة chmod()‎: تغيير أذونات الملف.
• الدالة lchown()‎: تغيير المستخدم المالك لوصلة رمزيَّة.

مصادر

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