dhluther/yii2-swivel

A Yii 2.0 plugin to provide easy access and integration with zumba/swivel

3.0.1 2023-12-22 17:07 UTC

Requires

• php: ~8.0.0|~8.1.0|~8.2.0|~8.3.0
• psr/log: ^1.0.0 | ^2.0 | ^3.0
• yiisoft/yii2: ~2.0.40
• zumba/swivel: ^4.0

Requires (Dev)

• codeception/codeception: ^5.0
• codeception/module-asserts: *
• codeception/module-datafactory: *
• codeception/module-yii2: *
• phpunit/phpunit-selenium: *
• yiisoft/yii2-coding-standards: ^2.0
• yiisoft/yii2-faker: *

BSD-3-Clause

• Dana Luther

• extension
• Behavior
• component
• helper
• yii2
• swivel

README

This plugin provides the necessary elements for using Swivel in a Yii 2.0+ Application.

This plugin is based on the zumba/swivel-cake plugin.

Configuration for Yii Component:

 'swivel' => [ 
 	'class'=>'dhluther\swivel\SwivelComponent' 
 ],

Access from the application

// If the user has the feature behavior bucket enabled, use the testFeature.New.Something behavior,
// else use the default
Yii::$app->swivel->forFeature( 'testFeature' )
	->addBehavior('New.Something', [$this,'doSomethingB'], $args)
	->defaultBehavior([$this, 'doSomethingA'], $args )
	->execute();

// If the user has the feature behavior bucket enabled, use the first callable,
// else use the second callable (default)
Yii::$app->swivel->invoke('testFeature.New.Something', [$this,'doSomethingB'],[$this, 'doSomethingA']);

Make sure that your bootstrap file is set to properly include the composer autoloader.

In the index.php bootstrap:

require(__DIR__ . '/../vendor/autoload.php');

Add the swivel migration namespace to your migration command config

'migrationNamespaces'=>[
    'dhluther\\swivel\\migrations'
]

with the alias of:

'@dhluther\swivel'=>'@vendor/dhluther/yii2-swivel/src'

If you've already migrated this package in the past and want to mark it to the current migratoin via namespace, the command is

./yii migrate/mark dhluther\\swivel\\migrations\\m190812_083802

To add the composer vendor libraries for local development:

docker run --rm -v $PWD:/app composer update

The Swivel Libraries

https://github.com/zumba/swivel

https://github.com/zumba/swivel-cake