posix_getpwnam
(PHP 4, PHP 5, PHP 7, PHP 8)
posix_getpwnam — Retorna informações sobre um usuário por nome de usuário
Descrição
Retorna um array de informações sobre um determinado usuário.
Parâmetros
username
-
Um nome de usuário alfanumérico.
Valor Retornado
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. |
Exemplos
Example #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" )
Veja Também
- posix_getpwuid() - Retorna informações sobre um usuário por ID de usuário
- Página GETPWNAM(3) do manual POSIX