karelwintersky / arris

2.203.0 2026-09-09 18:05 UTC

Requires

• php: ^8.2
• ext-curl: *
• ext-intl: *
• ext-json: *
• ext-mbstring: *
• ext-pdo: *
• ext-readline: *
• ext-simplexml: *
• karelwintersky/arris.config: ^1
• psr/log: *

Requires (Dev)

• phpunit/phpunit: ^10
• predis/predis: ^2.0
• scrutinizer/ocular: ^1.9
• squizlabs/php_codesniffer: ^3.6
• symfony/var-dumper: ^5.4
• symfony/yaml: ^5.4

Suggests

• karelwintersky/arris.cli: Arris µFramework - CLIConsole helper
• karelwintersky/arris.entity: Arris µFramework: Entity Types
• karelwintersky/arris.entity.path: Arris µFramework: Path builder
• karelwintersky/arris.helpers: Arris µFramework: helpers
• karelwintersky/arris.logger: Arris µFramework: AppLogger class
• karelwintersky/arris.presenter: Arris µFramework: Presenter engine
• karelwintersky/arris.request: Arris µFramework: Fluent request data reader (standalone)
• karelwintersky/arris.router: Arris µFramework: AppRouter class
• karelwintersky/arris.toolkit.cli-console: Arris µFramework - CLIConsole helper
• league/csv: CSV data manipulation made easy in PHP
• nette/utils: Various helpers
• php-sage/sage: Sage - Insightful PHP debugging assistant, pretty replacement for var_dump() and debug_backtrace().
• psr/container: ^2.0
• psr/simple-cache: ^3.0
• ramsey/collection: *
• sabre/event: sabre/event is a library for lightweight event-based programming (more complexity than Arris/Hook)
• symfony/string: Symfony String component
• symfony/yaml: ^5.4

MIT

• Karel Wintersky

• logging
• routing
• console
• app
• hooks

Published on Packagist.org on 2026-09-09 18:07 UTC

README

Class collection for some my projects

Sub-packages

The Arris ecosystem is split into separate composer packages; each package is a repository under /var/www.arris/ and ships its own AGENTS.md. Install the ones you need: composer require karelwintersky/<package>.

Core

This package — arris — the framework core itself: App singleton, AppErrorHandler, Hook events, Controllers\AbstractController, global helpers, Core\Dot, PSR-16 compatible cache.

Companion core packages:

• arris.config — config reader/writer, AppConfig. composer require karelwintersky/arris.config
• arris.entity — entity types for the framework. composer require karelwintersky/arris.entity
• arris.entity.path — path builder. composer require karelwintersky/arris.entity.path
• arris.entity.url — URL builder. composer require karelwintersky/arris.entity.url
• arris.logger — application logger. composer require karelwintersky/arris.logger
• arris.router — application router. composer require karelwintersky/arris.router
• arris.cache — cache engine. composer require karelwintersky/arris.cache
• arris.catcher — exception catcher: error dump with call hierarchy or a safe stub. composer require karelwintersky/arris.catcher
• arris.presenter — presenter with lazy Smarty wrapper. composer require karelwintersky/arris.presenter

Toolkits

• arris.toolkit.cli-console — CLI console helper. composer require karelwintersky/arris.toolkit.cli-console
• arris.toolkit.firewall — IP filtering. composer require karelwintersky/arris.toolkit.firewall
• arris.toolkit.mimetypes — MimeType ↔ extension resolver. composer require karelwintersky/arris.toolkit.mimetypes
• arris.toolkit.nanoredis — minimal Redis client. composer require karelwintersky/arris.toolkit.nanoredis
• arris.php-file-download — file download helper. composer require karelwintersky/arris.php-file-download
• arris.php-file-upload — file upload with validation and conversion. composer require karelwintersky/arris.php-file-upload

// Добавление в конфиг
App::factory()->addConfig([
    'smarty'    =>  [
        'path_template' =>  self::$path_install->join('templates'),
        'path_cache'    =>  self::$path_install->join('cache')
    ]
]);

Global helpers config() / app()

Helpers config() and app() are not hard-bound to Arris\App — they use the application class registered in the framework. This matters when your project has its own app class extending Arris\App (e.g. App\App): without registration the helpers would build a fresh Arris\App instance instead of touching yours.

Register your class once at bootstrap, before any helper call:

use Arris\App;
use App\App as MyApp;

MyApp::setApplicationClass(MyApp::class);
// ... или как зарегистрированный инстанс-класс
App::setApplicationClass(MyApp::class);

config('database.host');  // теперь читает конфиг MyApp-инстанса
app();                    // возвращает MyApp-инстанс (соблюдение singleton)

The given class must extend Arris\App, otherwise RuntimeException is thrown. If nothing was registered (setApplicationClass() was not called) the helpers fall back to Arris\App.