Slim Flash Messages Download - Slim Flash Messages Quellcode herunterladen

Schlanke Flash -Nachrichten

Mit dieser Bibliothek können Sie temporäre Nachrichten in Ihrem schlanken Projekt verwenden. Es kann leicht in das Twig -Vorlagensystem integriert werden, über eine Erweiterung, die Funktionen zum Greifen und Gebrauch in der Vorlage bietet. Es ist nicht darauf beschränkt, einfache Nachrichtenzeichenfolgen zu erstellen, sondern auch die Verwendung anderer Datentypen wie Arrays.

Installieren

composer require williamsampaio/slim-flash-messages

Verwendungsbeispiele (Slim 4)

 // app/dependencies.php

//...
use SlimFlashMessages  Flash ;
use SlimFlashMessages  FlashProviderInterface ;

return function ( ContainerBuilder $ containerBuilder ) {
    $ containerBuilder -> addDefinitions ([
        //...
        FlashProviderInterface::class => function () {
            return Flash:: getInstance ();
        },
    ]);
};

 // app/middleware.php

//...
// use SlimFlashMessagesFlashMiddleware;
use SlimFlashMessages  FlashTwigExtension ;

return function ( App $ app ) {
    //...
    // Optional if you are working with dependency injection,
    // using the middleware is only useful if you need to obtain the Flash instance from request.
    // $app->add(FlashMiddleware::createFromContainer($app));

    // With Twig
    $ twig = Twig:: create ( __DIR__ . ' /../templates ' , [ ' cache ' => false ]);
    $ twig -> addExtension (FlashTwigExtension:: createFromContainer ( $ app ));
    $ app -> add (TwigMiddleware:: create ( $ app , $ twig ));
};

 // Your controller

//...
use Slim  Views  Twig ;
// use SlimFlashMessagesFlashProvider;
use SlimFlashMessages  FlashProviderInterface ;

class YourController
{
    private $ flash ;
    private $ view ;

    public function __construct ( FlashProviderInterface $ flash , Twig $ view )
    {
        $ this -> flash = $ flash ;
        $ this -> view = $ view ;
    }

    public function index ( ServerRequestInterface $ request , ResponseInterface $ response )
    {
        // If you are working with middleware instead of dependency injection it will be this way.
        // $flash = FlashProvider::fromRequest($request);

        $ this -> flash -> add ( ' messages ' , ' Hello! ' );

        return $ this -> view -> render ( $ response , ' template.twig ' );
    }

