mirror of
https://github.com/RSS-Bridge/rss-bridge.git
synced 2024-11-26 19:36:52 +03:00
951092eef3
$ composer require --dev friendsofphp/php-cs-fixer
$ echo >.php-cs-fixer.dist.php "<?php
$finder = PhpCsFixer\Finder::create()
->in(__DIR__);
$rules = [
'@PSR12' => true,
// '@PSR12:risky' => true,
'@PHP74Migration' => true,
// '@PHP74Migration:risky' => true,
// buggy, duplicates existing comment sometimes
'no_break_comment' => false,
'array_syntax' => true,
'lowercase_static_reference' => true,
'visibility_required' => false,
// Too much noise
'binary_operator_spaces' => false,
'heredoc_indentation' => false,
'trailing_comma_in_multiline' => false,
];
$config = new PhpCsFixer\Config();
return $config
->setRules($rules)
// ->setRiskyAllowed(true)
->setFinder($finder);
"
$ vendor/bin/php-cs-fixer --version
PHP CS Fixer 3.8.0 BerSzcz against war! by Fabien Potencier and Dariusz Ruminski.
PHP runtime: 8.1.7
$ vendor/bin/php-cs-fixer fix
$ rm .php-cs-fixer.cache
$ vendor/bin/php-cs-fixer fix
123 lines
3.5 KiB
PHP
123 lines
3.5 KiB
PHP
<?php
|
|
|
|
/**
|
|
* This file is part of RSS-Bridge, a PHP project capable of generating RSS and
|
|
* Atom feeds for websites that don't have one.
|
|
*
|
|
* For the full license information, please view the UNLICENSE file distributed
|
|
* with this source code.
|
|
*
|
|
* @package Core
|
|
* @license http://unlicense.org/ UNLICENSE
|
|
* @link https://github.com/rss-bridge/rss-bridge
|
|
*/
|
|
|
|
/**
|
|
* Implements functions for debugging purposes. Debugging can be enabled by
|
|
* placing a file named DEBUG in {@see PATH_ROOT}.
|
|
*
|
|
* The file specifies a whitelist of IP addresses on which debug mode will be
|
|
* enabled. An empty file enables debug mode for everyone (highly discouraged
|
|
* for public servers!). Each line in the file specifies one client in the
|
|
* whitelist. For example:
|
|
*
|
|
* * `192.168.1.72`
|
|
* * `127.0.0.1`
|
|
* * `::1`
|
|
*
|
|
* Notice: If you are running RSS-Bridge on your local machine, you need to add
|
|
* localhost (either `127.0.0.1` for IPv4 or `::1` for IPv6) to your whitelist!
|
|
*
|
|
* Warning: In debug mode your server may display sensitive information! For
|
|
* security reasons it is recommended to whitelist only specific IP addresses.
|
|
*/
|
|
class Debug
|
|
{
|
|
/**
|
|
* Indicates if debug mode is enabled.
|
|
*
|
|
* Do not access this property directly!
|
|
* Use {@see Debug::isEnabled()} instead.
|
|
*
|
|
* @var bool
|
|
*/
|
|
private static $enabled = false;
|
|
|
|
/**
|
|
* Indicates if debug mode is secure.
|
|
*
|
|
* Do not access this property directly!
|
|
* Use {@see Debug::isSecure()} instead.
|
|
*
|
|
* @var bool
|
|
*/
|
|
private static $secure = false;
|
|
|
|
/**
|
|
* Returns true if debug mode is enabled
|
|
*
|
|
* If debug mode is enabled, sets `display_errors = 1` and `error_reporting = E_ALL`
|
|
*
|
|
* @return bool True if enabled.
|
|
*/
|
|
public static function isEnabled()
|
|
{
|
|
static $firstCall = true; // Initialized on first call
|
|
|
|
if ($firstCall && file_exists(PATH_ROOT . 'DEBUG')) {
|
|
$debug_whitelist = trim(file_get_contents(PATH_ROOT . 'DEBUG'));
|
|
|
|
self::$enabled = empty($debug_whitelist) || in_array(
|
|
$_SERVER['REMOTE_ADDR'],
|
|
explode("\n", str_replace("\r", '', $debug_whitelist))
|
|
);
|
|
|
|
if (self::$enabled) {
|
|
ini_set('display_errors', '1');
|
|
error_reporting(E_ALL);
|
|
|
|
self::$secure = !empty($debug_whitelist);
|
|
}
|
|
|
|
$firstCall = false; // Skip check on next call
|
|
}
|
|
|
|
return self::$enabled;
|
|
}
|
|
|
|
/**
|
|
* Returns true if debug mode is enabled only for specific IP addresses.
|
|
*
|
|
* Notice: The security flag is set by {@see Debug::isEnabled()}. If this
|
|
* function is called before {@see Debug::isEnabled()}, the default value is
|
|
* false!
|
|
*
|
|
* @return bool True if debug mode is secure
|
|
*/
|
|
public static function isSecure()
|
|
{
|
|
return self::$secure;
|
|
}
|
|
|
|
/**
|
|
* Adds a debug message to error_log if debug mode is enabled
|
|
*
|
|
* @param string $text The message to add to error_log
|
|
*/
|
|
public static function log($text)
|
|
{
|
|
if (!self::isEnabled()) {
|
|
return;
|
|
}
|
|
|
|
$backtrace = debug_backtrace(DEBUG_BACKTRACE_IGNORE_ARGS, 3);
|
|
$calling = end($backtrace);
|
|
$message = $calling['file'] . ':'
|
|
. $calling['line'] . ' class '
|
|
. ($calling['class'] ?? '<no-class>') . '->'
|
|
. $calling['function'] . ' - '
|
|
. $text;
|
|
|
|
error_log($message);
|
|
}
|
|
}
|