Moodle PHP Documentation 4.2
Moodle 4.2.8 (Build: 20240610) (2d41ac46f45)
core\log\sql_internal_table_reader Interface Reference

Sql internal table reader. More...

Inheritance diagram for core\log\sql_internal_table_reader:
core\log\sql_reader core\log\reader logstore_standard\log\store

Public Member Functions

 get_description ()
 Longer description of the log data source.
 
 get_events_select ($selectwhere, array $params, $sort, $limitfrom, $limitnum)
 Fetch records using given criteria.
 
 get_events_select_count ($selectwhere, array $params)
 Return number of events matching given criteria.
 
 get_events_select_exists (string $selectwhere, array $params)
 Get whether events are present for the given select clause.
 
 get_events_select_iterator ($selectwhere, array $params, $sort, $limitfrom, $limitnum)
 Fetch records using the given criteria returning an traversable list of events.
 
 get_internal_log_table_name ()
 Returns name of the table or database view that holds the log data in standardised format.
 
 get_log_event ($data)
 Returns an event from the log data.
 
 get_name ()
 Localised name of the reader.
 
 is_logging ()
 Are the new events appearing in the reader?
 

Detailed Description

Sql internal table reader.

Replaces sql_internal_reader and extends sql_reader.

Since
Moodle 2.9
License
http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later

Member Function Documentation

◆ get_description()

core\log\reader::get_description ( )
inherited

Longer description of the log data source.

Return values
string

◆ get_events_select()

core\log\sql_reader::get_events_select ( $selectwhere,
array $params,
$sort,
$limitfrom,
$limitnum )
inherited

Fetch records using given criteria.

Parameters
string$selectwhere
array$params
string$sort
int$limitfrom
int$limitnum
Return values
core\event\base[]

Implemented in logstore_database\log\store, and logstore_standard\log\store.

◆ get_events_select_count()

core\log\sql_reader::get_events_select_count ( $selectwhere,
array $params )
inherited

Return number of events matching given criteria.

Parameters
string$selectwhere
array$params
Return values
int

Implemented in logstore_database\log\store, and logstore_standard\log\store.

◆ get_events_select_exists()

core\log\sql_reader::get_events_select_exists ( string $selectwhere,
array $params )
inherited

Get whether events are present for the given select clause.

Parameters
string$selectwhereselect conditions.
array$paramsparams.
Return values
boolWhether events available for the given conditions

Implemented in logstore_database\log\store, and logstore_standard\log\store.

◆ get_events_select_iterator()

core\log\sql_reader::get_events_select_iterator ( $selectwhere,
array $params,
$sort,
$limitfrom,
$limitnum )
inherited

Fetch records using the given criteria returning an traversable list of events.

Note that the returned object is Traversable, not Iterator, as we are returning EmptyIterator if we know there are no events, and EmptyIterator does not implement Countable so valid() should be checked in any case instead of a count().

Also note that the traversable object contains a recordset and it is very important that you close it after using it.

Parameters
string$selectwhere
array$params
string$sort
int$limitfrom
int$limitnum
Return values
Traversable|core\event\base[]Returns an iterator containing core\event\base objects.

Implemented in logstore_database\log\store, and logstore_standard\log\store.

◆ get_internal_log_table_name()

core\log\sql_internal_table_reader::get_internal_log_table_name ( )

Returns name of the table or database view that holds the log data in standardised format.

Note: this table must be used for reading only, it is strongly recommended to use this in complex reports only.

Return values
string

Implemented in logstore_standard\log\store.

◆ get_log_event()

core\log\sql_reader::get_log_event ( $data)
inherited

Returns an event from the log data.

Parameters
stdClass$dataLog data
Return values
core\event\base

Implemented in logstore_database\log\store, and logstore_standard\log\store.

◆ get_name()

core\log\reader::get_name ( )
inherited

Localised name of the reader.

To be used in selection for in reports.

Return values
string

◆ is_logging()

core\log\reader::is_logging ( )
inherited

Are the new events appearing in the reader?

Return values
booltrue means new log events are being added, false means no new data will be added

Implemented in logstore_database\log\store, and logstore_standard\log\store.


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