Moodle PHP Documentation 4.2
Moodle 4.2.8 (Build: 20240610) (2d41ac46f45)
restore_users_parser_processor Class Reference

helper implementation of grouped_parser_processor that will load all the contents of one users.xml file to the backup_ids table storing the whole structure there for later processing. More...

Inheritance diagram for restore_users_parser_processor:
grouped_parser_processor simplified_parser_processor progressive_parser_processor

Public Member Functions

 __construct ($restoreid)
 
 add_path ($path, $grouped=false)
 
 add_path ($path)
 
 after_path ($path)
 The parser fires this each time one path has been parsed.
 
 before_path ($path)
 The parser fires this each time one path is going to be parsed.
 
 debug_info ()
 
 process_cdata ($cdata)
 Provide NULL decoding.
 
 process_chunk ($data)
 Get one chunk of parsed data and make it simpler adding attributes as tags and delegating to dispatch_chunk() the procesing of the resulting chunk.
 
 receive_chunk ($data)
 

Protected Member Functions

 add_missing_sub ($grouped, $path, $tags)
 Add non-existing subarray elements.
 
 build_currentdata ($grouped, $data)
 This function will accumulate the chunk into the specified grouped element for later dispatching once it is complete.
 
 dispatch_chunk ($data)
 Get the already simplified chunk and dispatch it.
 
 get_parent_path ($path)
 Get the parent path using a local cache for performance.
 
 grouped_child_exists ($path)
 Function that will look for any grouped child for the given path, returning it if found, false if not.
 
 grouped_parent_exists ($path)
 Function that will look for any grouped parent for the given path, returning it if found, false if not.
 
 notify_path_end ($path)
 Get one selected path and notify about end.
 
 notify_path_start ($path)
 Get one selected path and notify about start.
 
 path_is_grouped ($path)
 
 path_is_selected ($path)
 
 path_is_selected_parent ($path)
 
 postprocess_chunk ($data)
 Override this method so grouping will be happening here also deciding between accumulating/dispatching.
 
 process_pending_startend_notifications ($path, $action)
 Adjust start/end til finding one match start/end path (included)
 
 selected_parent_exists ($path)
 Returns the first selected parent if available or false.
 

Protected Attributes

 $chunks
 
 $currentdata
 
array $groupedparentprefixtree
 Search tree storing the grouped paths.
 
 $groupedpaths
 
 $inittime
 
array $parentcache = array()
 Keep cache of parent directory paths for XML parsing.
 
integer $parentcacheavailablesize = 2048
 Remaining space for parent directory paths.
 
 $parentpaths
 
 $parentsinfo
 
 $paths
 
 $restoreid
 
 $startendinfo
 

Detailed Description

helper implementation of grouped_parser_processor that will load all the contents of one users.xml file to the backup_ids table storing the whole structure there for later processing.

Note: only "needed" users are loaded (must have userref record in backup_ids) Note: parentitemid will contain the user->contextid Note: althought included in backup, we don't restore user context ras/caps in same site they will be already there and it doesn't seem a good idea to make them "transportable" arround sites.

TODO: Complete phpdocs

Member Function Documentation

◆ after_path()

grouped_parser_processor::after_path ( $path)
inherited

The parser fires this each time one path has been parsed.

Parameters
string$pathxml path which parsing has ended

Reimplemented from simplified_parser_processor.

◆ before_path()

grouped_parser_processor::before_path ( $path)
inherited

The parser fires this each time one path is going to be parsed.

Parameters
string$pathxml path which parsing has started

Reimplemented from simplified_parser_processor.

◆ dispatch_chunk()

restore_users_parser_processor::dispatch_chunk ( $data)
protected

Get the already simplified chunk and dispatch it.

Reimplemented from simplified_parser_processor.

◆ get_parent_path()

grouped_parser_processor::get_parent_path ( $path)
protectedinherited

Get the parent path using a local cache for performance.

Parameters
$pathstring The pathname you wish to obtain the parent name for.
Return values
stringThe parent pathname.

◆ notify_path_end()

restore_users_parser_processor::notify_path_end ( $path)
protected

Get one selected path and notify about end.

Reimplemented from simplified_parser_processor.

◆ notify_path_start()

restore_users_parser_processor::notify_path_start ( $path)
protected

Get one selected path and notify about start.

Reimplemented from simplified_parser_processor.

◆ postprocess_chunk()

grouped_parser_processor::postprocess_chunk ( $data)
protectedinherited

Override this method so grouping will be happening here also deciding between accumulating/dispatching.

Reimplemented from simplified_parser_processor.

Reimplemented in restore_structure_parser_processor.

◆ process_cdata()

restore_users_parser_processor::process_cdata ( $cdata)

Provide NULL decoding.

Reimplemented from progressive_parser_processor.

◆ process_chunk()

simplified_parser_processor::process_chunk ( $data)
inherited

Get one chunk of parsed data and make it simpler adding attributes as tags and delegating to dispatch_chunk() the procesing of the resulting chunk.

Reimplemented from progressive_parser_processor.

◆ process_pending_startend_notifications()

simplified_parser_processor::process_pending_startend_notifications ( $path,
$action )
protectedinherited

Adjust start/end til finding one match start/end path (included)

This will trigger all the pending {

See also
notify_path_start} and {
notify_path_end} calls for one given path and action
Parameters
stringpath the path to look for as limit
stringaction the action to look for as limit

The documentation for this class was generated from the following file: