[ Index ]

PHP Cross Reference of DokuWiki

title

Body

[close]

/lib/plugins/authplain/ -> auth.php (summary)

(no description)

File Size: 489 lines (15 kb)
Included or required:0 times
Referenced: 0 times
Includes or requires: 0 files

Defines 1 class

auth_plugin_authplain:: (17 methods):
  __construct()
  checkPass()
  getUserData()
  createUserLine()
  createUser()
  modifyUser()
  deleteUsers()
  getUserCount()
  retrieveUsers()
  retrieveGroups()
  cleanUser()
  cleanGroup()
  loadUserData()
  readUserFile()
  splitUserData()
  filter()
  constructPattern()


Class: auth_plugin_authplain  - X-Ref

Plaintext authentication backend

__construct()   X-Ref
Constructor

Carry out sanity checks to ensure the object is
able to operate. Set capabilities.

author: Christopher Smith <chris@jalakai.co.uk>

checkPass($user, $pass)   X-Ref
Check user+password

Checks if the given user exists and the given
plaintext password is correct

author: Andreas Gohr <andi@splitbrain.org>
param: string $user
param: string $pass
return: bool

getUserData($user, $requireGroups = true)   X-Ref
Return user info

Returns info about the given user needs to contain
at least these fields:

name string  full name of the user
mail string  email addres of the user
grps array   list of groups the user is in

author: Andreas Gohr <andi@splitbrain.org>
param: string $user
param: bool $requireGroups  (optional) ignored by this plugin, grps info always supplied
return: array|false

createUserLine($user, $pass, $name, $mail, $grps)   X-Ref
Creates a string suitable for saving as a line
in the file database
(delimiters escaped, etc.)

param: string $user
param: string $pass
param: string $name
param: string $mail
param: array  $grps list of groups the user is in
return: string

createUser($user, $pwd, $name, $mail, $grps = null)   X-Ref
Create a new User

Returns false if the user already exists, null when an error
occurred and true if everything went well.

The new user will be added to the default group by this
function if grps are not specified (default behaviour).

author: Andreas Gohr <andi@splitbrain.org>
author: Chris Smith <chris@jalakai.co.uk>
param: string $user
param: string $pwd
param: string $name
param: string $mail
param: array  $grps
return: bool|null|string

modifyUser($user, $changes)   X-Ref
Modify user data

author: Chris Smith <chris@jalakai.co.uk>
param: string $user      nick of the user to be changed
param: array  $changes   array of field/value pairs to be changed (password will be clear text)
return: bool

deleteUsers($users)   X-Ref
Remove one or more users from the list of registered users

author: Christopher Smith <chris@jalakai.co.uk>
param: array  $users   array of users to be deleted
return: int             the number of users deleted

getUserCount($filter = [])   X-Ref
Return a count of the number of user which meet $filter criteria

author: Chris Smith <chris@jalakai.co.uk>
param: array $filter
return: int

retrieveUsers($start = 0, $limit = 0, $filter = [])   X-Ref
Bulk retrieval of user data

author: Chris Smith <chris@jalakai.co.uk>
param: int   $start index of first user to be returned
param: int   $limit max number of users to be returned
param: array $filter array of field/pattern pairs
return: array userinfo (refer getUserData for internal userinfo details)

retrieveGroups($start = 0, $limit = 0)   X-Ref
Retrieves groups.
Loads complete user data into memory before searching for groups.

param: int   $start index of first group to be returned
param: int   $limit max number of groups to be returned
return: array

cleanUser($user)   X-Ref
Only valid pageid's (no namespaces) for usernames

param: string $user
return: string

cleanGroup($group)   X-Ref
Only valid pageid's (no namespaces) for groupnames

param: string $group
return: string

loadUserData()   X-Ref
Load all user data

loads the user file into a datastructure

author: Andreas Gohr <andi@splitbrain.org>

readUserFile($file)   X-Ref
Read user data from given file

ignores non existing files

param: string $file the file to load data from
return: array

splitUserData($line)   X-Ref
Get the user line split into it's parts

param: string $line
return: string[]

filter($user, $info)   X-Ref
return true if $user + $info match $filter criteria, false otherwise

author: Chris Smith <chris@jalakai.co.uk>
param: string $user User login
param: array  $info User's userinfo array
return: bool

constructPattern($filter)   X-Ref
construct a filter pattern

param: array $filter