From f10681407426c6b1cb8cfcf29fa5f2db855531d4 Mon Sep 17 00:00:00 2001 From: nguyenanhung Date: Sat, 6 Apr 2024 01:48:54 +0700 Subject: [PATCH] Release version 4.0.5 --- .github/workflows/php.yml | 2 +- .ide.purpose.php | 3 +- src/Logger.php | 116 ++++++++++++++++++++------------------ src/Project.php | 22 ++++---- src/Utils.php | 10 ++-- test/func.php | 3 +- test/test_benchmark.php | 1 + test/test_file.php | 1 + test/test_logger.php | 1 + test/test_utils.php | 1 + 10 files changed, 85 insertions(+), 75 deletions(-) diff --git a/.github/workflows/php.yml b/.github/workflows/php.yml index 0d886a7..3a73820 100644 --- a/.github/workflows/php.yml +++ b/.github/workflows/php.yml @@ -5,7 +5,7 @@ jobs: build: strategy: matrix: - operating-system: [ 'ubuntu-latest', 'macos-latest' ] + operating-system: [ 'ubuntu-latest' ] php-versions: [ '8.1', '8.2', '8.3' ] runs-on: ${{ matrix.operating-system }} steps: diff --git a/.ide.purpose.php b/.ide.purpose.php index 3076150..eb456ec 100644 --- a/.ide.purpose.php +++ b/.ide.purpose.php @@ -1,6 +1,7 @@ @@ -114,7 +114,7 @@ public function getGlobalLoggerLevel(): ?string /** * Function setGlobalLoggerLevel - Hàm cấu hình level Debug * - * @param string|null $globalLoggerLevel - Level Debug được cấu hình theo chuẩn RFC 5424 + * @param string|null $globalLoggerLevel - Level Debug được cấu hình theo chuẩn RFC 5424 * * @return $this * @author : 713uk13m @@ -126,7 +126,7 @@ public function getGlobalLoggerLevel(): ?string */ public function setGlobalLoggerLevel(string $globalLoggerLevel = null): Logger { - if (!empty($globalLoggerLevel)) { + if ( ! empty($globalLoggerLevel)) { $this->globalLoggerLevel = mb_strtolower($globalLoggerLevel); } @@ -162,7 +162,7 @@ public function getLoggerSubPath(): ?string /** * Function setLoggerPath - Hàm cấu hình thư mục lưu log - main Path * - * @param string $loggerPath Đường dẫn tới thư mục lưu log, VD: /your/to/path + * @param string $loggerPath Đường dẫn tới thư mục lưu log, VD: /your/to/path * * @return $this * @author : 713uk13m @@ -171,7 +171,7 @@ public function getLoggerSubPath(): ?string */ public function setLoggerPath(string $loggerPath = ''): Logger { - if (!empty($loggerPath)) { + if ( ! empty($loggerPath)) { $this->loggerPath = trim($loggerPath); } @@ -181,7 +181,7 @@ public function setLoggerPath(string $loggerPath = ''): Logger /** * Function setLoggerSubPath - Hàm cấu hình thư mục lưu log - sub Path * - * @param string $loggerSubPath Đường dẫn tới thư mục lưu log, VD: /your/to/sub-path + * @param string $loggerSubPath Đường dẫn tới thư mục lưu log, VD: /your/to/sub-path * * @return $this * @author : 713uk13m @@ -190,7 +190,7 @@ public function setLoggerPath(string $loggerPath = ''): Logger */ public function setLoggerSubPath(string $loggerSubPath = ''): Logger { - if (!empty($loggerSubPath)) { + if ( ! empty($loggerSubPath)) { $this->loggerSubPath = trim($loggerSubPath); } @@ -213,7 +213,7 @@ public function getLoggerFilename(): ?string /** * Function setLoggerFilename - Hàm cấu hình file lưu trữ Log * - * @param string $loggerFilename - Filename cần lưu log, VD: app.log, Log-2018-10-17.log + * @param string $loggerFilename - Filename cần lưu log, VD: app.log, Log-2018-10-17.log * * @return $this * @author : 713uk13m @@ -222,7 +222,7 @@ public function getLoggerFilename(): ?string */ public function setLoggerFilename(string $loggerFilename = ''): Logger { - if (!empty($loggerFilename)) { + if ( ! empty($loggerFilename)) { $this->loggerFilename = trim($loggerFilename); } else { $this->loggerFilename = 'Log-' . date('Y-m-d') . '.log'; @@ -247,7 +247,7 @@ public function getLoggerDateFormat(): ?string /** * Function setLoggerDateFormat - Hàm quy định Date Format cho file Log * - * @param string|null $loggerDateFormat Logger Date Format, VD: Y-m-d H:i:s u + * @param string|null $loggerDateFormat Logger Date Format, VD: Y-m-d H:i:s u * * @return $this * @author : 713uk13m @@ -259,7 +259,7 @@ public function getLoggerDateFormat(): ?string */ public function setLoggerDateFormat(string $loggerDateFormat = null): Logger { - if (!empty($loggerDateFormat)) { + if ( ! empty($loggerDateFormat)) { $this->loggerDateFormat = $loggerDateFormat; } else { $this->loggerDateFormat = "Y-m-d H:i:s u"; @@ -284,7 +284,7 @@ public function getLoggerLineFormat(): ?string /** * Function setLoggerLineFormat - Hàm cấu hình thông tin về format dòng ghi log * - * @param string|null $loggerLineFormat Line Format Input, example: [%datetime%] %channel%.%level_name%: %message% %context% %extra%\n + * @param string|null $loggerLineFormat Line Format Input, example: [%datetime%] %channel%.%level_name%: %message% %context% %extra%\n * * @return $this * @author : 713uk13m @@ -296,7 +296,7 @@ public function getLoggerLineFormat(): ?string */ public function setLoggerLineFormat(string $loggerLineFormat = null): Logger { - if (!empty($loggerLineFormat)) { + if ( ! empty($loggerLineFormat)) { $this->loggerLineFormat = $loggerLineFormat; } else { $this->loggerLineFormat = "[%datetime%] %channel%.%level_name%: %message% %context% %extra%\n"; @@ -308,10 +308,10 @@ public function setLoggerLineFormat(string $loggerLineFormat = null): Logger /** * Function log - Hàm ghi log cho hệ thống * - * @param string $level Level Debug: DEBUG, INFO, NOTICE, WARNING, ERROR, CRITICAL, ALERT, EMERGENCY - * @param string $name Log Name: log, etc... - * @param string $msg Log Message write to Log - * @param array|string $context Log Context aka Log Message Array format + * @param string $level Level Debug: DEBUG, INFO, NOTICE, WARNING, ERROR, CRITICAL, ALERT, EMERGENCY + * @param string $name Log Name: log, etc... + * @param string $msg Log Message write to Log + * @param array|string $context Log Context aka Log Message Array format * * @return bool TRUE nếu ghi log thành công, FALSE nếu ghi log thất bại, Message Error nếu có lỗi Exception xảy ra, ngoài ra các trường hợp khác sẽ trả về mã Null * @@ -321,20 +321,24 @@ public function setLoggerLineFormat(string $loggerLineFormat = null): Logger * * @example log('info', 'test', 'Log Test', []) */ - public function log(string $level = '', string $name = 'log', string $msg = 'My Message', array|string $context = array()): bool - { - if (!is_array($context)) { + public function log( + string $level = '', + string $name = 'log', + string $msg = 'My Message', + array|string $context = array() + ): bool { + if ( ! is_array($context)) { $context = array($context); } $level = mb_strtolower(trim($level)); if ($this->DEBUG === true) { - if (!class_exists(MonoLogger::class)) { + if ( ! class_exists(MonoLogger::class)) { Utils::log_message('error', 'Class Monolog not exists'); return false; } try { $loggerSubPath = trim($this->loggerSubPath); - $loggerSubPath = !empty($loggerSubPath) ? Utils::slugify($loggerSubPath) : 'Default-Sub-Path'; + $loggerSubPath = ! empty($loggerSubPath) ? Utils::slugify($loggerSubPath) : 'Default-Sub-Path'; if (empty($this->loggerFilename)) { $this->loggerFilename = 'Log-' . date('Y-m-d') . '.log'; } @@ -373,8 +377,8 @@ public function log(string $level = '', string $name = 'log', string $msg = 'My $keyLevel = MonoLevel::Warning; } $loggerFilename = $this->loggerPath . DIRECTORY_SEPARATOR . $loggerSubPath . DIRECTORY_SEPARATOR . $this->loggerFilename; - $dateFormat = !empty($this->loggerDateFormat) ? $this->loggerDateFormat : "Y-m-d H:i:s u"; - $output = !empty($this->loggerLineFormat) ? $this->loggerLineFormat : "[%datetime%] %channel%.%level_name%: %message% %context% %extra%\n"; + $dateFormat = ! empty($this->loggerDateFormat) ? $this->loggerDateFormat : "Y-m-d H:i:s u"; + $output = ! empty($this->loggerLineFormat) ? $this->loggerLineFormat : "[%datetime%] %channel%.%level_name%: %message% %context% %extra%\n"; $formatter = new MonoLineFormatter($output, $dateFormat); $stream = new MonoStreamHandler($loggerFilename, $keyLevel, self::LOG_BUBBLE, self::FILE_PERMISSION); $stream->setFormatter($formatter); @@ -401,9 +405,9 @@ public function log(string $level = '', string $name = 'log', string $msg = 'My /** * Function debug - Ghi log ở chế đô DEBUG (100): Detailed debug information. * - * @param string $name Log Name: log, etc... - * @param string $msg Log Message write to Log - * @param array|string $context Log Context aka Log Message Array format + * @param string $name Log Name: log, etc... + * @param string $msg Log Message write to Log + * @param array|string $context Log Context aka Log Message Array format * * @return bool TRUE nếu ghi log thành công, FALSE nếu ghi log thất bại, Message Error nếu có lỗi Exception xảy ra, ngoài ra các trường hợp khác sẽ trả về mã Null * @@ -413,7 +417,7 @@ public function log(string $level = '', string $name = 'log', string $msg = 'My */ public function debug(string $name = 'log', string $msg = 'My Message', array|string $context = array()): bool { - if (!is_array($context)) { + if ( ! is_array($context)) { $context = array($context); } @@ -423,9 +427,9 @@ public function debug(string $name = 'log', string $msg = 'My Message', array|st /** * Function info - INFO (200): Interesting events. Examples: User logs in, SQL logs. * - * @param string $name Log Name: log, etc... - * @param string $msg Log Message write to Log - * @param array|string $context Log Context aka Log Message Array format + * @param string $name Log Name: log, etc... + * @param string $msg Log Message write to Log + * @param array|string $context Log Context aka Log Message Array format * * @return bool TRUE nếu ghi log thành công, FALSE nếu ghi log thất bại, Message Error nếu có lỗi Exception xảy ra, ngoài ra các trường hợp khác sẽ trả về mã Null * @@ -435,7 +439,7 @@ public function debug(string $name = 'log', string $msg = 'My Message', array|st */ public function info(string $name = 'log', string $msg = 'My Message', array|string $context = array()): bool { - if (!is_array($context)) { + if ( ! is_array($context)) { $context = array($context); } @@ -445,9 +449,9 @@ public function info(string $name = 'log', string $msg = 'My Message', array|str /** * Function notice - NOTICE (250): Normal but significant events. * - * @param string $name Log Name: log, etc... - * @param string $msg Log Message write to Log - * @param array|string $context Log Context aka Log Message Array format + * @param string $name Log Name: log, etc... + * @param string $msg Log Message write to Log + * @param array|string $context Log Context aka Log Message Array format * * @return bool TRUE nếu ghi log thành công, FALSE nếu ghi log thất bại, Message Error nếu có lỗi Exception xảy ra, ngoài ra các trường hợp khác sẽ trả về mã Null * @@ -457,7 +461,7 @@ public function info(string $name = 'log', string $msg = 'My Message', array|str */ public function notice(string $name = 'log', string $msg = 'My Message', array|string $context = array()): bool { - if (!is_array($context)) { + if ( ! is_array($context)) { $context = array($context); } @@ -467,9 +471,9 @@ public function notice(string $name = 'log', string $msg = 'My Message', array|s /** * Function warning - WARNING (300): Exceptional occurrences that are not errors. - Use of deprecated APIs, poor use of an API, undesirable things that are not necessarily wrong. * - * @param string $name Log Name: log, etc... - * @param string $msg Log Message write to Log - * @param array|string $context Log Context aka Log Message Array format + * @param string $name Log Name: log, etc... + * @param string $msg Log Message write to Log + * @param array|string $context Log Context aka Log Message Array format * * @return bool TRUE nếu ghi log thành công, FALSE nếu ghi log thất bại, Message Error nếu có lỗi Exception xảy ra, ngoài ra các trường hợp khác sẽ trả về mã Null * @@ -479,7 +483,7 @@ public function notice(string $name = 'log', string $msg = 'My Message', array|s */ public function warning(string $name = 'log', string $msg = 'My Message', array|string $context = array()): bool { - if (!is_array($context)) { + if ( ! is_array($context)) { $context = array($context); } @@ -489,9 +493,9 @@ public function warning(string $name = 'log', string $msg = 'My Message', array| /** * Function error - ERROR (400): Runtime errors that do not require immediate action but should typically be logged and monitored. * - * @param string $name Log Name: log, etc... - * @param string $msg Log Message write to Log - * @param array|string $context Log Context aka Log Message Array format + * @param string $name Log Name: log, etc... + * @param string $msg Log Message write to Log + * @param array|string $context Log Context aka Log Message Array format * * @return bool TRUE nếu ghi log thành công, FALSE nếu ghi log thất bại, Message Error nếu có lỗi Exception xảy ra, ngoài ra các trường hợp khác sẽ trả về mã Null * @@ -501,7 +505,7 @@ public function warning(string $name = 'log', string $msg = 'My Message', array| */ public function error(string $name = 'log', string $msg = 'My Message', array|string $context = array()): bool { - if (!is_array($context)) { + if ( ! is_array($context)) { $context = array($context); } @@ -511,9 +515,9 @@ public function error(string $name = 'log', string $msg = 'My Message', array|st /** * Function critical - CRITICAL (500): Critical conditions. - Application component unavailable, unexpected exception. * - * @param string $name Log Name: log, etc... - * @param string $msg Log Message write to Log - * @param array|string $context Log Context aka Log Message Array format + * @param string $name Log Name: log, etc... + * @param string $msg Log Message write to Log + * @param array|string $context Log Context aka Log Message Array format * * @return bool TRUE nếu ghi log thành công, FALSE nếu ghi log thất bại, Message Error nếu có lỗi Exception xảy ra, ngoài ra các trường hợp khác sẽ trả về mã Null * @@ -523,7 +527,7 @@ public function error(string $name = 'log', string $msg = 'My Message', array|st */ public function critical(string $name = 'log', string $msg = 'My Message', array|string $context = array()): bool { - if (!is_array($context)) { + if ( ! is_array($context)) { $context = array($context); } @@ -533,9 +537,9 @@ public function critical(string $name = 'log', string $msg = 'My Message', array /** * Function alert - ALERT (550): Action must be taken immediately. - Entire website down, database unavailable, etc. This should trigger the SMS alerts and wake you up. * - * @param string $name Log Name: log, etc... - * @param string $msg Log Message write to Log - * @param array|string $context Log Context aka Log Message Array format + * @param string $name Log Name: log, etc... + * @param string $msg Log Message write to Log + * @param array|string $context Log Context aka Log Message Array format * * @return bool TRUE nếu ghi log thành công, FALSE nếu ghi log thất bại, Message Error nếu có lỗi Exception xảy ra, ngoài ra các trường hợp khác sẽ trả về mã Null * @@ -545,7 +549,7 @@ public function critical(string $name = 'log', string $msg = 'My Message', array */ public function alert(string $name = 'log', string $msg = 'My Message', array|string $context = array()): bool { - if (!is_array($context)) { + if ( ! is_array($context)) { $context = array($context); } @@ -555,9 +559,9 @@ public function alert(string $name = 'log', string $msg = 'My Message', array|st /** * Function emergency - EMERGENCY (600): Emergency: system is unusable. * - * @param string $name Log Name: log, etc... - * @param string $msg Log Message write to Log - * @param array|string $context Log Context aka Log Message Array format + * @param string $name Log Name: log, etc... + * @param string $msg Log Message write to Log + * @param array|string $context Log Context aka Log Message Array format * * @return bool TRUE nếu ghi log thành công, FALSE nếu ghi log thất bại, Message Error nếu có lỗi Exception xảy ra * @@ -567,7 +571,7 @@ public function alert(string $name = 'log', string $msg = 'My Message', array|st */ public function emergency(string $name = 'log', string $msg = 'My Message', array|string $context = array()): bool { - if (!is_array($context)) { + if ( ! is_array($context)) { $context = array($context); } diff --git a/src/Project.php b/src/Project.php index 1ff4374..1b515e7 100644 --- a/src/Project.php +++ b/src/Project.php @@ -18,16 +18,16 @@ */ interface Project { - const VERSION = '4.0.4'; + const VERSION = '4.0.5'; - /** - * Hàm lấy thông tin phiên bản Packages - * - * @return string Phiên bản hiện tại của Packages, VD: 2.0.1 - * - * @author : 713uk13m - * @copyright: 713uk13m - * @time : 9/27/18 18:32 - */ - public function getVersion(): string; + /** + * Hàm lấy thông tin phiên bản Packages + * + * @return string Phiên bản hiện tại của Packages, VD: 2.0.1 + * + * @author : 713uk13m + * @copyright: 713uk13m + * @time : 9/27/18 18:32 + */ + public function getVersion(): string; } diff --git a/src/Utils.php b/src/Utils.php index 8dde11c..044605a 100644 --- a/src/Utils.php +++ b/src/Utils.php @@ -30,7 +30,7 @@ class Utils implements Project * Hàm chuyển đổi ký tự từ tiếng Việt, * và các ký tự đặc biệt sang ký tự không dấu * - * @param string $str Chuỗi ký tự đầu vào + * @param string $str Chuỗi ký tự đầu vào * * @return string Đầu ra rà 1 chuỗi ký tự * @author: 713uk13m @@ -45,8 +45,8 @@ public static function slugify(string $str = ''): string /** * Function log_message - Call to function log_message if function exists * - * @param string $name - * @param mixed $message + * @param string $name + * @param mixed $message * @return void */ public static function log_message(string $name = '', mixed $message = ''): void @@ -54,8 +54,8 @@ public static function log_message(string $name = '', mixed $message = ''): void if (empty($name)) { $name = 'error'; } - if (function_exists('log_message') && !empty($message)) { - if (!is_string($message)) { + if (function_exists('log_message') && ! empty($message)) { + if ( ! is_string($message)) { $message = json_encode( [ $message diff --git a/test/func.php b/test/func.php index 219b484..28cc5c3 100644 --- a/test/func.php +++ b/test/func.php @@ -1,5 +1,6 @@ "; diff --git a/test/test_benchmark.php b/test/test_benchmark.php index e9a008e..83df04e 100644 --- a/test/test_benchmark.php +++ b/test/test_benchmark.php @@ -1,4 +1,5 @@