Troubleshooting

• All URLs show "Page not found"
• Excluding pages does not work (external link)
• Segments with aliases produce 404 errors
• Logging

All URLs show "Page not found"

Typically this happen when rewrite rules in .htaccess do not work. This may happen due to several reasons:

• Your web server is not Apache. For example, Nginx does not support .htaccess. You have to make rewrites for Nginx yourself.
• You forgot to rename _.htaccess to .htaccess after installing TYPO3
• You have AllowOverride set to None for your site directory. Change it to All.

Segments with aliases produce 404 errors

Aliases is a RealURL feature that maps a record id value to a certain string. For example, it can map news record uid field to news title field. The URL will look like /path/to/news/article/how-i-earned-my-first-million. The last segment is an alias. RealURL will decode it to something like tx_mynewsext[news_id]=12345. To make such decoding RealURL needs to maintain association between the record table, record id and an alias. This association is stored in the tx_realurl_uniqalias table. If that table is cleared, RealURL will be unable to resolve aliases and corresponding extension may produce a 404 error.

Do not clear tx_realurl_uniqalias table in the database unless you really know why you do it.

Logging

RealURL has built-in logging that works with TYPO3 logging system. The following code in typo3conf/AdditionalConfiguration.php will produce log file with a lot of information about internal activity of RealURL. If you use RealURL logging, than it is recommended to use logging levels of WARNING or ERROR because other levels may produce a lot of information on every page load. If you want to log redirects, you need NOTICE log level.

$GLOBALS['TYPO3_CONF_VARS']['LOG']['DmitryDulepov']['Realurl'] = array(
	'writerConfiguration' => array(
		\TYPO3\CMS\Core\Log\LogLevel::WARNING => array(
			\TYPO3\CMS\Core\Log\Writer\FileWriter::class => array(
				'logFile' => 'typo3temp/logs/tx_realurl_' . date('Ymd') . '.log'
			)
		)
	)
);