File_Passwd_Unix::addUser()
File_Passwd_Unix::addUser() -- ユーザを追加する
概要
mixed File_Passwd_Unix::addUser (string $user, string $pass [, array $extra = array()])
説明
ユーザ名は必ずアルファベットで始まる必要があり、また英数字・下線・
ダッシュ以外の文字を含めることはできません。
「名前マップ」を使用する場合は、追加の配列でこれらの名前を使用しなければ
なりません。なぜなら、もしそれらの順番が間違っていれば値がおかしくなって
しまうからです。「名前マップ」を使用しなかった場合は、常にこの可能性が
あります!
そのため、注意した上で「名前マップ」を使用するようにしましょう!
パスワードファイルが暗号化(shadow)されている場合でもユーザは追加されます。
しかしパスワードには 'x' が設定され、PEAR_Error が返されます。
パラメータ
- string
$user
追加するユーザの名前。
- string
$pass
追加するユーザのパスワード。
- array
$extra
追加するユーザの拡張プロパティ。
返り値
成功時には TRUE、
失敗時には PEAR_Error を返します。
表 37-1PEAR_Error の値
| エラーコード | 概要 |
|---|
| FILE_PASSWD_E_ALREADY_EXISTS | ユーザはすでに存在します。 |
| FILE_PASSWD_E_INVALID_CHARS | ユーザ名に不正な文字が含まれています。 |
| FILE_PASSWD_E_INVALID_CHARS | 拡張プロパティの中にコロンが含まれています。 |
| FILE_PASSWD_E_INVALID_ENC_MODE | 暗号化形式がサポートされていません。 |
| FILE_PASSWD_E_UNDEFINED | パスワードファイルが暗号化(shadow)されています。 |
注意
この関数は、スタティックにコールする
ことはできません。