Convert

\nn\t3::Convert()

Konvertieren von Arrays zu Models, Models zu JSONs, Arrays zu ObjectStorages, Hex-Farben zu RGB und vieles mehr, was irgendwie mit Konvertieren von Dingen zu tun hat.

Overview of Methods

\nn\t3::Convert()->toArray($obj = NULL, $depth = 3);

Konvertiert ein Model in ein Array Alias zu nnt3::Obj()->toArray();

Bei Memory-Problemen wegen Rekursionen: Max-Tiefe angebenen!

\nn\t3::Convert($model)->toArray(2);
\nn\t3::Convert($model)->toArray();      => ['uid'=>1, 'title'=>'Beispiel', ...]

@return array

\nn\t3::Convert()->toBytes();

Konvertiert eine für Menschen lesbare Angabe von Bytes/Megabytes in einen Byte-Integer. Extrem tolerant, was Leerzeichen, Groß/Klein-Schreibung und Kommas statt Punkten angeht.

\nn\t3::Convert('1M')->toBytes();    // -> 1048576
\nn\t3::Convert('1 MB')->toBytes();  // -> 1048576
\nn\t3::Convert('1kb')->toBytes();   // -> 1024
\nn\t3::Convert('1,5kb')->toBytes(); // -> 1024
\nn\t3::Convert('1.5Gb')->toBytes(); // -> 1610612736

Für den umgekehrten Weg (Bytes zu menschenlesbarer Schreibweise wie 1024 -> 1kb) gibt es einen praktischen Fluid ViewHelper im Core:

{fileSize->f:format.bytes()}

@return integer

\nn\t3::Convert()->toFileReference();

Konvertiert ein \TYPO3\CMS\Core\Resource\FileReference (oder seine uid) in eine \TYPO3\CMS\Extbase\Domain\Model\FileReference

\nn\t3::Convert( $input )->toFileReference() => \TYPO3\CMS\Extbase\Domain\Model\FileReference

@param $input Kann \TYPO3\CMS\Core\Resource\FileReference oder uid davon sein

@return \TYPO3\CMS\Extbase\Domain\Model\FileReference

\nn\t3::Convert()->toIso();

Konvertiert (normalisiert) einen String zu ISO-8859-1

\nn\t3::Convert('äöü')->toIso();

@return string

\nn\t3::Convert()->toJson($obj = NULL, $depth = 3);

Konvertiert ein Model in ein JSON

\nn\t3::Convert($model)->toJson()        => ['uid'=>1, 'title'=>'Beispiel', ...]

@return array

\nn\t3::Convert()->toModel($className = NULL, $parentModel = NULL);

Konvertiert ein Array in ein Model.

\nn\t3::Convert($array)->toModel( \Nng\Model\Name::class )       => \Nng\Model\Name

Kann auch automatisch FileReferences erzeugen. In diesem Bespiel wird ein neues Model des Typs \Nng\Model\Name erzeugt und danach in der Datenbank persistiert. Das Feld falMedia ist eine ObjectStorage mit FileReferences. Die FileReferences werden automatisch erzeugt!

$data = [
    'pid' => 6,
    'title' => 'Neuer Datensatz',
    'description' => 'Der Text',
    'falMedia' => [
        ['title'=>'Bild 1', 'publicUrl'=>'fileadmin/_tests/5e505e6b6143a.jpg'],
        ['title'=>'Bild 2', 'publicUrl'=>'fileadmin/_tests/5e505fbf5d3dd.jpg'],
        ['title'=>'Bild 3', 'publicUrl'=>'fileadmin/_tests/5e505f435061e.jpg'],
    ]
];
$newModel = \nn\t3::Convert( $data )->toModel( \Nng\Model\Name::class );
$modelRepository->add( $newModel );
\nn\t3::Db()->persistAll();

Beispiel: Aus einem Array einen News-Model erzeugen:

$entry = [
    'pid'           => 12,
    'title'         => 'News-Titel',
    'description'   => '<p>Meine News</p>',
    'falMedia'      => [['publicUrl' => 'fileadmin/bild.jpg', 'title'=>'Bild'], ...],
    'categories'    => [1, 2]
];
$model = \nn\t3::Convert( $entry )->toModel( \GeorgRinger\News\Domain\Model\News::class );
$newsRepository->add( $model );
\nn\t3::Db()->persistAll();

Hinweis Um ein bereits existierendes Model mit Daten aus einem Array zu aktualisieren gibt es die Methode $updatedModel = \nn\t3::Obj( $prevModel )->merge( $data );

@return mixed

\nn\t3::Convert()->toObjectStorage($obj = NULL, $childType = NULL);

Konvertiert etwas in eine ObjectStorage

\nn\t3::Convert($something)->toObjectStorage()
\nn\t3::Convert($something)->toObjectStorage( \My\Child\Type::class )

\nn\t3::Convert()->toObjectStorage([['uid'=>1], ['uid'=>2], ...], \My\Child\Type::class )
\nn\t3::Convert()->toObjectStorage([1, 2, ...], \My\Child\Type::class )

@return ObjectStorage

\nn\t3::Convert()->toRGB();

Konvertiert einen Farbwert in ein anderes Zahlenformat

\nn\t3::Convert('#ff6600')->toRGB(); // -> 255,128,0

@return string

\nn\t3::Convert()->toSysCategories();

Konvertiert eine Liste in eine ObjectStorage mit SysCategory

Noch nicht implementiert!

@return ObjectStorage

\nn\t3::Convert()->toUTF8();

Konvertiert (normalisiert) einen String zu UTF-8

\nn\t3::Convert('äöü')->toUTF8();

@return string