Log

1. # Getting Started
2. # Log Levels
3. # Switch Driver
4. # Custom Stacks
5. # File Logger
6. # Options
7. # Examples

#Getting Started

To configure the log system to a specific log driver see the app/logging.php config file. By default, TypeRocket uses its stack log driver. There are five log drivers included with TypeRocket:

• file: Logs daily files to the TypeRocket storage/logs folder.
• slack: Logs to Slack using webhooks.
• mail: Send a log to an email address.
• null: Stops logging.
• stack: Logs to a list of other drivers.

#Log Levels

\TypeRocket\Pro\Utility\Log::emergency('My log');
\TypeRocket\Pro\Utility\Log::alert('My log');
\TypeRocket\Pro\Utility\Log::critical('My log');
\TypeRocket\Pro\Utility\Log::error('My log');
\TypeRocket\Pro\Utility\Log::warning('My log');
\TypeRocket\Pro\Utility\Log::notice('My log');
\TypeRocket\Pro\Utility\Log::info('My log');
\TypeRocket\Pro\Utility\Log::debug('My log');

#Switch Driver

If you do not want to use the default driver you can specify one.

\TypeRocket\Pro\Utility\Log::driver('file')->emergency('My log');

#Custom Stacks

You can log to a custom stack as well.

\TypeRocket\Pro\Utility\Log::stack(['file', 'mail'], 'emergency', 'My log');

#File Logger

You can customize the location the file logger saves log files by defining the wp-config.php constant TYPEROCKET_LOG_FILE_FOLDER. Or, you can define the typerocket_log_file filter hook; but keep in mind your hook must be added before \TypeRocket\Pro\Utility\Log is called:

add_filter('typerocket_log_file', function($file, $folder, $message, $options) {
    return $file;
}, 10, 4)

#Options

You can define how log files should be broken down by defining the wp-config.php constant TYPEROCKET_LOG_FILE_OPTIONS. Main breakdown options include:

1. daily - Breaks log files into daily dated file names like typerocket-2022-08-18.log.
2. single - Makes logs a single file typerocket.log. Using this setting can result in a large log file.

Further, you can define a type level break down of how log files are stored by using the following format {main}:{type}. Type breakdown options include:

1. joined - Makes logs a single file based on the typerocket-2022-08-18.log.
2. split - Breaks log files into type specific file names like typerocket-debug.log, typerocket-info.log, typerocket-error.log, and such.

#Examples

For example, a setting of daily:joined, this is the default setting, will result in log files named by date: typerocket-2022-08-18.log. Whereas daily:split will result in log files named by date and type: typerocket-2022-08-18-debug.log. Finally, single:split will result in log files named by type only: typerocket-debug.log.