Methoden Migration REDAXO 5 → 6

Diese Dokumentation zeigt die Änderungen an Methodennamen und -signaturen zwischen REDAXO 5.x und REDAXO 6.x.

Umbenannte Methoden

Addon-Klassen

Klasse	REDAXO 5.x Methode	REDAXO 6.x Methode
`Addon`	`getRegisteredPackages()`	`getRegisteredAddons()`
`Addon`	`getInstalledPackages()`	`getInstalledAddons()`
`Addon`	`getAvailablePackages()`	`getAvailableAddons()`
`Addon`	`getSetupPackages()`	`getSetupAddons()`
`Addon`	`getSystemPackages()`	`getSystemAddons()`

Console-Klassen

Klasse	REDAXO 5.x Methode	REDAXO 6.x Methode
`AbstractCommand`	`getPackage()`	`getAddon()`
`AbstractCommand`	`setPackage()`	`setAddon()`

Content-Klassen

Klasse	REDAXO 5.x Methode	REDAXO 6.x Methode
`ArticleContentBase`	`getClang()`	`getClangId()`
`ArticleSlice`	`getClang()`	`getClangId()`
`StructureElement`	`getClang()`	`getClangId()`

MediaManager-Klassen

Klasse	REDAXO 5.x Methode	REDAXO 6.x Methode
`ManagedMedia`	`getImageWidth()`	`getWidth()`
`ManagedMedia`	`getImageHeight()`	`getHeight()`

Mailer-Klasse

Klasse	REDAXO 5.x Methode	REDAXO 6.x Methode
`Mailer`	`setLog()`	`setArchive()`

Form-Klassen

Klasse	REDAXO 5.x Methode	REDAXO 6.x Methode	Hinweis
`AbstractForm`	`addLinklistField()`	`addArticleField()`	Neue Signatur
`AbstractForm`	`addLinkmapField()`	`addArticleField()`
`AbstractForm`	`addMedialistField()`	`addMediaField()`	Neue Signatur

Security-Klassen

Klasse	REDAXO 5.x Methode	REDAXO 6.x Methode
`PasswordPolicy`	`getRule()`	`getDescription()`

Cronjob-Klassen

Klasse	REDAXO 5.x Methode	REDAXO 6.x Methode
`CronjobManager`	`getManager()`	`getExecutor()`
`CronjobManager`	`hasManager()`	`hasExecutor()`

Verschobene statische Methoden

Von `Core` nach `Util\Version`

REDAXO 5.x	REDAXO 6.x
`rex::getVersionHash()`	`Util\Version::gitHash()`

Von `Util\Str` nach `Util\Version`

REDAXO 5.x	REDAXO 6.x
`rex_string::versionSplit()`	`Util\Version::split()`
`rex_string::versionCompare()`	`Util\Version::compare()`

Von `View\View` nach `View\Asset`

REDAXO 5.x	REDAXO 6.x
`rex_view::addCssFile()`	`View\Asset::addCssFile()`
`rex_view::getCssFiles()`	`View\Asset::getCssFiles()`
`rex_view::addJsFile()`	`View\Asset::addJsFile()`
`rex_view::getJsFiles()`	`View\Asset::getJsFiles()`
`rex_view::getJsFilesWithOptions()`	`View\Asset::getJsFilesWithOptions()`
`rex_view::setJsProperty()`	`View\Asset::setJsProperty()`
`rex_view::getJsProperties()`	`View\Asset::getJsProperties()`
`rex_view::setFavicon()`	`View\Asset::setFavicon()`
`rex_view::getFavicon()`	`View\Asset::getFavicon()`

Von `View\View` nach `View\Message`

REDAXO 5.x	REDAXO 6.x
`rex_view::error()`	`View\Message::error()`
`rex_view::info()`	`View\Message::info()`
`rex_view::message()`	`View\Message::message()`
`rex_view::success()`	`View\Message::success()`
`rex_view::warning()`	`View\Message::warning()`

Konstruktor-Änderungen

Klassen mit Factory-Methode statt Konstruktor

Klasse	REDAXO 5.x	REDAXO 6.x
`BackendPasswordPolicy`	`new rex_backend_password_policy()`	`BackendPasswordPolicy::factory()`
`LogFile`	`new rex_log_file()`	`LogFile::factory()`

Exception-Erstellung

// REDAXO 5.x
throw new rex_exception('Fehlermeldung');

// REDAXO 6.x
use Redaxo\Core\Exception\RuntimeException;
throw RuntimeException::create('Fehlermeldung');

// Alternativ
throw new RuntimeException('Fehlermeldung');

Entfernte Parameter

Util\Str::buildQuery()

// REDAXO 5.x
rex_string::buildQuery($params, $delimiter);  // 2. Parameter entfernt

// REDAXO 6.x
use Redaxo\Core\Util\Str;
Str::buildQuery($params);  // Nur noch 1 Parameter

URL-Methoden

Folgende Methoden haben den $separator-Parameter verloren:

