. */ declare(strict_types=1); namespace Fisharebest\Webtrees; use Illuminate\Database\Capsule\Manager as DB; use Symfony\Component\HttpFoundation\Request; /** * Record webtrees events in the database */ class Log { // We can log the following types of message in the wt_log table. const TYPE_AUTHENTICATION = 'auth'; const TYPE_CONFIGURATION = 'config'; const TYPE_EDIT = 'edit'; const TYPE_ERROR = 'error'; const TYPE_MEDIA = 'media'; const TYPE_SEARCH = 'search'; /** * Store a new message (of the appropriate type) in the message log. * * @param string $message * @param string $log_type * @param Tree|null $tree * * @return void */ private static function addLog($message, $log_type, Tree $tree = null) { $request = Request::createFromGlobals(); $ip_address = $request->getClientIp() ?? '127.0.0.1'; $tree_id = $tree ? $tree->id() : null; DB::table('log')->insert([ 'log_type' => $log_type, 'log_message' => $message, 'ip_address' => $ip_address, 'user_id' => Auth::id(), 'gedcom_id' => $tree_id, ]); } /** * Store an authentication message in the message log. * * @param string $message * * @return void */ public static function addAuthenticationLog($message) { self::addLog($message, self::TYPE_AUTHENTICATION, null); } /** * Store a configuration message in the message log. * * @param string $message * @param Tree|null $tree * * @return void */ public static function addConfigurationLog($message, Tree $tree = null) { self::addLog($message, self::TYPE_CONFIGURATION, $tree); } /** * Store an edit message in the message log. * * @param string $message * @param Tree $tree * * @return void */ public static function addEditLog($message, Tree $tree) { self::addLog($message, self::TYPE_EDIT, $tree); } /** * Store an error message in the message log. * * @param string $message * * @return void */ public static function addErrorLog($message) { self::addLog($message, self::TYPE_ERROR); } /** * Store an media management message in the message log. * * @param string $message * * @return void */ public static function addMediaLog($message) { self::addLog($message, self::TYPE_MEDIA, null); } /** * Store a search event in the message log. * Unlike most webtrees activity, search is not restricted to a single tree, * so we need to record which trees were searchecd. * * @param string $message * @param Tree[] $trees Which trees were searched * * @return void */ public static function addSearchLog($message, array $trees) { foreach ($trees as $tree) { self::addLog($message, self::TYPE_SEARCH, $tree); } } }