Skip to content

Notes for Developers

Jump to bottom
Dmitry Dulepov edited this page Mar 3, 2016 · 10 revisions

Tips

  • Working with cHash correctly in your extension
  • Banning certain URLs from RealURL cache

FAQ

Tips

Working with cHash correctly in your extension

If you do not know what cHash is, read this first. This is a long reading and code is obsolete there but you will not find a better explanation anywhere. Each extension developer must know what a cHash is!

TYPO3 plugins can be either cached or uncached. For cached, when you supply GET parameters to the plugin, you need to make sure that there is a cHash in the URL. For non-cached, you do not supply cHash. This is important distinction because:

  • If you do not supply cHash for cached plugin, your output will be a first cached version of the plugin output regardless of the plugin parameters
  • If you supply cHash for non-cached plugin, you will pollute TYPO3 cache with many identical entries and make the site slower. You may also make RealURL slower because under certain conditions it re-creates cHash.

Unfortunately Extbase developers decided to make cHash on by default. Thus most Extbase-based plugins incorrectly use cHash even for non-cached plugins. If you are an extension developer, check how you use action viewhelper for forms. It is likely that you did not disable cHash there and your non-cached plugin gets a cHash. That's your error, which you should fix. Same for any other links for your plugin. You should always check whether you need cHash or not and disable cHash generation if not.

Another thing you must do as a developer, is to tell TYPO3 about parameters that should not be taken into account when calculating cHash. RealURL uses this information when it has to recalculate cHash. For example, if your plugin is always non-cached, you may produce a URL like /index.php?id=123&tx_myrandomnews[topic]=456, which translates to /fun/random-news/jokes (assuming 456 maps to jokes).

FAQ

Cache

Why don't you use caching framework?

Caching framework is a great TYPO3 feature but it does not fully meet requirements for the RealURL cache. RealURL uses the following types of caches:

  • URL cache. Unlike version 1.x, version 2.x uses a single cache for encoding and decoding. When encoding, it needs to fetch a cache entry using original URL as a key. When decoding, it needs to fetch a cache entry using speaking URL.
  • Path cache. When encoding, RealURL needs to fetch the entry using language and page id with no (zero) expiration time. When decoding, it needs to fetch a cache entry using root page id and segments of the path with longest expiration time.
  • Alias cache uses multiple conditions when decoding and encoding.

From the cache requirements it is clear that using a single cache key it is not possible to meet those requirements. Theoretically it is possible by using tags but that would make extra overhead: currently there is a single optimized query for each cache operation while with caching framework it will take several database operations. When using non-database caches, certain systems (like memcached) do not guarantee that tags and data will both present. Thus cache can be corrupted.

I still want to use my own cache implementation. How can I do that?

You can implement an interface named \DmitryDulepov\Realurl\Cache\CacheInterface in your own class and configure cache in the RealURL configuration. Note that you will loose Backend modules. You'll have to make your own cache management in the Backend.

I know that changing interfaces is bad. I will try hard not to change them unless it is not possible to fix a bug without changing the interface. If inetrfaces change, I will announce it.

Miscellaneous

What happened to Forge?

RealURL is now developed at GitHub because GitHub is faster and allows better collaboration. Forge project is no longer active.

I reported a bug at Forge. Will you look at it?

No. Forge issues were for RealURL 1.x. That version is no longer maintained or supported. Use version 2.x and submit issues to GitHub project.

I do not like your answers. They are rude.

They are not rude :) This is called cultural differences. I simply like to be precise and exact. Therefore I lack those usual "how do you do?", etc. I am happy to communicate to you and discuss things with you as long as we both stay on the subject without switching to offtopic questions.

Yes, I can say plain straight "no" instead of saying "I do not think it will be a good idea" but I always clearly explain my decisions and I want to be honest with you. This is not rude.

Thanks for understanding!

Clone this wiki locally