2.7.0

- [+] Хэлперы Arrays, Dataset, Strings, StringsHTML - [*] Удалена или перенесена документация - [+] хелпер-метод `_env` - [*] функция `Arris\groupDatasetByColumn` перенесена в хелпер `Arrays::groupDatasetByColumn` - [*] обновлен `.gitattributes`
ArrisFramework · Aug 7, 2023 · 23e882d · 23e882d
1 parent 38f5713
commit 23e882d
Show file tree

Hide file tree

Showing 16 changed files with 366 additions and 429 deletions.
diff --git a/.gitattributes b/.gitattributes
@@ -4,8 +4,10 @@
 .git				export-ignore
 .gitattributes      export-ignore
 .gitignore          export-ignore
+makefile            export-ignore
 _env.example.php    export-ignore
-tests              export-ignore
+phpunit.xml         export-ignore
+tests               export-ignore
 vendor              export-ignore
 docs                export-ignore
 _legacy             export-ignore

diff --git a/README.md b/README.md
@@ -4,167 +4,64 @@ Class collection for some my projects
 
 # Sub-packages
 
-* [Arris.Toolkit.Nginx](https://github.com/KarelWintersky/Arris.Toolkit.Nginx), `composer require karelwintersky/arris.toolkit.nginx`
-* [Arris.Toolkit.Sphinx](https://github.com/KarelWintersky/Arris.Toolkit.Sphinx), `composer require karelwintersky/arris.toolkit.sphinx`
-* [Arris.Toolkit.CDNNow](https://github.com/KarelWintersky/Arris.Toolkit.CDNNow), `composer require karelwintersky/arris.toolkit.cdnnow`
-* [Arris.Toolkit.CLIConsole](https://packagist.org/packages/karelwintersky/arris.toolkit.cli-console), `composer require karelwintersky/arris.toolkit.cli-console`
-* [DrCalculus](https://github.com/KarelWintersky/DrCalculus), `composer require karelwintersky/arris.drcalculus`
-* []()
-* []()
-* []()
+- Core classes
+  - [Arris.AppLogger](https://github.com/ArrisFramework/Arris.AppLogger), `composer require karelwintersky/arris.logger`
+  - [Arris.AppRouter](https://github.com/ArrisFramework/Arris.AppRouter), `composer require karelwintersky/arris.router`
+- Helpers
+  - [Arris.Helpers]
+- Utils
+  - [Arris.PHP_FileDownload](https://github.com/ArrisFramework/Arris.PHP_FileDownload), `composer require karelwintersky/arris.php-file-download`
+  - 
+- Toolkits
+  - [Arris.Toolkit.MimeTypes](https://github.com/ArrisFramework/Arris.Toolkit.MimeTypes), `composer require karelwintersky/arris.toolkit.mimetypes`
+  - [Arris.Toolkit.Nginx](https://github.com/KarelWintersky/Arris.Toolkit.Nginx), `composer require karelwintersky/arris.toolkit.nginx`
+  - [Arris.Toolkit.Sphinx](https://github.com/KarelWintersky/Arris.Toolkit.Sphinx), `composer require karelwintersky/arris.toolkit.sphinx`
 
 # How to use 
 
-* App
-* AppConfig
-* AppLogger
-* AppRouter
-* CLIConsole
-* DB, DBPool
-* Hook
-* Utils\Timer
-
 ## App - Реестр
 
-```
-$app = App::factory();  // or ::handle()
-
-$app->set(DB::class, DB::C());
-$app->set(PHPAuth::class, new PHPAuth(DB::C(), (new PHPAuthConfig())->loadENV('_env')->getConfig() ));
-```
-
-```
-$app = App::factory(); // or ::handle()
-
-$dbc = $app->get(DB::class);
-
-// or
+```php
+$app = App::factory();
 
-$dbc = (App::access())->get(DB::class); 
+$app->set('PDO', new PDO(/* params */));
+$app->set(PHPAuth::class, new PHPAuth($pdo, (new PHPAuthConfig())->loadENV('_env')->getConfig() ));
+$app->set(Smarty::class, new Smarty());
 
-$auth = $app->get(PHPAuth::class);
+$app->addService('pdo.main', new PDO());
 ```
 
-## AppConfig 
-
-???
-
-## AppLogger 
-
-```
-AppLogger::init($application, $instance, $options = []):void
-```
-
-Инициализирует класс логгера
-
-* `$application` - Имя приложения
-* `$instance` - код инстанса приложения (рекомендуется генерировать его при старте приложения и с помощью этого кода отличать логи, записанные разными инстансами приложения параллельно)
-* `$options` опции приложения:
-    * `bubbling` - [FALSE] - всплывает ли логгируемое сообщение?
-    * `default_log_level` - [Monolog::DEBUG] - уровень логгирования по умолчанию
-    * `default_logfile_path` - [''] - путь к файлам логов по умолчанию
-    * `default_logfile_prefix` - [''] - префикс файла лога по умолчанию
-    * `default_log_file` - ['_.log'] - имя файла лога по умолчанию, применяется если для имени файла передан NULL
-    * `default_handler` - [NULL], или хэндлер, реализующий \Monolog\Handler\HandlerInterface как логгер по умолчанию для этого скоупа
-    * `add_scope_to_log` - [FALSE] - добавлять ли имя скоупа к имени логгера в файле лога?
-    * `deferred_scope_creation` - [TRUE] - разрешать ли отложенную инициализацию скоупов
-    * `deferred_scope_separate_files` - [TRUE] - использовать ли разные файлы для deferred-скоупов (на основе имени скоупа)   
-
-### Add Scope
-
-```
-AppLogger::addScope($scope = null, $scope_levels = [], $scope_logging_enabled = true, $is_deferred_scope = false):void
-```
-
-Добавляет скоуп (логгер) с параметрами
-
-* `$scope` - имя скоупа
-* `$scope_levels` - массив кортежей с опциями уровней логгирования. 
-* `$scope_logging_enabled` - включено ли логгирование для этого скоупа. Это глобальная настройка для скоупа, если логгирование отключено - никакие опции, переданные в `$scope_levels` его не включат. Если этим параметром логгирование отключено (false), но скоуп создается, но для всех уровней логгирования хэндлер ставится `NullLogger`. 
-* `$is_deferred_scope` - служебный аргумент, его никогда не следует указывать напрямую (он задает создание логгера как deferred)
-
-Настройки логгеров по уровням (логгирования) передаются в массиве `$scope_levels`. Может быть передан пустой массив - тогда поставятся опции "по умолчанию" (на основе глобальных опций), а скоуп будет создан как 'deferred' (отложенная инициализация). 
-
-Пример:
-```
-AppLogger::addScope('mysql', 
-[
-    [ '__mysql.100-debug.log', Logger::DEBUG, 'enable' => true],
-    [ '__mysql.250-notice.log', Logger::NOTICE,  'enable' => true],
-    [ '__mysql.300-warning.log', Logger::WARNING,  'enable' => true],
-    [ '__mysql.400-error.log', Logger::ERROR,  'enable' => true],
-], getenv('IS_MYSQL_LOGGER_ENABLED'));
-```
+later:
 
-Параметры уровня логгирования (элементы кортежа опций):
-* Первый элемент: `filename` - имя файла (в случае отсутствия будет применено имя по умолчанию из глобальных опций)
-* Второй элемент:`logging_level` - уровень логгирования, используются числа или (что удобнее), константы `\Monolog\Logger::DEBUG` и другие из того же неймспейса.
-
-Остальные параметры передаются через ключи ассоциативного массива:
-* `enabled` - [TRUE], разрешен ли этот уровень логгирования. Применяется тот же механизм, что и для глобальной опции `$scope_logging_enabled` для скоупа;
-* `bubbling` - [FALSE], всплывает ли сообщение логгирования на следующий (более низкий) уровень?
-* `handler` - [NULL] либо хэндлер, реализующий интерфейс `Monolog\Handler\HandlerInterface`. Если указан NULL - будет использован хэндлер по умолчанию: StreamHandler, записывающий лог в файл. 
-
-*NB:* Следует отметить, что если используется необъявленный в скоупе логгер, например:
-```
-AppLogger::scope('mysql')->emergency('MYSQL EMERGENCY');
-```
-монолог проспамит этим сообщением по всем объявленным уровням. 
-
-### Usage
-
-Вызов `AppLogger::scope($scope_name)` возвращает инстанс `\Monolog\Logger`, к которому можно применить штатные методы логгирования:
-```
-debug, notice, warn, error, emergency и так далее
-```
-
-Например:
-```
-AppLogger::scope('mysql')->debug("mysql::Debug", [ ['x'], ['y']]);
-AppLogger::scope('mysql')->notice('mysql::Notice', ['x', 'y']);
-```
-
-### Deferred Scope
-
-Есть возможность использовать скоупы с отложенной инициализацией и параметрами по умолчанию. Этот механизм называется Deferred Scope.
-
-Вызов аналогичен предварительно инициализированному логгеру:
-```
-AppLogger::scope('usage')->emergency('EMERGENCY USAGE');
-```
-
-В этом случае будет создан скоуп `usage` со всеми уровнями логгирования и параметрами по умолчанию (но реальный вызов логгера произойдет только для уровня `emergency`).
+```php
+$app = App::factory(); // or ::handle()
 
-*NB:* Если при инициализации обычного скоупа методом `addScope()` передан пустой массив опций логгеров - будет применен механизм инициализации deferred-скоупа.
+$dbc = $app->get('PDO');
 
-### Примечания (usage hints)
+// or
 
-#### Один файл для нескольких уровней логгирования
+$dbc = (App::access())->get('PDO');
 
-Указываем наименьший используемый уровень логгирования (`Logger::NOTICE`) 
-```
-AppLogger::addScope('log.selectel', [ [ '_selectel_upload.log', Logger::NOTICE ]  ]);
-```
+// or
 
-Теперь вот эти два вызова запишут в файл 2 строчки 
-```
-AppLogger::scope('log.selectel')->error('Error');
-AppLogger::scope('log.selectel')->notice('Notice');
+$dbc = (App::factory())->getService('pdo.main'); 
 ```
 
-# AppRouter
-
 # CLIConsole
 
+- todo
+
 # DB 
 
-todo 
+- todo 
 
 # DBPool
 
-todo
+- todo
 
 # Hook
 
+- todo
+
 # Utils\Timer
 
diff --git a/docs/AppLogger.md b/docs/AppLogger.md