rhays/rpsls-game
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity

First Local Commit - After Clean up.

Browse Source 
Signed-off-by: Rick Hays <rhays@haysgang.com>
This commit is contained in:
Rick Hays
2019-12-02 14:54:38 -06:00
commit 10412ab7f6
486 changed files with 123242 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

13
system/Log/Exceptions/LogException.php Normal file
View File

@@ -0,0 +1,13 @@
<?php namespace CodeIgniter\Log\Exceptions;
use CodeIgniter\Exceptions\ExceptionInterface;
use CodeIgniter\Exceptions\FrameworkException;
class LogException extends FrameworkException implements ExceptionInterface
{
public static function forInvalidLogLevel(string $level)
{
return new static(lang('Log.invalidLogLevel', [$level]));
}
}

121
system/Log/Handlers/BaseHandler.php Normal file
View File

@@ -0,0 +1,121 @@
<?php
/**
* CodeIgniter
*
* An open source application development framework for PHP
*
* This content is released under the MIT License (MIT)
*
* Copyright (c) 2014-2019 British Columbia Institute of Technology
* Copyright (c) 2019 CodeIgniter Foundation
*
* Permission is hereby granted, free of charge, to any person obtaining a copy
* of this software and associated documentation files (the "Software"), to deal
* in the Software without restriction, including without limitation the rights
* to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
* copies of the Software, and to permit persons to whom the Software is
* furnished to do so, subject to the following conditions:
*
* The above copyright notice and this permission notice shall be included in
* all copies or substantial portions of the Software.
*
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
* AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
* LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
* OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
* THE SOFTWARE.
*
* @package CodeIgniter
* @author CodeIgniter Dev Team
* @copyright 2019 CodeIgniter Foundation
* @license https://opensource.org/licenses/MIT MIT License
* @link https://codeigniter.com
* @since Version 4.0.0
* @filesource
*/
namespace CodeIgniter\Log\Handlers;
/**
* Base class for logging
*/
abstract class BaseHandler implements HandlerInterface
{
/**
* Handles
*
* @var array
*/
protected $handles;
/**
* Date format for logging
*
* @var string
*/
protected $dateFormat = 'Y-m-d H:i:s';
//--------------------------------------------------------------------
/**
* Constructor
*
* @param array $config
*/
public function __construct(array $config)
{
$this->handles = $config['handles'] ?? [];
}
//--------------------------------------------------------------------
/**
* Checks whether the Handler will handle logging items of this
* log Level.
*
* @param $level
*
* @return boolean
*/
public function canHandle(string $level): bool
{
return in_array($level, $this->handles);
}
//--------------------------------------------------------------------
/**
* Handles logging the message.
* If the handler returns false, then execution of handlers
* will stop. Any handlers that have not run, yet, will not
* be run.
*
* @param $level
* @param $message
*
* @return boolean
*/
abstract public function handle($level, $message): bool;
//--------------------------------------------------------------------
/**
* Stores the date format to use while logging messages.
*
* @param string $format
*
* @return HandlerInterface
*/
public function setDateFormat(string $format): HandlerInterface
{
$this->dateFormat = $format;
return $this;
}
//--------------------------------------------------------------------
}

217
system/Log/Handlers/ChromeLoggerHandler.php Normal file
View File

@@ -0,0 +1,217 @@
<?php
/**
* CodeIgniter
*
* An open source application development framework for PHP
*
* This content is released under the MIT License (MIT)
*
* Copyright (c) 2014-2019 British Columbia Institute of Technology
* Copyright (c) 2019 CodeIgniter Foundation
*
* Permission is hereby granted, free of charge, to any person obtaining a copy
* of this software and associated documentation files (the "Software"), to deal
* in the Software without restriction, including without limitation the rights
* to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
* copies of the Software, and to permit persons to whom the Software is
* furnished to do so, subject to the following conditions:
*
* The above copyright notice and this permission notice shall be included in
* all copies or substantial portions of the Software.
*
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
* AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
* LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
* OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
* THE SOFTWARE.
*
* @package CodeIgniter
* @author CodeIgniter Dev Team
* @copyright 2019 CodeIgniter Foundation
* @license https://opensource.org/licenses/MIT MIT License
* @link https://codeigniter.com
* @since Version 4.0.0
* @filesource
*/
namespace CodeIgniter\Log\Handlers;
use CodeIgniter\Events\Events;
use CodeIgniter\HTTP\ResponseInterface;
use CodeIgniter\Config\Services;
/**
* Class ChromeLoggerHandler
*
* Allows for logging items to the Chrome console for debugging.
* Requires the ChromeLogger extension installed in your browser.
*
* @see https://craig.is/writing/chrome-logger
*
* @package CodeIgniter\Log\Handlers
*/
class ChromeLoggerHandler extends BaseHandler implements HandlerInterface
{
/**
* Version of this library - for ChromeLogger use.
*
* @var float
*/
const VERSION = 1.0;
/**
* The number of track frames returned from the backtrace.
*
* @var integer
*/
protected $backtraceLevel = 0;
/**
* The final data that is sent to the browser.
*
* @var array
*/
protected $json = [
'version' => self::VERSION,
'columns' => [
'log',
'backtrace',
'type',
],
'rows' => [],
];
/**
* The header used to pass the data.
*
* @var string
*/
protected $header = 'X-ChromeLogger-Data';
/**
* Maps the log levels to the ChromeLogger types.
*
* @var array
*/
protected $levels = [
'emergency' => 'error',
'alert' => 'error',
'critical' => 'error',
'error' => 'error',
'warning' => 'warn',
'notice' => 'warn',
'info' => 'info',
'debug' => 'info',
];
//--------------------------------------------------------------------
/**
* Constructor
*
* @param array $config
*/
public function __construct(array $config = [])
{
parent::__construct($config);
$request = Services::request(null, true);
$this->json['request_uri'] = (string) $request->uri;
Events::on('post_controller', [$this, 'sendLogs'], EVENT_PRIORITY_HIGH);
}
//--------------------------------------------------------------------
/**
* Handles logging the message.
* If the handler returns false, then execution of handlers
* will stop. Any handlers that have not run, yet, will not
* be run.
*
* @param $level
* @param $message
*
* @return boolean
*/
public function handle($level, $message): bool
{
// Format our message
$message = $this->format($message);
// Generate Backtrace info
$backtrace = debug_backtrace(false, $this->backtraceLevel);
$backtrace = end($backtrace);
$backtraceMessage = 'unknown';
if (isset($backtrace['file']) && isset($backtrace['line']))
{
$backtraceMessage = $backtrace['file'] . ':' . $backtrace['line'];
}
// Default to 'log' type.
$type = '';
if (array_key_exists($level, $this->levels))
{
$type = $this->levels[$level];
}
$this->json['rows'][] = [
$message,
$backtraceMessage,
$type,
];
return true;
}
//--------------------------------------------------------------------
/**
* Converts the object to display nicely in the Chrome Logger UI.
*
* @param $object
*
* @return array
*/
protected function format($object)
{
if (! is_object($object))
{
return $object;
}
// @todo Modify formatting of objects once we can view them in browser.
$objectArray = (array) $object;
$objectArray['___class_name'] = get_class($object);
return $objectArray;
}
//--------------------------------------------------------------------
/**
* Attaches the header and the content to the passed in request object.
*
* @param ResponseInterface $response
*/
public function sendLogs(ResponseInterface &$response = null)
{
if (is_null($response))
{
$response = Services::response(null, true);
}
$data = base64_encode(utf8_encode(json_encode($this->json)));
$response->setHeader($this->header, $data);
}
}

164
system/Log/Handlers/FileHandler.php Normal file
View File

@@ -0,0 +1,164 @@
<?php
/**
* CodeIgniter
*
* An open source application development framework for PHP
*
* This content is released under the MIT License (MIT)
*
* Copyright (c) 2014-2019 British Columbia Institute of Technology
* Copyright (c) 2019 CodeIgniter Foundation
*
* Permission is hereby granted, free of charge, to any person obtaining a copy
* of this software and associated documentation files (the "Software"), to deal
* in the Software without restriction, including without limitation the rights
* to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
* copies of the Software, and to permit persons to whom the Software is
* furnished to do so, subject to the following conditions:
*
* The above copyright notice and this permission notice shall be included in
* all copies or substantial portions of the Software.
*
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
* AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
* LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
* OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
* THE SOFTWARE.
*
* @package CodeIgniter
* @author CodeIgniter Dev Team
* @copyright 2019 CodeIgniter Foundation
* @license https://opensource.org/licenses/MIT MIT License
* @link https://codeigniter.com
* @since Version 4.0.0
* @filesource
*/
namespace CodeIgniter\Log\Handlers;
/**
* Log error messages to file system
*/
class FileHandler extends BaseHandler implements HandlerInterface
{
/**
* Folder to hold logs
*
* @var string
*/
protected $path;
/**
* Extension to use for log files
*
* @var string
*/
protected $fileExtension;
/**
* Permissions for new log files
*
* @var integer
*/
protected $filePermissions;
//--------------------------------------------------------------------
/**
* Constructor
*
* @param array $config
*/
public function __construct(array $config = [])
{
parent::__construct($config);
$this->path = $config['path'] ?? WRITEPATH . 'logs/';
$this->fileExtension = $config['fileExtension'] ?? 'php';
$this->fileExtension = ltrim($this->fileExtension, '.');
$this->filePermissions = $config['filePermissions'] ?? 0644;
}
//--------------------------------------------------------------------
/**
* Handles logging the message.
* If the handler returns false, then execution of handlers
* will stop. Any handlers that have not run, yet, will not
* be run.
*
* @param $level
* @param $message
*
* @return boolean
* @throws \Exception
*/
public function handle($level, $message): bool
{
$filepath = $this->path . 'log-' . date('Y-m-d') . '.' . $this->fileExtension;
$msg = '';
if (! is_file($filepath))
{
$newfile = true;
// Only add protection to php files
if ($this->fileExtension === 'php')
{
$msg .= "<?php defined('SYSTEMPATH') || exit('No direct script access allowed'); ?>\n\n";
}
}
if (! $fp = @fopen($filepath, 'ab'))
{
return false;
}
// Instantiating DateTime with microseconds appended to initial date is needed for proper support of this format
if (strpos($this->dateFormat, 'u') !== false)
{
$microtime_full = microtime(true);
$microtime_short = sprintf('%06d', ($microtime_full - floor($microtime_full)) * 1000000);
$date = new \DateTime(date('Y-m-d H:i:s.' . $microtime_short, $microtime_full));
$date = $date->format($this->dateFormat);
}
else
{
$date = date($this->dateFormat);
}
$msg .= strtoupper($level) . ' - ' . $date . ' --> ' . $message . "\n";
flock($fp, LOCK_EX);
for ($written = 0, $length = strlen($msg); $written < $length; $written += $result)
{
if (($result = fwrite($fp, substr($msg, $written))) === false)
{
// if we get this far, we'll never see this during travis-ci
// @codeCoverageIgnoreStart
break;
// @codeCoverageIgnoreEnd
}
}
flock($fp, LOCK_UN);
fclose($fp);
if (isset($newfile) && $newfile === true)
{
chmod($filepath, $this->filePermissions);
}
return is_int($result);
}
//--------------------------------------------------------------------
}

85
system/Log/Handlers/HandlerInterface.php Normal file
View File

@@ -0,0 +1,85 @@
<?php
/**
* CodeIgniter
*
* An open source application development framework for PHP
*
* This content is released under the MIT License (MIT)
*
* Copyright (c) 2014-2019 British Columbia Institute of Technology
* Copyright (c) 2019 CodeIgniter Foundation
*
* Permission is hereby granted, free of charge, to any person obtaining a copy
* of this software and associated documentation files (the "Software"), to deal
* in the Software without restriction, including without limitation the rights
* to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
* copies of the Software, and to permit persons to whom the Software is
* furnished to do so, subject to the following conditions:
*
* The above copyright notice and this permission notice shall be included in
* all copies or substantial portions of the Software.
*
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
* AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
* LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
* OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
* THE SOFTWARE.
*
* @package CodeIgniter
* @author CodeIgniter Dev Team
* @copyright 2019 CodeIgniter Foundation
* @license https://opensource.org/licenses/MIT MIT License
* @link https://codeigniter.com
* @since Version 4.0.0
* @filesource
*/
namespace CodeIgniter\Log\Handlers;
/**
* Expected behavior for a Log handler
*/
interface HandlerInterface
{
/**
* Handles logging the message.
* If the handler returns false, then execution of handlers
* will stop. Any handlers that have not run, yet, will not
* be run.
*
* @param $level
* @param $message
*
* @return boolean
*/
public function handle($level, $message): bool;
//--------------------------------------------------------------------
/**
* Checks whether the Handler will handle logging items of this
* log Level.
*
* @param string $level
*
* @return boolean
*/
public function canHandle(string $level): bool;
//--------------------------------------------------------------------
/**
* Sets the preferred date format to use when logging.
*
* @param string $format
*
* @return HandlerInterface
*/
public function setDateFormat(string $format);
//--------------------------------------------------------------------
}

535
system/Log/Logger.php Normal file
View File

@@ -0,0 +1,535 @@
<?php
/**
* CodeIgniter
*
* An open source application development framework for PHP
*
* This content is released under the MIT License (MIT)
*
* Copyright (c) 2014-2019 British Columbia Institute of Technology
* Copyright (c) 2019 CodeIgniter Foundation
*
* Permission is hereby granted, free of charge, to any person obtaining a copy
* of this software and associated documentation files (the "Software"), to deal
* in the Software without restriction, including without limitation the rights
* to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
* copies of the Software, and to permit persons to whom the Software is
* furnished to do so, subject to the following conditions:
*
* The above copyright notice and this permission notice shall be included in
* all copies or substantial portions of the Software.
*
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
* AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
* LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
* OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
* THE SOFTWARE.
*
* @package CodeIgniter
* @author CodeIgniter Dev Team
* @copyright 2019 CodeIgniter Foundation
* @license https://opensource.org/licenses/MIT MIT License
* @link https://codeigniter.com
* @since Version 4.0.0
* @filesource
*/
namespace CodeIgniter\Log;
use Psr\Log\LoggerInterface;
use CodeIgniter\Log\Exceptions\LogException;
/**
* The CodeIgntier Logger
*
* The message MUST be a string or object implementing __toString().
*
* The message MAY contain placeholders in the form: {foo} where foo
* will be replaced by the context data in key "foo".
*
* The context array can contain arbitrary data, the only assumption that
* can be made by implementors is that if an Exception instance is given
* to produce a stack trace, it MUST be in a key named "exception".
*
* @package CodeIgniter\Log
*/
class Logger implements LoggerInterface
{
/**
* Path to save log files to.
*
* @var string
*/
protected $logPath;
/**
* Used by the logThreshold Config setting to define
* which errors to show.
*
* @var array
*/
protected $logLevels = [
'emergency' => 1,
'alert' => 2,
'critical' => 3,
'error' => 4,
'warning' => 5,
'notice' => 6,
'info' => 7,
'debug' => 8,
];
/**
* Array of levels to be logged.
* The rest will be ignored.
* Set in Config/logger.php
*
* @var array
*/
protected $loggableLevels = [];
/**
* File permissions
*
* @var integer
*/
protected $filePermissions = 0644;
/**
* Format of the timestamp for log files.
*
* @var string
*/
protected $dateFormat = 'Y-m-d H:i:s';
/**
* Filename Extension
*
* @var string
*/
protected $fileExt;
/**
* Caches instances of the handlers.
*
* @var array
*/
protected $handlers = [];
/**
* Holds the configuration for each handler.
* The key is the handler's class name. The
* value is an associative array of configuration
* items.
*
* @var array
*/
protected $handlerConfig = [];
/**
* Caches logging calls for debugbar.
*
* @var array
*/
public $logCache;
/**
* Should we cache our logged items?
*
* @var boolean
*/
protected $cacheLogs = false;
//--------------------------------------------------------------------
/**
* Constructor.
*
* @param \Config\Logger $config
* @param boolean $debug
* @throws \RuntimeException
*/
public function __construct($config, bool $debug = CI_DEBUG)
{
$this->loggableLevels = is_array($config->threshold) ? $config->threshold : range(1, (int) $config->threshold);
// Now convert loggable levels to strings.
// We only use numbers to make the threshold setting convenient for users.
if ($this->loggableLevels)
{
$temp = [];
foreach ($this->loggableLevels as $level)
{
$temp[] = array_search((int) $level, $this->logLevels);
}
$this->loggableLevels = $temp;
unset($temp);
}
$this->dateFormat = $config->dateFormat ?? $this->dateFormat;
if (! is_array($config->handlers) || empty($config->handlers))
{
throw LogException::forNoHandlers('LoggerConfig');
}
// Save the handler configuration for later.
// Instances will be created on demand.
$this->handlerConfig = $config->handlers;
$this->cacheLogs = $debug;
if ($this->cacheLogs)
{
$this->logCache = [];
}
}
//--------------------------------------------------------------------
/**
* System is unusable.
*
* @param string $message
* @param array $context
*
* @return boolean
*/
public function emergency($message, array $context = []): bool
{
return $this->log('emergency', $message, $context);
}
//--------------------------------------------------------------------
/**
* Action must be taken immediately.
*
* Example: Entire website down, database unavailable, etc. This should
* trigger the SMS alerts and wake you up.
*
* @param string $message
* @param array $context
*
* @return boolean
*/
public function alert($message, array $context = []): bool
{
return $this->log('alert', $message, $context);
}
//--------------------------------------------------------------------
/**
* Critical conditions.
*
* Example: Application component unavailable, unexpected exception.
*
* @param string $message
* @param array $context
*
* @return boolean
*/
public function critical($message, array $context = []): bool
{
return $this->log('critical', $message, $context);
}
//--------------------------------------------------------------------
/**
* Runtime errors that do not require immediate action but should typically
* be logged and monitored.
*
* @param string $message
* @param array $context
*
* @return boolean
*/
public function error($message, array $context = []): bool
{
return $this->log('error', $message, $context);
}
//--------------------------------------------------------------------
/**
* Exceptional occurrences that are not errors.
*
* Example: Use of deprecated APIs, poor use of an API, undesirable things
* that are not necessarily wrong.
*
* @param string $message
* @param array $context
*
* @return boolean
*/
public function warning($message, array $context = []): bool
{
return $this->log('warning', $message, $context);
}
//--------------------------------------------------------------------
/**
* Normal but significant events.
*
* @param string $message
* @param array $context
*
* @return boolean
*/
public function notice($message, array $context = []): bool
{
return $this->log('notice', $message, $context);
}
//--------------------------------------------------------------------
/**
* Interesting events.
*
* Example: User logs in, SQL logs.
*
* @param string $message
* @param array $context
*
* @return boolean
*/
public function info($message, array $context = []): bool
{
return $this->log('info', $message, $context);
}
//--------------------------------------------------------------------
/**
* Detailed debug information.
*
* @param string $message
* @param array $context
*
* @return boolean
*/
public function debug($message, array $context = []): bool
{
return $this->log('debug', $message, $context);
}
//--------------------------------------------------------------------
/**
* Logs with an arbitrary level.
*
* @param mixed $level
* @param string $message
* @param array $context
*
* @return boolean
*/
public function log($level, $message, array $context = []): bool
{
if (is_numeric($level))
{
$level = array_search((int) $level, $this->logLevels);
}
// Is the level a valid level?
if (! array_key_exists($level, $this->logLevels))
{
throw LogException::forInvalidLogLevel($level);
}
// Does the app want to log this right now?
if (! in_array($level, $this->loggableLevels))
{
return false;
}
// Parse our placeholders
$message = $this->interpolate($message, $context);
if (! is_string($message))
{
$message = print_r($message, true);
}
if ($this->cacheLogs)
{
$this->logCache[] = [
'level' => $level,
'msg' => $message,
];
}
foreach ($this->handlerConfig as $className => $config)
{
if (! array_key_exists($className, $this->handlers))
{
$this->handlers[$className] = new $className($config);
}
/**
* @var \CodeIgniter\Log\Handlers\HandlerInterface
*/
$handler = $this->handlers[$className];
if (! $handler->canHandle($level))
{
continue;
}
// If the handler returns false, then we
// don't execute any other handlers.
if (! $handler->setDateFormat($this->dateFormat)->handle($level, $message))
{
break;
}
}
return true;
}
//--------------------------------------------------------------------
/**
* Replaces any placeholders in the message with variables
* from the context, as well as a few special items like:
*
* {session_vars}
* {post_vars}
* {get_vars}
* {env}
* {env:foo}
* {file}
* {line}
*
* @param mixed $message
* @param array $context
*
* @return mixed
*/
protected function interpolate($message, array $context = [])
{
if (! is_string($message))
{
return $message;
}
// build a replacement array with braces around the context keys
$replace = [];
foreach ($context as $key => $val)
{
// Verify that the 'exception' key is actually an exception
// or error, both of which implement the 'Throwable' interface.
if ($key === 'exception' && $val instanceof \Throwable)
{
$val = $val->getMessage() . ' ' . $this->cleanFileNames($val->getFile()) . ':' . $val->getLine();
}
// todo - sanitize input before writing to file?
$replace['{' . $key . '}'] = $val;
}
// Add special placeholders
$replace['{post_vars}'] = '$_POST: ' . print_r($_POST, true);
$replace['{get_vars}'] = '$_GET: ' . print_r($_GET, true);
$replace['{env}'] = ENVIRONMENT;
// Allow us to log the file/line that we are logging from
if (strpos($message, '{file}') !== false)
{
list($file, $line) = $this->determineFile();
$replace['{file}'] = $file;
$replace['{line}'] = $line;
}
// Match up environment variables in {env:foo} tags.
if (strpos($message, 'env:') !== false)
{
preg_match('/env:[^}]+/', $message, $matches);
if ($matches)
{
foreach ($matches as $str)
{
$key = str_replace('env:', '', $str);
$replace["{{$str}}"] = $_ENV[$key] ?? 'n/a';
}
}
}
if (isset($_SESSION))
{
$replace['{session_vars}'] = '$_SESSION: ' . print_r($_SESSION, true);
}
// interpolate replacement values into the message and return
return strtr($message, $replace);
}
//--------------------------------------------------------------------
/**
* Determines the current file/line that the log method was called from.
* by analyzing the backtrace.
*
* @return array
*/
public function determineFile(): array
{
// Determine the file and line by finding the first
// backtrace that is not part of our logging system.
$trace = debug_backtrace();
$file = null;
$line = null;
foreach ($trace as $row)
{
if (in_array($row['function'], ['interpolate', 'determineFile', 'log', 'log_message']))
{
continue;
}
$file = $row['file'] ?? isset($row['object']) ? get_class($row['object']) : 'unknown';
$line = $row['line'] ?? $row['function'] ?? 'unknown';
break;
}
return [
$file,
$line,
];
}
//--------------------------------------------------------------------
/**
* Cleans the paths of filenames by replacing APPPATH, SYSTEMPATH, FCPATH
* with the actual var. i.e.
*
* /var/www/site/app/Controllers/Home.php
* becomes:
* APPPATH/Controllers/Home.php
*
* @param $file
*
* @return string
*/
protected function cleanFileNames(string $file): string
{
$file = str_replace(APPPATH, 'APPPATH/', $file);
$file = str_replace(SYSTEMPATH, 'SYSTEMPATH/', $file);
$file = str_replace(FCPATH, 'FCPATH/', $file);
return $file;
}
//--------------------------------------------------------------------
}