chown

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

chownModifica o proprietário do arquivo

Descrição

chown(string $filename, string|int $user): bool

Tenta modificar o proprietário do filename para user. Somente o superusuário pode modificar o proprietário de um arquivo.

Parâmetros

filename

Caminho para o arquivo.

user

O nome do usuário ou número.

Valor Retornado

Retorna true em caso de sucesso ou false em caso de falha.

Exemplos

Example #1 Uso simples de chown()

<?php

// Nome de usuário e do arquivo que serão usados
$file_name= "foo.php";
$path = "/home/sites/php.net/public_html/sandbox/" . $file_name ;
$user_name = "root";

// Define o usuário proprietário
chown($path, $user_name);

// Verifica o resultado
$stat = stat($path);
print_r(posix_getpwuid($stat['uid']));

?>

O exemplo acima produzirá algo semelhante a:

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

Notas

Note: Esta função não funcionará em arquivos remotos, pois o arquivo a ser examinado deve ser acessível através do sistema de arquivos do servidor.

Note: No Windows, esta função falha silenciosamente quando aplicada a um arquivo normal.

Veja Também

  • chmod() - Modifica as permissões do arquivo
  • chgrp() - Altera o grupo do arquivo