chown

(PHP 4, PHP 5)

chown — Ändert den Eigentümer einer Datei

Beschreibung

bool chown ( string $filename , mixed $user )

Ändert den Eigentümer der Datei filename in Benutzer user. Nur der Superuser kann den Eigentümer einer Datei ändern.

Parameter-Liste

filename: Pfad zur Zieldatei.
user: Ein Benutzername oder eine numerische Benutzer-ID.

Rückgabewerte

Gibt bei Erfolg TRUE zurück. Im Fehlerfall wird FALSE zurückgegeben.

Beispiele

Beispiel #1 Einfache chown()-Benutzung


<?php

// Datei- und Benutzernamen setzen
$file_name= "foo.php";
$path = "/home/sites/php.net/public_html/sandbox/" . $file_name ;
$user_name = "root";

// Benutzer setzen
chown($path, $user_name);

// Ergebnis prüfen
$stat = stat($path);
print_r(posix_getpwuid($stat['uid']));

?>

Das oben gezeigte Beispiel erzeugt eine ähnliche Ausgabe wie:

Array
(
    [name] => root
    [passwd] => x
    [uid] => 0
    [gid] => 0
    [gecos] => root
    [dir] => /root
    [shell] => /bin/bash
)

Anmerkungen

Hinweis: Diese Funktion kann nicht mit entfernten Dateien arbeiten, da der Zugriff auf die Datei, die bearbeitet werden soll, über das Dateisystem des Servers möglich sein muss.

Hinweis: Wenn Safe Mode aktiviert ist, überprüft PHP, ob die Dateien/Verzeichnisse, die mit dem Skript bearbeitet werden sollen, die gleiche UID (Eigentümer) haben wie das Skript selbst.

Siehe auch

chmod() - Ändert die Zugriffsrechte einer Datei

add a note User Contributed Notes
chown

Tayfun Bilsel
11-Jan-2006 05:13


Simple usage of the chown:



<?php



$file_name= "test";

$path = "/var/www/html/test/" . $file_name ;



$user_name = "root";



chown($path, $user_name);



?>

Jens Vieler
23-May-2005 09:38


for some reason i was searching for chown() with an "on this mashine"-unknown userid and found martijn's hint very interesting. the main problem is, that if the numerical uid is used within a variable, it is checked against the /etc/passwd and returns "unknown user". a little note:



use intval(), not inval()! so all in all it is:



   chown($path_to_dir,intval($uidnumber));

greg _at_ rhythmicdesign d.o.t com
24-Feb-2004 01:00


<?php


function recurse_chown_chgrp($mypath, $uid, $gid)


{


    $d = opendir ($mypath) ;


    while(($file = readdir($d)) !== false) {


        if ($file != "." && $file != "..") {





            $typepath = $mypath . "/" . $file ;





            //print $typepath. " : " . filetype ($typepath). "<BR>" ;


            if (filetype ($typepath) == 'dir') {


                recurse_chown_chgrp ($typepath, $uid, $gid);


            }





            chown($typepath, $uid);


            chgrp($typepath, $gid);





        }


    }





 }





recurse_chown_chgrp ("uploads", "unsider", "unsider") ;


?>





for older versions.. unfortunately, it seems I do not have permission to perform these functions.

Richard Esplin
12-Oct-2003 05:49


As far as I can tell, PHP's built in functions will not do a recursive chown or chgrp. But it wouldn't be hard to write a function for this. Here is some starter code based on an example written by John Coggeshall which I found at http://www.coggeshall.org :





<?php


function recurse_chown_chgrp($path2dir, $uid, $gid){


    $dir = new dir($path2dir);


    while(($file = $dir->read()) !== false) {


        if(is_dir($dir->path.$file)) {


            recurse_chown_chgrp($dir->path.$file, $uid, $gid);


        } else {


            chown($file, $uid);


            chgrp($file, $gid);


        }


    }


    $dir->close();


}


?>





I have not tested this code (but I think it will work) because for my current needs, a simple exec("chown -r $user.$group $path"); is sufficient. I would need this code if I were not in control of the contents of these variables because they can be dangerous on the command line.

Klaus Zierer
27-Jun-2003 05:37


If you want to chown a symlink, PHP will follow the symlink and change the target file.



If you want to chown the symlink, you have to use shell_exec("/bin/chown user.group symlink");

martijn at sigterm dot nl
20-Jun-2003 04:28


If chown is filled with a variable (  chown ("myfile", $uid) the uid will be looked up through pwget_uid.



So if you need to set a non existing uid use inval($uid).

njs+php at scifi dot squawk dot com
22-Sep-2000 08:28


If you allow sudo execution for chmod by "nobody" (www, webdaemon, httpd, whatever user php is running under)in this manner, it had better be a system on which the owner is able to be root and no one else can run code, else your whole system is compromised.  Someone could change the mode of /etc/passwd or the shadow password file.





Other system commands (sudo mount) and so forth are similar.

add a note

clearstatcache

chmod

Last updated: Fri, 18 May 2012