Klasse	Methode
`UrlProviderInterface`	`getUrl()`
`Url`	`frontendController()`
`Url`	`backendController()`
`Url`	`backendPage()`
`Url`	`currentBackendPage()`
`Url`	`article()`
`AbstractForm`	`getUrl()`
`DataList`	`getUrl()`
`DataList`	`getParsedUrl()`
`StructureElement`	`getUrl()`
`MediaManager`	`getUrl()`

Markdown-Methoden

// REDAXO 5.x
rex_markdown::parse($content, $softLineBreaks);  // 2. Parameter: bool
rex_markdown::parseWithToc($content, $level1, $level2, $softLineBreaks);  // 4. Parameter: bool

// REDAXO 6.x - Bool durch Options-Array ersetzt
use Redaxo\Core\Util\Markdown;
Markdown::parse($content, [Markdown::SOFT_LINE_BREAKS => false]);
Markdown::parseWithToc($content, $level1, $level2, [Markdown::SOFT_LINE_BREAKS => false]);

Hinzugefügte Parameter

Form Field-Methoden

// REDAXO 5.x
$form->addLinklistField($name);
$form->addMedialistField($name);

// REDAXO 6.x
use Redaxo\Core\Form\AbstractForm;
$form->addArticleField($name, $value = null, $arguments = ['multiple' => true]);
$form->addMediaField($name, $value = null, $arguments = ['multiple' => true]);

Geänderte Extension Point Namen

// REDAXO 5.x → REDAXO 6.x
'PACKAGE_CACHE_DELETED'                → 'ADDON_CACHE_DELETED'
'STRUCTURE_CONTENT_SLICE_ADDED'        → 'SLICE_ADDED'
'STRUCTURE_CONTENT_SLICE_UPDATED'      → 'SLICE_UPDATED'
'STRUCTURE_CONTENT_SLICE_DELETED'      → 'SLICE_DELETED'

Codebeispiele

Beispiel: Version abrufen

// REDAXO 5.x
$hash = rex::getVersionHash();
$parts = rex_string::versionSplit('1.2.3');
$compare = rex_string::versionCompare('1.2.3', '1.2.0', '>');

// REDAXO 6.x
use Redaxo\Core\Util\Version;
$hash = Version::gitHash();
$parts = Version::split('1.2.3');
$compare = Version::compare('1.2.3', '1.2.0', '>');

Beispiel: Assets hinzufügen

// REDAXO 5.x
rex_view::addCssFile('/assets/myaddon/styles.css');
rex_view::addJsFile('/assets/myaddon/script.js');

// REDAXO 6.x
use Redaxo\Core\View\Asset;
Asset::addCssFile('/assets/myaddon/styles.css');
Asset::addJsFile('/assets/myaddon/script.js');

Beispiel: Nachrichten ausgeben

// REDAXO 5.x
echo rex_view::error('Fehler aufgetreten');
echo rex_view::success('Erfolgreich gespeichert');
echo rex_view::info('Information');

// REDAXO 6.x
use Redaxo\Core\View\Message;
echo Message::error('Fehler aufgetreten');
echo Message::success('Erfolgreich gespeichert');
echo Message::info('Information');

Beispiel: Sprach-ID abrufen

// REDAXO 5.x
$article = rex_article::get($id);
$clangId = $article->getClang();  // Methode umbenannt

// REDAXO 6.x
use Redaxo\Core\Content\Article;
$article = Article::get($id);
$clangId = $article->getClangId();  // Korrekter Methodenname

Beispiel: Add-on-Methoden

// REDAXO 5.x
$addons = rex_addon::getAvailablePackages();
$systemAddons = rex_addon::getSystemPackages();

// REDAXO 6.x
use Redaxo\Core\Addon\Addon;
$addons = Addon::getAvailableAddons();
$systemAddons = Addon::getSystemAddons();

Beispiel: Bildgrößen abrufen

// REDAXO 5.x
$media = rex_managed_media::get($filename);
$width = $media->getImageWidth();
$height = $media->getImageHeight();

// REDAXO 6.x
use Redaxo\Core\MediaManager\ManagedMedia;
$media = ManagedMedia::get($filename);
$width = $media->getWidth();
$height = $media->getHeight();

Methoden Migration REDAXO 5 → 6

Umbenannte Methoden

Addon-Klassen

Console-Klassen

Content-Klassen

MediaManager-Klassen

Mailer-Klasse

Form-Klassen

Security-Klassen

Cronjob-Klassen

Verschobene statische Methoden

Von Core nach Util\Version

Von Util\Str nach Util\Version

Von View\View nach View\Asset

Von View\View nach View\Message

Konstruktor-Änderungen

Klassen mit Factory-Methode statt Konstruktor

Exception-Erstellung

Entfernte Parameter

Util\Str::buildQuery()

URL-Methoden

Markdown-Methoden

Hinzugefügte Parameter

Form Field-Methoden

Geänderte Extension Point Namen

Codebeispiele

Beispiel: Version abrufen

Beispiel: Assets hinzufügen

Beispiel: Nachrichten ausgeben

Beispiel: Sprach-ID abrufen

Beispiel: Add-on-Methoden

Beispiel: Bildgrößen abrufen

Von `Core` nach `Util\Version`

Von `Util\Str` nach `Util\Version`

Von `View\View` nach `View\Asset`

Von `View\View` nach `View\Message`