array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'ja', ), 'this' => array ( 0 => 'function.posix-getgrnam.php', 1 => 'posix_getgrnam', 2 => '指定した名前のグループに関する情報を返す', ), 'up' => array ( 0 => 'ref.posix.php', 1 => 'POSIX 関数', ), 'prev' => array ( 0 => 'function.posix-getgrgid.php', 1 => 'posix_getgrgid', ), 'next' => array ( 0 => 'function.posix-getgroups.php', 1 => 'posix_getgroups', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'ja', 'path' => 'reference/posix/functions/posix-getgrnam.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

posix_getgrnam

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

posix_getgrnam — 指定した名前のグループに関する情報を返す

説明

posix_getgrnam(string $name): array|false

指定した名前のグループに関する情報を取得します。

パラメータ

name

グループの名前。

戻り値

成功したときは array を返します。失敗した場合に false を返します。 配列で返される要素は下記のとおりです。
グループ情報の配列
要素 説明
name グループ名。これは、16 文字以下の短い文字列からなる 「ハンドル」であり、実際の完全な名前とは異なります。 グループ ID。この関数をコールする際に指定した name と同じものになるので、冗長なデータです。
passwd グループのパスワードを暗号化したもの。 システムが「シャドー」パスワードを使用している場合は、 ここではアスタリスクが返されます。
gid グループ ID を表す数値。
members このグループに属する全メンバーを表す文字列の配列。

例

例1 posix_getgrnam() の使用例

<?php

$groupinfo = posix_getgrnam("toons");

print_r($groupinfo);
?>

上の例の出力は、 たとえば以下のようになります。

Array
(
    [name]    => toons
    [passwd]  => x
    [members] => Array
        (
            [0] => tom
            [1] => jerry
        )
    [gid]     => 42
)

参考