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

من موسوعة حسوب
< PHP

(PHP 5 >= 5.1.3, PHP 7)

تغيِّر الدالة lchown()‎ المستخدم المالك لوصلة رمزيَّة.

الوصف

bool lchown ( string $filename , mixed $user )

تحاول هذه الدالة تغيير مالك الوصلة الرمزيَّة filename إلى المالك الجديد user. المستخدم ذو امتيازات مدير النظام الذي يملك كافَّة صلاحيات الوصول (superuser) قادرٌ وحده على تغيير مالك الوصلة الرمزيَّة.

المعاملات

filename

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

user

اسم المالك الجديد أو رقم مُعرِّفه.

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

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

أمثلة

المثال 1: استعمال الدالة lchown()‎

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

lchown($link, 8);
?>

ملاحظات

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

انظر أيضًا

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

مصادر