Why RealURL sucks - and how to fix it

Why RealURL sucks...
(and how to ﬁx it)

TYPO3 Akademie 2011

Montag, 28. Februar 2011

RealURL

• ist fantastisch
• ist extrem ﬂexibel

• ABER ....!


Was ist das Problem?

Folie 3 von 3786

50 Bugﬁxes in 6 Monaten


Warum RealURL ?

• 'Lesbare' URLs
• für Menschen
• für Suchmaschinen


SimulateStatic
• Home -> Produkte -> TV -> LCD

[domain]/lcd.html

• Home -> Impressum

[domain]/impressum.html


Installation

• Konﬁgurationsdatei:


Installation
• Automatische Konﬁguration:

typo3conf/realurl_autoconf.php
• Achtung:
wird gelöscht bei Anlegen eines Domain-
Records!

Installation


Speicherformat
Serialized:
$GLOBALS['TYPO3_CONF_VARS']['EXTCONF']['realurl']=unserialize('a:
1:{s:8:"_DEFAULT";a:4:{s:4:"init";a:7:{s:16:"enableCHashCache"....

Source (slow?!):
$GLOBALS['TYPO3_CONF_VARS']['EXTCONF']['realurl']=array (
'_DEFAULT' =>
array (
'init' =>
array (
'enableCHashCache' => true,
'appendMissingSlash' => 'ifNotFile,redirect',
'adminJumpToBackend' => true,
'enableUrlDecodeCache' => true,
....

ohne Konﬁguration

• [domain]/index.php?id=123

• [domain]/123/
• [domain]/alias/


Autokonﬁguration
• [domain]/index.php?id=123

• [domain]/seitentitel/
• [domain]/navigationstitel/
• [domain]/alias/


Autokonﬁguration

• Nur für Basis-Konﬁguration
ohne Extensions mit GET Variablen


/datei-downloads/software/windows/windows-xp.html

/datei-downloads/programme.html
/datei-downloads/programme/windows.html
/datei-downloads/programme/windows/windows-xp.html


/abc/programme.html
/abc/programme/windows.html
/abc/programme/windows/windows-xp.html


/datei-downloads/software.html
/datei-downloads/windows.html
/datei-downloads/windows/windows-xp.html


Funktionsweise RealURL

• Seiten ID + Parameter -> URL

• URL -> Seiten ID + Parameter


Teile der URL
Domain www.test.de
preVars en
pagePath shop/products/
ﬁxedPostVars create
postVarSets article/123/color
ﬁleName detail.html


Kodierung
Überschriften ueberschriften
Académie française academie-francaise
Español espanol
Фотосессия fotosessija
Ελλάδα ellada
‫מדינת ישראל‬ mdint-ishral


Multi Domain
[www.domain1.de] =>
array ( ... ),

[www.domain1.de] =>
array ( ... ),

[_DEFAULT] =>
array ( ... ),


Multi Domain
[_DEFAULT] =>
array ( ... ),

[www.domain1.de] =>
array ( ... ),

[www.domain2.de] =>
array ( ... ),


Konﬁguration
[domain]
init => array (...),
redirects => array (...),
redirects_regex => array (...),
preVars => array (...),
pagePath => array (...),
fixedPostVars => array (...),
postVarSets => array (...)
fileName => array (...)


init
'enableCHashCache' => true,
'appendMissingSlash' => 'ifNotFile,redirect',
'adminJumpToBackend' => true,
'enableUrlDecodeCache' => true,
'enableUrlEncodeCache' => true,
'emptyUrlReturnValue' => '/',
'respectSimulateStaticURLs' => true,


init

'doNotRawUrlEncodeParameterNames' => true,

• tx_ttnews%5Btt_news%5D=3

wird zu
• tx_ttnews[tt_news]=3


init

'enableAllUnicodeLetters' => true,

• ermöglicht URLs in der Form

http://name-der-domain.de/ /


init

'postVarSet_failureMode' => 'redirect_goodUpperDir',


init

'postVarSet_failureMode' => 'ignore',


redirects

'redirects' =>.
array (
'aktuelles/' => '301;http://spiegel.de',
),


redirects_regex

'redirects_regex' =>.
array (
'^english/(.*)' => '301;en/1',

'^downloads/(.*)' => 'ftp://dl.domain.tld/public/dl/1',
),


preVars

• http://[domain]/en/news/articel.html


preVars
'preVars' =>
array (
0 =>
array (
'GETvar' => 'L',
'valueMap' =>.
array (
'en' => '1',
),
'noMatch' => 'bypass',
),
),

preVars
1. Prüfe ob Eintrag in valueMap
2. Falls nicht gefunden, setze noMatch
3. Prüfe Eintrag in noMatch
- 'bypass': Wert wird nicht gesetzt, fortfahren
- 'null': Wert wird nicht gesetzt, ignoriere Rest
4. Datenbankabruf mit 'lookUpTable'
5.Verarbeitung mit 'userFunc'
6. Setze Wert mit 'valueDefault'


'lookUpTable' => array(
'table' => 'tt_news',
'id_field' => 'uid',
'alias_field' => 'title',
'maxLength' => 50,
'useUniqueCache' => 1,
'useUniqueCache_conf' => array (
'strtolower' => '1'.
'spaceCharacter' => '-',
'encodeTitle_userProc' => '...'
)
'addWhereClause' => ' AND NOT deleted',
'languageGetVar' => 'L',
'languageExceptionUids' => '',
'languageField' => 'sys_language_uid',
'transOrigPointerField' => 'l18n_parent',
'enable404forInvalidAlias' => '1',
'autoUpdate' => '1',
'expireDays' => '60'
)


pagePath
'pagePath' => array(
'type' => 'user',
'userFunc' => 'EXT:realurl/
class.tx_realurl_advanced.php:&tx_realurl_advanced->main',

'spaceCharacter' => '-',
'languageGetVar' => 'L',
'expireDays' => 30
),


postVarSets
ﬁxedPostVars
postVarsSets => array (
'123' => array (...),
'_DEFAULT' => array (...),
),


postVarSets
'_DEFAULT' => array (
'news' => array (...),
'calendar' => array (...),
'shop' => array (...),
),
),


postVarSets
'_DEFAULT' => array (
'news' => array (
'list' => array (...),
'single' => array (...),
'archive' => array (...),
),
),
),

'postVarSets' => array(
            '_DEFAULT' => array(
                // news archive parameters
                'archive' => array(
                    array(
                        'GETvar' => 'tx_ttnews[year]' ,
                        ),
                    array(
                        'GETvar' => 'tx_ttnews[month]' ,
                        'valueMap' => array(
                            'january' => '01',
                            'february' => '02',
                            'march' => '03',
                            'april' => '04',
                            'may' => '05',
                            'june' => '06',
                            'july' => '07',
                            'august' => '08',
                            'september' => '09',
                            'october' => '10',
                            'november' => '11',
                            'december' => '12',
                            )
                        ),

ﬁleName
'fileName' => array(
'defaultToHTMLsuffixOnPrev' => '1',
'acceptHTMLsuffix' => '1',

'index' => array(
'rss.xml' => array(
'keyValues' => array(
'type' => 100,
),
),
'.pdf' => array(
'type' => 123,
),
),
'print.html' => array(
'type' => 98,
),
),
),
),


Why RealURL sucks - and how to fix it

Weitere ähnliche Inhalte

Mehr von jweiland