模块

Log_File
继承自 Log_Writer

文件日志写入器。 Writes out messages and stores them in a YYYY/MM directory.

package
BootPHP
category
日志
author
Tinsh
copyright
© 2005-2016 Kilofox Studio

该类在 SYSPATH/classes/log/file.php 第 13 行声明。

属性

protected string $_directory

Directory to place log files in

protected array $_log_levels

Numeric log level to string lookup table.

方法

public __construct( string $directory ) (在 Log_File 中定义)

Creates a new file logger. Checks that the directory exists and is writable.

$writer = new Log_File($directory);

参数

  • string $directory required - Log directory

返回值

  • void

源代码

public function __construct($directory)
{
	if (!is_dir($directory) OR ! is_writable($directory))
	{
		throw new BootPHP_Exception('Directory :dir must be writable', array(':dir' => Debug::path($directory)));
	}
	// Determine the directory path
	$this->_directory = realpath($directory) . DIRECTORY_SEPARATOR;
}

public write( array $messages ) (在 Log_File 中定义)

Writes each of the messages into the log file. The log file will be appended to the `YYYY/MM/DD.log.php` file, where YYYY is the current year, MM is the current month, and DD is the current day.

$writer->write($messages);

参数

  • array $messages required - Messages

返回值

  • void

源代码

public function write(array $messages)
{
	// Set the yearly directory name
	$directory = $this->_directory . date('Y');
	if (!is_dir($directory))
	{
		// Create the yearly directory
		mkdir($directory, 02777);
		// Set permissions (must be manually set to fix umask issues)
		chmod($directory, 02777);
	}
	// Add the month to the directory
	$directory .= DIRECTORY_SEPARATOR . date('m');
	if (!is_dir($directory))
	{
		// Create the monthly directory
		mkdir($directory, 02777);
		// Set permissions (must be manually set to fix umask issues)
		chmod($directory, 02777);
	}
	// Set the name of the log file
	$filename = $directory . DIRECTORY_SEPARATOR . date('d') . '.php';
	if (!file_exists($filename))
	{
		// Create the log file
		file_put_contents($filename, BootPHP::FILE_SECURITY . ' ?>' . PHP_EOL);
		// Allow anyone to write to log files
		chmod($filename, 0666);
	}
	foreach ($messages as $message)
	{
		// Write each message into the log file
		// Format: time --- level: body
		file_put_contents($filename, PHP_EOL . $message['time'] . ' --- ' . $this->_log_levels[$message['level']] . ': ' . $message['body'], FILE_APPEND);
	}
}

final public __toString( ) (在 Log_Writer 中定义)

Allows the writer to have a unique key when stored.

echo $writer;

返回值

  • string

源代码

final public function __toString()
{
	return spl_object_hash($this);
}