PHP/chown

(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) ذاته الذي يملكه السكربت الذي ينفَّذ آنذاك.

انظر أيضًا

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

مصادر

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