UserAudit extends BaseAudit
User audit trail implementations
Table of Contents
Methods
- userCreatedLog() : void
- Log User creation
- userDeletedLog() : void
- Log User deletion
- userLoginLog() : void
- Log User login
- userUpdatedLog() : void
- Log User update
- addAuditLog() : void
- Log an audit trail entry
- getCompanyId() : int
- Extract company ID from various model types.
- getUserId() : int
- Get the current authenticated user ID, or fallback to job context user ID.
Methods
userCreatedLog()
Log User creation
public
static userCreatedLog(mixed $record[, int $userId = 0 ]) : void
Parameters
- $record : mixed
-
The newly created User record
- $userId : int = 0
-
The ID of the user who performed the action (optional)
Tags
userDeletedLog()
Log User deletion
public
static userDeletedLog(mixed $record[, int $userId = 0 ]) : void
Parameters
- $record : mixed
-
The User being deleted
- $userId : int = 0
-
The ID of the user who performed the action (optional)
Tags
userLoginLog()
Log User login
public
static userLoginLog(mixed $oldRecord, mixed $newRecord[, int $userId = 0 ]) : void
Parameters
- $oldRecord : mixed
- $newRecord : mixed
- $userId : int = 0
-
The ID of the user who performed the action (optional)
Tags
userUpdatedLog()
Log User update
public
static userUpdatedLog(mixed $oldRecord, mixed $newRecord[, int $userId = 0 ]) : void
Parameters
- $oldRecord : mixed
-
The User data before the update
- $newRecord : mixed
-
The User data after the update
- $userId : int = 0
-
The ID of the user who performed the action (optional)
Tags
addAuditLog()
Log an audit trail entry
protected
static addAuditLog(int $companyId, int $userId, string $message, string $module, string $action[, mixed|null $currentRecord = null ][, mixed|null $updatedRecord = null ][, string|null $objectName = null ][, string $queueName = 'audit-trails' ][, bool $afterCommit = false ]) : void
Parameters
- $companyId : int
-
Company identifier
- $userId : int
-
User identifier (default 0 for system actions)
- $message : string
-
Human-readable audit message
- $module : string
-
Module name (PAYROLL, LEAVE, PAYMENTS, etc.) - must be a valid AuditModulesEnum value
- $action : string
-
Action type (CREATE, UPDATE, DELETE, etc.) - must be a valid AuditActionsEnum value
- $currentRecord : mixed|null = null
-
Current data being logged
- $updatedRecord : mixed|null = null
-
The updated data (for updates)
- $objectName : string|null = null
-
Optional name of the object being logged - if not provided, will be inferred from the model
- $queueName : string = 'audit-trails'
-
Optional queue name for async processing. Default 'audit-trails'
- $afterCommit : bool = false
-
Whether to log after DB commit
Tags
getCompanyId()
Extract company ID from various model types.
protected
static getCompanyId(mixed $model) : int
This method attempts to determine the company ID from the provided model instance.
It checks for a direct company_id property or navigates through related employee models.
Parameters
- $model : mixed
-
Model instance
Tags
Return values
int —Company ID
getUserId()
Get the current authenticated user ID, or fallback to job context user ID.
protected
static getUserId() : int
This method first checks for an authenticated user via the auth() helper. If no user is authenticated, it looks for a user_id in the job context (for queued jobs).
To add a user ID to the job context, you can use this in your job setup:
app()->instance('job_context', ['user_id' => $userId]);
If neither is available, it returns 0 to indicate a system action.
Return values
int —The determined user ID, or 0 if none found