الدالة chown() في PHP
< PHP
(PHP 4, PHP 5, PHP 7)
تغيِّر الدالة chown() مالك الملف.
الوصف
bool chown ( string $filename , mixed $user )
تحاول هذه الدالة تغيير مالك الملف filename إلى المالك الجديد user. المستخدم ذو امتيازات مدير النظام الذي يملك كافَّة صلاحيات الوصول (superuser) قادرٌ وحده على تغيير مالك الملف.
المعاملات
filename
مسار الملف الذي ستُجرى عليه العمليَّة.
user
اسم المالك الجديد أو رقم مُعرِّفه.
القيم المعادة
تُعاد القيمة TRUE عند نجاح العملية، والقيمة FALSE خلاف ذلك.
أمثلة
المثال 1: استعمال الدالة chown()
<?php
// تحديد اسم الملف واسم المستخدم
$file_name= "foo.php";
$path = "/home/sites/php.net/public_html/sandbox/" . $file_name ;
$user_name = "root";
// تغيير مالك الملف
chown($path, $user_name);
// التحقُّق من النتيجة
$stat = stat($path);
print_r(posix_getpwuid($stat['uid']));
?>
سيُظهر المثال السابق النتيجة التالية:
Array
(
[name] => root
[passwd] => x
[uid] => 0
[gid] => 0
[gecos] => root
[dir] => /root
[shell] => /bin/bash
)
ملاحظات
- لا تعمل هذه الدالة مع الملفات البعيدة إذ يجب أن يكون الملف قابلًا للوصول عبر نظام ملفات الخادم.
- إن كان الوضع الآمن (safe mode) مفعَّلًا، فستتحقَّق PHP فيما إذا كان الملف أو المجلَّد الذي ستُجرى عليه العمليَّة يملك مُعرِّف المستخدم المالك (UID) ذاته الذي يملكه السكربت الذي ينفَّذ آنذاك.