    //...
}

 {# template.twig #}
{% for msg in flash( ' messages ' ) %}
    {{ msg }}
{% endfor %}

Einfachste möglich

Die Twig -Integration ist nicht obligatorisch, wie Sie in diesem Beispiel sehen können, wo der Fokus auf der Demonstration der Messaging -Anbieter -API liegt.

 <?php

use Psr  Http  Message  ResponseInterface as Response ;
use Psr  Http  Message  ServerRequestInterface as Request ;
use Slim  Factory  AppFactory ;
use SlimFlashMessages  Flash ;
use SlimFlashMessages  FlashMiddleware ;
use SlimFlashMessages  FlashProvider ;

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

// Important! if the storage is not passed to the constructor,
// $_SESSION will be used
$ flash = Flash:: getInstance ();

// Create App
$ app = AppFactory:: create ();
$ app -> setBasePath ( ' /example1 ' );  // Optional

// Add FlashMiddleware
$ app -> add ( new FlashMiddleware ( $ flash ));

$ app -> addErrorMiddleware ( true , true , true );

$ app -> get ( ' / ' , function ( Request $ request , Response $ response , $ args ) {
    // Get FlashProvider from request
    // FlashMiddleware previously took care of adding the FlashProvider to the request
    $ flash = FlashProvider:: fromRequest ( $ request );

    // Clear all stored values
    $ flash -> clearAll ();

    // The 'add' method allows you to add a flash message or data (as an array, if you prefer!)
    $ flash -> add ( ' simple ' , ' Hello World! 1 ' );

    $ flash -> add ( ' messages ' , [
        ' status ' => ' success ' ,
        ' text ' => ' 1. PHP is the best! '
    ]);

    echo ' <pre> ' ;

    var_dump ( $ flash -> getAll ());

    // Checks if the key is defined in the storage
    var_dump ( $ flash -> has ( ' messages ' ));

    // Clear a key defined
    $ flash -> clear ( ' messages ' );

    var_dump ( $ flash -> getAll ());
    var_dump ( $ flash -> has ( ' messages ' ));

    $ flash -> add ( ' simple ' , ' Hello World! 2 ' );
    $ flash -> add ( ' simple ' , ' Hello World! 3 ' );

    var_dump ( $ flash -> getAll ());

    // Get first item from key
    var_dump ( $ flash -> get_first ( ' simple ' ));
    // or to pick up and remove first item.
    // var_dump($flash->get_first('simple', true));

    // Get last item from key
    // var_dump($flash->get_last('simple'));
    // or to pick up and remove last item.
    var_dump ( $ flash -> get_last ( ' simple ' , true ));

    var_dump ( $ flash -> get ( ' simple ' ));

    return $ response ;
});

$ app -> run ();

Mit Behälter

In diesem Beispiel wird der PHP-DI-Container und Slim/Twig-View verwendet.

 <?php

use DI  Container ;
use Psr  Http  Message  ResponseInterface as Response ;
use Psr  Http  Message  ServerRequestInterface as Request ;
use Slim  Factory  AppFactory ;
use Slim  Views  Twig ;
use Slim  Views  TwigMiddleware ;
use SlimFlashMessages  Flash ;
use SlimFlashMessages  FlashMiddleware ;
use SlimFlashMessages  FlashProvider ;
use SlimFlashMessages  FlashProviderInterface ;
use SlimFlashMessages  FlashTwigExtension ;

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

// Create a new DI Container
$ container = new Container ();

// Add a FlashProvider to the container
$ container -> set (FlashProviderInterface::class, function () {
    // Important! if the storage is not passed to the constructor,
    // $_SESSION will be used
    return Flash:: getInstance ();
});

// Set container to create App with on AppFactory
AppFactory:: setContainer ( $ container );
$ app = AppFactory:: create ();

$ app -> setBasePath ( ' /example2 ' );  // Optional

// Add FlashMiddleware from container
$ app -> add (FlashMiddleware:: createFromContainer ( $ app ));

// Create Twig and add FlashTwigExtension
$ twig = Twig:: create ( __DIR__ . ' /templates ' , [ ' cache ' => false ]);
$ twig -> addExtension (FlashTwigExtension:: createFromContainer ( $ app ));

// Add Twig-View Middleware
$ app -> add (TwigMiddleware:: create ( $ app , $ twig ));

$ app -> addErrorMiddleware ( true , true , true );

$ app -> get ( ' / ' , function ( Request $ request , Response $ response , $ args ) {
    // Get Twig and FlashProvider from request
    $ view = Twig:: fromRequest ( $ request );

    // FlashMiddleware previously took care of adding the FlashProvider to the request
    $ flash = FlashProvider:: fromRequest ( $ request , ' flash ' );

    $ alerts = [ ' primary ' , ' secondary ' , ' success ' , ' danger ' , ' warning ' , ' info ' , ' light ' , ' dark ' ];

    // The 'add' method allows you to add a flash message or data (as an array, if you prefer!)
    $ flash -> add ( ' simple ' , ' Hello World! ' );

    $ flash -> add ( ' messages ' , [
        ' alert ' => $ alerts [ array_rand ( $ alerts )],
        ' text ' => ' 1. PHP is the best! '
    ]);

    $ flash -> add ( ' messages ' , [
        ' alert ' => $ alerts [ array_rand ( $ alerts )],
        ' text ' => ' 2. Slim Framework is amazing! '
    ]);

    $ flash -> add ( ' messages ' , [
        ' alert ' => $ alerts [ array_rand ( $ alerts )],
        ' text ' => ' 3. Lorem ipsum! '
    ]);

    return $ view -> render ( $ response , ' template.html.twig ' , [
        ' page ' => ' Slim Flash Messages ' ,
    ]);
});

$ app -> run ();

In Vorlage:

{% for msg in flash( ' messages ' ) %}
< div class = " alert alert-{{ msg . alert }} alert-dismissible fade show " role = " alert " >
    {{ msg . text }}
    < button type = " button " class = " btn-close " data-bs-dismiss = " alert " aria-label = " Close " ></ button >
</ div >
{% endfor %}

Diese Beispiele ausführen

Der einfachste Weg, diese Beispiele durchzuführen, ist Docker.

git clone https://github.com/WilliamSampaio/Slim-Flash-Messages.git
cd Slim-Flash-Messages
docker compose up -d --build

Wenn Sie den UP -Prozess abschließen, zugreifen Sie:

Beispiel 1: http: // localhost: 8080/Beispiel1/
Beispiel 2: http: // localhost: 8080/example2/
Codeabdeckung: http: // localhost: 8080/deckung/index.html

Benutzerdefinierte Zweigfunktionen

FlashTwigExtension stellt diese Funktionen Ihren Zweigvorlagen zur Verfügung.

Blitz()

Es empfängt zwei optionale Parameter, key (String/Null = NULL ) und clear (bool = true ) .

key : Wenn nicht angegeben wird, wird ein Array mit allen im Speicher gespeicherten Daten zurückgegeben, andernfalls wird nur das Array mit den vom Schlüsselwert indizierten Daten zurückgegeben.
clear : Wenn dies falsch ist, werden die Elemente nach dem Aufrufen der Funktion nicht aus dem Speicher entfernt.

{% for msg in flash( ' messages ' , false ) %}
< div class = " alert alert-{{ msg . alert }} alert-dismissible fade show " role = " alert " >
    {{ msg . text }}
    < button type = " button " class = " btn-close " data-bs-dismiss = " alert " aria-label = " Close " ></ button >
</ div >
{% endfor %}

Flash_First ()

Es empfängt zwei Parameter, key (Zeichenfolge) und remove (bool = true ) .

key : Erstes Element aus dem Array mit den vom Schlüsselwert indizierten Daten wird zurückgegeben.
remove (optional): Wenn falsch ist, wird das Element nach dem Aufrufen der Funktion nicht aus dem Speicher entfernt.

{% set first = flash_first( ' messages ' ) %}
< div class = " alert alert-{{ first . alert }} alert-dismissible fade show " role = " alert " >
    {{ first . text }}
    < button type = " button " class = " btn-close " data-bs-dismiss = " alert " aria-label = " Close " ></ button >
</ div >

flash_last ()

Es empfängt zwei Parameter, key (Zeichenfolge) und remove (bool = true ) .

key : Letzter Element aus dem Array mit den vom Schlüsselwert indizierten Daten wird zurückgegeben.
remove (optional): Wenn falsch ist, wird das Element nach dem Aufrufen der Funktion nicht aus dem Speicher entfernt.

{% set last = flash_last( ' messages ' ) %}
< div class = " alert alert-{{ last . alert }} alert-dismissible fade show " role = " alert " >
    {{ last . text }}
    < button type = " button " class = " btn-close " data-bs-dismiss = " alert " aria-label = " Close " ></ button >
</ div >

flash_has ()

Es empfängt eine Parameter, key (Zeichenfolge) . Überprüft, ob im Speicher ein Schlüssel definiert ist. Return true oder false .

key : Der Schlüssel, der überprüft wird.

{{ flash_has( ' messages ' ) ? ' exists! ' : " it doesn't exist... " }}

flash_clear ()

Es empfängt eine optionale Parameter, key (Zeichenfolge) . Entfernt Daten aus der Speicherung. Rückkehr void .

key (optional): Der Schlüssel, der entfernt wird. Wenn nicht definiert, werden alle Daten aus dem Speicher entfernt.

{{ flash_clear( ' messages ' ) }}

Tests

Um die Testsuite auszuführen, müssen Sie das Repository klonen und die Abhängigkeiten installieren.

git clone https://github.com/WilliamSampaio/Slim-Flash-Messages.git
cd Slim-Flash-Messages
composer install
composer test
# Or
# composer coverage

Lizenz

Die MIT -Lizenz (MIT). Weitere Informationen finden Sie unter Lizenzdatei.

Expandieren

Slim Flash Messages

Schlanke Flash -Nachrichten

Installieren

Verwendungsbeispiele (Slim 4)

Einfachste möglich

Mit Behälter

Diese Beispiele ausführen

Benutzerdefinierte Zweigfunktionen

Blitz()

Flash_First ()

flash_last ()

flash_has ()

flash_clear ()

Tests

Lizenz

Adobe Flash Player

SXW Flash gesamtes Site-System [SXW Flash CMS]

CXT Flash gesamte Website

SXW Flash gesamte Website

Flash 8-Hilfe

Macromedia Flash

chat.petals.dev

GPT Prompt Templates

GPTyped

crewapp haxclient

GrocerEase

ruffle web player

Google Dorks

shepherd

mongo express