(PHP 4, PHP 5, PHP 7, PHP 8)
posix_getpwnam — Retorna informações sobre um usuário por nome de usuário
Retorna um array de informações sobre um determinado usuário.
username
Um nome de usuário alfanumérico.
Em caso de sucesso, um array com os seguintes elementos é retornado, caso
contrário false
é retornado:
Elemento | Descrição |
---|---|
name |
Este elemento contém o nome do usuário. É um
"identificador" curto do usuário, geralmente com menos de 16 caracteres,
e não o nome completo e real. Deve ser igual ao
parâmetro username usado ao
chamar a função e, portanto, redundante.
|
passwd | Este elemento contém a senha do usuário em formato criptografado. Freqüentemente, por exemplo, em um sistema que utiliza senhas "ofuscadas", um asterisco é retornado. |
uid | ID do usuário em formato numérico. |
gid | O ID do grupo do usuário. Use a função posix_getgrgid() para resolver o nome do grupo e uma lista de seus membros. |
gecos | GECOS é um termo obsoleto que se refere ao campo de informações digitais em um sistema de processamento em lote da Honeywell. O campo, entretanto, continua vivo e seu conteúdo foi formalizado pelo POSIX. O campo contém uma lista separada por vírgulas contendo o nome completo do usuário, telefone comercial, número do escritório e número de telefone residencial. Na maioria dos sistemas, apenas o nome completo do usuário está disponível. |
dir | Este elemento contém o caminho absoluto para o diretório inicial do usuário. |
shell | Este elemento contém o caminho absoluto para o executável do shell padrão do usuário. |
Exemplo #1 Exemplo de uso de posix_getpwnam()
<?php
$userinfo = posix_getpwnam("tom");
print_r($userinfo);
?>
O exemplo acima produzirá algo semelhante a:
Array ( [name] => tom [passwd] => x [uid] => 10000 [gid] => 42 [gecos] => "tom,,," [dir] => "/home/tom" [shell] => "/bin/bash" )