w.php.net/manual/en/iterator.next.php
*/
#[ReturnTypeWillChange]
public function next() {
next( $this->blocks );
}
/**
* Checks if current position is valid.
*
* @since 5.5.0
*
* @link https://www.php.net/manual/en/iterator.valid.php
*/
#[ReturnTypeWillChange]
public function valid() {
return null !== key( $this->blocks );
}
/**
* Returns the count of blocks in the list.
*
* @since 5.5.0
*
* @link https://www.php.net/manual/en/countable.count.php
*
* @return int Block count.
*/
#[ReturnTypeWillChange]
public function count() {
return count( $this->blocks );
}
}
ectory( $dirpath ) {
$dirpath = (string) $dirpath;
$file_exists = file_exists( $dirpath );
$is_writable = wp_is_writable( $dirpath );
// If the configured setting path exists and is writeable, use it.
if ( $file_exists && $is_writable ) {
return $dirpath;
}
// Otherwise, try and log default errors.
if ( ! $file_exists ) {
$this->log( 'The defined logging directory does not exist: ' . $dirpath, __METHOD__, 'error' );
}
if ( ! $is_writable ) {
$this->log( 'The defined logging directory exists but could not be written to: ' . $dirpath, __METHOD__, 'error' );
}
return false;
}
/**
* Returns the directory to use for logging if not defined by Config. Creates one if it doesn't exist.
*
* Note: Created directories are protected by an index.html file to prevent browsing.
*
* @return false|string Directory path, if exists; False if failure.
*/
private function maybe_make_logging_directory() {
$upload_dir = wp_upload_dir();
$log_dir = trailingslashit( $upload_dir['basedir'] ) . self::DIRECTORY_PATH;
// Directory exists; return early.
if ( file_exists( $log_dir ) ) {
return $log_dir;
}
// Create the folder using wp_mkdir_p() instead of relying on KLogger.
$folder_created = wp_mkdir_p( $log_dir );
// Something went wrong mapping the directory.
if ( ! $folder_created ) {
$this->log( 'The log directory could not be created: ' . $log_dir, __METHOD__, 'error' );
return false;
}
return $log_dir;
}
/**
* Prevent browsing a directory by adding an index.html file to it
*
* Code inspired by @see wp_privacy_generate_personal_data_export_file()
*
* @param string $dirpath Path to directory to protect (in this case, logging).
*
* @return bool True: File exists or was created; False: file could not be created.
*/
private function prevent_directory_browsing( $dirpath ) {
// phpcs:disable Generic.Commenting.DocComment.MissingShort
/** @global WP_Filesystem_Base $wp_filesystem */
global $wp_filesystem;
if ( empty( $wp_filesystem ) ) {
require_once ABSPATH . '/wp-admin/includes/file.php';
WP_Filesystem();
}
if ( ! $wp_filesystem instanceof WP_Filesystem_Base ) {
$this->log( 'Unable to initialize WP_Filesystem.', __METHOD__, 'error' );
return false;
}
// Protect export folder from browsing.
$index_pathname = $dirpath . 'index.html';
if ( $wp_filesystem->exists( $index_pathname ) ) {
return true;
}
$file_content = '';
$file_was_saved = $wp_filesystem->put_contents( $index_pathname, $file_content );
if ( ! $file_was_saved ) {
$this->log( 'Unable to protect directory from browsing.', __METHOD__, 'error' );
return false;
}
return true;
}
/**
* Returns whether logging is enabled
*
* @return bool
*/
public function is_enabled() {
$is_enabled = ! empty( $this->logging_enabled );
/**
* Filter: Whether debug logging is enabled in TrustedLogin Client
*
* @since 1.0.0
*
* @param bool $debug_mode Default: false
*/
$is_enabled = apply_filters( 'trustedlogin/' . $this->ns . '/logging/enabled', $is_enabled );
return (bool) $is_enabled;
}
/**
* Log a message using KLogger or error_log().
*
* @see https://github.com/php-fig/log/blob/master/Psr/Log/LogLevel.php for log levels
*
* @param string|\WP_Error $message Message or error to log. If a WP_Error is passed, $data is ignored.
* @param string $method Method where the log was called.
* @param string $level PSR-3 log level.
* @param \WP_Error|\Exception|mixed $data Optional. Error data. Ignored if $message is WP_Error.
*/
public function log( $message = '', $method = '', $level = 'debug', $data = array() ) {
if ( ! $this->is_enabled() ) {
return;
}
$levels = array( 'emergency', 'alert', 'critical', 'error', 'warning', 'notice', 'info', 'debug' );
if ( ! in_array( $level, $levels, true ) ) {
$this->log( sprintf( 'Invalid level passed by %s method: %s', $method, $level ), __METHOD__, 'error' );
$level = 'debug'; // Continue processing original log.
}
$log_message = $message;
if ( is_wp_error( $log_message ) ) {
$data = $log_message; // Store WP_Error as extra data.
$log_message = ''; // The message will be constructed below.
}
if ( ! is_string( $log_message ) ) {
// phpcs:disable WordPress.PHP.DevelopmentFunctions.error_log_print_r
$log_message = print_r( $log_message, true );
}
if ( is_wp_error( $data ) ) {
$log_message .= sprintf( '[%s] %s', $data->get_error_code(), $data->get_error_message() );
}
if ( $data instanceof \Exception ) {
$log_message .= sprintf( '[%s] %s', $data->getCode(), $data->getMessage() );
}
// Keep PSR-4 compatible.
if ( $data && ! is_array( $data ) ) {
$data = array( $data );
}
do_action( 'trustedlogin/' . $this->ns . '/logging/log', $message, $method, $level, $data );
do_action( 'trustedlogin/' . $this->ns . '/logging/log_' . $level, $message, $method, $data );
// If logging is in place, don't use the error_log.
if ( has_action( 'trustedlogin/' . $this->ns . '/logging/log' ) || has_action( 'trustedlogin/' . $this->ns . '/logging/log_' . $level ) ) {
return;
}
// Set up klogger, creating the logging file/directory if it doesn't already exist.
$this->klogger = $this->setup_klogger( $this->config );
// The logger class didn't load. Rely on WordPress logging, if enabled.
if ( ! $this->klogger ) {
$wp_debug = defined( 'WP_DEBUG' ) && WP_DEBUG;
$wp_debug_log = defined( 'WP_DEBUG_LOG' ) && WP_DEBUG_LOG;
// If WP_DEBUG and WP_DEBUG_LOG are enabled, log errors to that file.
if ( $wp_debug && $wp_debug_log ) {
if ( ! empty( $data ) ) {
// phpcs:disable WordPress.PHP.DevelopmentFunctions.error_log_print_r
$log_message .= ' Error data: ' . print_r( $data, true );
}
// phpcs:disable WordPress.PHP.DevelopmentFunctions.error_log_error_log
error_log( $method . ' (' . $level . '): ' . $log_message );
}
return;
}
$this->klogger->{$level}( $log_message, (array) $data );
}
}
Rethink Cities - Städte neu denken
Skip to content
