PHP: Hypertext Preprocessor (original) (raw)

chown

(PHP 4, PHP 5, PHP 7, PHP 8)

chown — Changes file owner

Description

Parameters

filename

Path to the file.

user

A user name or number.

Return Values

Returns [true](reserved.constants.php#constant.true) on success or [false](reserved.constants.php#constant.false) on failure.

Examples

Example #1 Simple chown() usage

<?php// File name and username to use $file_name= "foo.php"; <math xmlns="http://www.w3.org/1998/Math/MathML"><semantics><mrow><mi>p</mi><mi>a</mi><mi>t</mi><mi>h</mi><mo>=</mo><mi mathvariant="normal">"</mi><mi mathvariant="normal">/</mi><mi>h</mi><mi>o</mi><mi>m</mi><mi>e</mi><mi mathvariant="normal">/</mi><mi>s</mi><mi>i</mi><mi>t</mi><mi>e</mi><mi>s</mi><mi mathvariant="normal">/</mi><mi>p</mi><mi>h</mi><mi>p</mi><mi mathvariant="normal">.</mi><mi>n</mi><mi>e</mi><mi>t</mi><mi mathvariant="normal">/</mi><mi>p</mi><mi>u</mi><mi>b</mi><mi>l</mi><mi>i</mi><msub><mi>c</mi><mi>h</mi></msub><mi>t</mi><mi>m</mi><mi>l</mi><mi mathvariant="normal">/</mi><mi>s</mi><mi>a</mi><mi>n</mi><mi>d</mi><mi>b</mi><mi>o</mi><mi>x</mi><mi mathvariant="normal">/</mi><mi mathvariant="normal">"</mi><mi mathvariant="normal">.</mi></mrow><annotation encoding="application/x-tex">path = "/home/sites/php.net/public_html/sandbox/" . </annotation></semantics></math>path="/home/sites/php.net/publichtml/sandbox/".file_name ; $user_name = "root";// Set the user chown($path, $user_name);// Check the result <math xmlns="http://www.w3.org/1998/Math/MathML"><semantics><mrow><mi>s</mi><mi>t</mi><mi>a</mi><mi>t</mi><mo>=</mo><mi>s</mi><mi>t</mi><mi>a</mi><mi>t</mi><mo stretchy="false">(</mo></mrow><annotation encoding="application/x-tex">stat = stat(</annotation></semantics></math>stat=stat(path); print_r(posix_getpwuid($stat['uid']));?>

The above example will output something similar to:

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

Notes

Note: This function will not work onremote files as the file to be examined must be accessible via the server's filesystem.

Note: On Windows, this function fails silently when applied on a regular file.

Found A Problem?

martijn at sigterm dot nl ¶

21 years ago

`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).

mindlessconsumer+phpnet at gmail dot com ¶

3 months ago

`` It may be worth making explicitly clear that, while the shell's chown command allows both user and group to be set in one system call like this chown username:groupname filename, PHP's version unfortunately does not: