friendica/src/Util/Introspection.php

108 lines
2.9 KiB
PHP
Raw Normal View History

2019-01-24 02:13:44 -05:00
<?php
2020-02-09 09:45:36 -05:00
/**
* @copyright Copyright (C) 2020, Friendica
*
* @license GNU AGPL version 3 or any later version
*
* This program is free software: you can redistribute it and/or modify
* it under the terms of the GNU Affero General Public License as
* published by the Free Software Foundation, either version 3 of the
* License, or (at your option) any later version.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU Affero General Public License for more details.
*
* You should have received a copy of the GNU Affero General Public License
* along with this program. If not, see <https://www.gnu.org/licenses/>.
*
*/
2019-01-24 02:13:44 -05:00
namespace Friendica\Util;
2019-01-24 02:13:44 -05:00
/**
* Get Introspection information about the current call
2019-01-24 02:13:44 -05:00
*/
class Introspection
2019-01-24 02:13:44 -05:00
{
private $skipStackFramesCount;
2019-01-28 05:21:48 -05:00
private $skipClassesPartials;
2019-01-24 02:13:44 -05:00
private $skipFunctions = [
'call_user_func',
'call_user_func_array',
];
/**
* @param array $skipClassesPartials An array of classes to skip during logging
* @param int $skipStackFramesCount If the logger should use information from other hierarchy levels of the call
2019-01-24 02:13:44 -05:00
*/
public function __construct($skipClassesPartials = array(), $skipStackFramesCount = 0)
2019-01-24 02:13:44 -05:00
{
$this->skipClassesPartials = $skipClassesPartials;
2019-01-24 02:13:44 -05:00
$this->skipStackFramesCount = $skipStackFramesCount;
}
/**
* Adds new classes to get skipped
* @param array $classNames
*/
public function addClasses(array $classNames)
2019-01-24 02:13:44 -05:00
{
$this->skipClassesPartials = array_merge($this->skipClassesPartials, $classNames);
2019-02-27 10:40:35 -05:00
}
/**
* Returns the introspection record of the current call
*
* @return array
*/
public function getRecord()
{
2019-01-24 02:13:44 -05:00
$trace = debug_backtrace(DEBUG_BACKTRACE_IGNORE_ARGS);
$i = 1;
2019-01-24 02:13:44 -05:00
2019-01-28 05:21:48 -05:00
while ($this->isTraceClassOrSkippedFunction($trace, $i)) {
2019-01-28 12:26:35 -05:00
$i++;
2019-01-24 02:13:44 -05:00
}
2019-01-28 05:21:48 -05:00
$i += $this->skipStackFramesCount;
2019-02-27 10:40:35 -05:00
return [
2019-02-27 11:29:32 -05:00
'file' => isset($trace[$i - 1]['file']) ? basename($trace[$i - 1]['file']) : null,
'line' => isset($trace[$i - 1]['line']) ? $trace[$i - 1]['line'] : null,
2019-02-27 10:40:35 -05:00
'function' => isset($trace[$i]['function']) ? $trace[$i]['function'] : null,
];
2019-01-24 02:13:44 -05:00
}
2019-01-28 05:21:48 -05:00
2019-01-28 12:26:35 -05:00
/**
* Checks if the current trace class or function has to be skipped
*
* @param array $trace The current trace array
2019-03-04 02:57:30 -05:00
* @param int $index The index of the current hierarchy level
*
2019-01-28 12:26:35 -05:00
* @return bool True if the class or function should get skipped, otherwise false
*/
2019-01-28 05:21:48 -05:00
private function isTraceClassOrSkippedFunction(array $trace, $index)
{
if (!isset($trace[$index])) {
return false;
}
2019-01-28 12:26:35 -05:00
if (isset($trace[$index]['class'])) {
foreach ($this->skipClassesPartials as $part) {
if (strpos($trace[$index]['class'], $part) !== false) {
return true;
}
}
} elseif (in_array($trace[$index]['function'], $this->skipFunctions)) {
return true;
}
return false;
2019-01-28 05:21:48 -05:00
}
2019-01-24 02:13:44 -05:00
}