##### # # Example .htaccess file for TYPO3 CMS - for use with Apache Webserver # # This file includes settings for the following configuration options: # # - Compression # - Caching # - MIME types # - Cross Origin requests # - Rewriting and Access # - Miscellaneous # - PHP optimisation # # If you want to use it, you have to copy it to the root folder of your TYPO3 installation (if its # not there already) and rename it to '.htaccess'. To make .htaccess files work, you might need to # adjust the 'AllowOverride' directive in your Apache configuration file. # # IMPORTANT: You may need to change this file depending on your TYPO3 installation! # Consider adding this file's content to your webserver's configuration directly for speed improvement # # Lots of the options are taken from https://github.com/h5bp/html5-boilerplate/blob/master/dist/.htaccess # #### ### Begin: Compression ### # Compressing resource files will save bandwidth and so improve loading speed especially for users # with slower internet connections. TYPO3 can compress the .js and .css files for you. # *) Uncomment the following lines and # *) Set $GLOBALS['TYPO3_CONF_VARS']['BE']['compressionLevel'] = 9 for the Backend # *) Set $GLOBALS['TYPO3_CONF_VARS']['FE']['compressionLevel'] = 9 together with the TypoScript properties # config.compressJs and config.compressCss for GZIP compression of Frontend JS and CSS files. # # AddType "text/javascript" .gz # # # AddType "text/css" .gz # #AddEncoding x-gzip .gz # Force compression for mangled `Accept-Encoding` request headers SetEnvIfNoCase ^(Accept-EncodXng|X-cept-Encoding|X{15}|~{15}|-{15})$ ^((gzip|deflate)\s*,?\s*)+|[X~-]{4,13}$ HAVE_Accept-Encoding RequestHeader append Accept-Encoding "gzip,deflate" env=HAVE_Accept-Encoding # Compress all output labeled with one of the following media types. # # (!) For Apache versions below version 2.3.7 you don't need to # enable `mod_filter` and can remove the `` # and `` lines as `AddOutputFilterByType` is still in # the core directives. # # https://httpd.apache.org/docs/current/mod/mod_filter.html#addoutputfilterbytype AddOutputFilterByType DEFLATE application/atom+xml \ application/javascript \ application/json \ application/ld+json \ application/manifest+json \ application/rdf+xml \ application/rss+xml \ application/schema+json \ application/vnd.geo+json \ application/geo+json \ application/vnd.ms-fontobject \ application/x-font-ttf \ application/x-javascript \ application/x-web-app-manifest+json \ application/xhtml+xml \ application/xml \ font/eot \ font/opentype \ font/otf \ font/ttf \ image/bmp \ image/svg+xml \ image/vnd.microsoft.icon \ image/x-icon \ text/cache-manifest \ text/css \ text/html \ text/javascript \ text/plain \ text/vcard \ text/vnd.rim.location.xloc \ text/vtt \ text/x-component \ text/x-cross-domain-policy \ text/xml AddEncoding gzip svgz ### End: Compression ### ### Begin: Browser caching of resource files ### # This affects Frontend and Backend and increases performance. ExpiresActive On ExpiresDefault "access plus 1 month" ExpiresByType text/css "access plus 1 year" ExpiresByType application/json "access plus 0 seconds" ExpiresByType application/ld+json "access plus 0 seconds" ExpiresByType application/schema+json "access plus 0 seconds" ExpiresByType application/vnd.geo+json "access plus 0 seconds" ExpiresByType application/geo+json "access plus 0 seconds" ExpiresByType application/xml "access plus 0 seconds" ExpiresByType text/xml "access plus 0 seconds" ExpiresByType image/vnd.microsoft.icon "access plus 1 week" ExpiresByType image/x-icon "access plus 1 week" ExpiresByType text/x-component "access plus 1 month" ExpiresByType text/html "access plus 0 seconds" ExpiresByType application/javascript "access plus 1 year" ExpiresByType application/x-javascript "access plus 1 year" ExpiresByType text/javascript "access plus 1 year" ExpiresByType application/manifest+json "access plus 1 week" ExpiresByType application/x-web-app-manifest+json "access plus 0 seconds" ExpiresByType text/cache-manifest "access plus 0 seconds" ExpiresByType audio/ogg "access plus 1 month" ExpiresByType image/apng "access plus 1 month" ExpiresByType image/avif "access plus 1 month" ExpiresByType image/avif-sequence "access plus 1 month" ExpiresByType image/bmp "access plus 1 month" ExpiresByType image/gif "access plus 1 month" ExpiresByType image/jpeg "access plus 1 month" ExpiresByType image/jxl "access plus 1 month" ExpiresByType image/png "access plus 1 month" ExpiresByType image/svg+xml "access plus 1 month" ExpiresByType image/webp "access plus 1 month" ExpiresByType video/mp4 "access plus 1 month" ExpiresByType video/ogg "access plus 1 month" ExpiresByType video/webm "access plus 1 month" ExpiresByType application/atom+xml "access plus 1 hour" ExpiresByType application/rdf+xml "access plus 1 hour" ExpiresByType application/rss+xml "access plus 1 hour" ExpiresByType font/collection "access plus 1 month" ExpiresByType application/vnd.ms-fontobject "access plus 1 month" ExpiresByType font/eot "access plus 1 month" ExpiresByType font/opentype "access plus 1 month" ExpiresByType font/otf "access plus 1 month" ExpiresByType application/x-font-ttf "access plus 1 month" ExpiresByType font/ttf "access plus 1 month" ExpiresByType application/font-woff "access plus 1 month" ExpiresByType application/x-font-woff "access plus 1 month" ExpiresByType font/woff "access plus 1 month" ExpiresByType application/font-woff2 "access plus 1 month" ExpiresByType font/woff2 "access plus 1 month" ExpiresByType text/x-cross-domain-policy "access plus 1 week" ### End: Browser caching of resource files ### ### Begin: MIME types ### # Proper MIME types for all files # Security configuration RemoveType .html .htm AddType text/html .html .htm RemoveType .svg .svgz AddType image/svg+xml .svg .svgz # Data interchange AddType application/atom+xml atom AddType application/json json map topojson AddType application/ld+json jsonld AddType application/rss+xml rss AddType application/vnd.geo+json geojson AddType application/xml rdf xml # JavaScript AddType application/javascript js mjs # Manifest files AddType application/manifest+json webmanifest AddType application/x-web-app-manifest+json webapp AddType text/cache-manifest appcache # Media files AddType audio/mp4 f4a f4b m4a AddType audio/ogg oga ogg opus AddType image/avif avif AddType image/avif-sequence avifs AddType image/bmp bmp AddType image/jxl jxl AddType image/webp webp AddType video/mp4 f4v f4p m4v mp4 AddType video/ogg ogv AddType video/webm webm AddType video/x-flv flv AddType image/x-icon cur ico # Web fonts AddType font/woff woff AddType font/woff2 woff2 AddType application/vnd.ms-fontobject eot AddType font/ttf ttc ttf AddType font/otf otf # Other AddType application/octet-stream safariextz AddType application/x-bb-appworld bbaw AddType application/x-chrome-extension crx AddType application/x-opera-extension oex AddType application/x-xpinstall xpi AddType text/vcard vcard vcf AddType text/vnd.rim.location.xloc xloc AddType text/vtt vtt AddType text/x-component htc # UTF-8 encoding AddDefaultCharset utf-8 AddCharset utf-8 .atom .css .js .json .manifest .rdf .rss .vtt .webapp .webmanifest .xml ### End: MIME types ### ### Begin: Cross Origin ### # Send the CORS header for images when browsers request it. SetEnvIf Origin ":" IS_CORS Header set Access-Control-Allow-Origin "*" env=IS_CORS # Allow cross-origin access to web fonts. Header set Access-Control-Allow-Origin "*" ### End: Cross Origin ### ### Begin: Rewriting and Access ### # Enable URL rewriting RewriteEngine On # Store the current location in an environment variable CWD to use # mod_rewrite in .htaccess files without knowing the RewriteBase RewriteCond $0#%{REQUEST_URI} ([^#]*)#(.*)\1$ RewriteRule ^.*$ - [E=CWD:%2] # Rules to set ApplicationContext based on hostname #RewriteCond %{HTTP_HOST} ^dev\.example\.com$ #RewriteRule .? - [E=TYPO3_CONTEXT:Development] #RewriteCond %{HTTP_HOST} ^staging\.example\.com$ #RewriteRule .? - [E=TYPO3_CONTEXT:Production/Staging] #RewriteCond %{HTTP_HOST} ^www\.example\.com$ #RewriteRule .? - [E=TYPO3_CONTEXT:Production] # Rule for versioned static files, configured through: # - $GLOBALS['TYPO3_CONF_VARS']['BE']['versionNumberInFilename'] # - $GLOBALS['TYPO3_CONF_VARS']['FE']['versionNumberInFilename'] # IMPORTANT: This rule has to be the very first RewriteCond in order to work! RewriteCond %{REQUEST_FILENAME} !-f RewriteCond %{REQUEST_FILENAME} !-d RewriteRule ^(.+)\.(\d+)\.(php|js|mjs|css|png|jpg|gif|svg|avif|webp|gz)$ %{ENV:CWD}$1.$3 [L] # Access block for folders RewriteRule _(?:recycler|temp)_/ - [F] RewriteRule fileadmin/templates/.*\.(?:txt|ts)$ - [F] RewriteRule ^(?:vendor|typo3_src|typo3temp/var) - [F] RewriteRule (?:typo3conf/ext|typo3/sysext|typo3/ext)/[^/]+/(?:Configuration|Resources/Private|Tests?|Documentation|docs?)/ - [F] # Block access to all hidden files and directories with the exception of # the visible content from within the `/.well-known/` hidden directory (RFC 5785). RewriteCond %{REQUEST_URI} "!(^|/)\.well-known/([^./]+./?)+$" [NC] RewriteCond %{SCRIPT_FILENAME} -d [OR] RewriteCond %{SCRIPT_FILENAME} -f RewriteRule (?:^|/)\. - [F] # Redirect missing hardcoded Collateral file URLs to a resolver that # chooses the newest available version by filename convention. RewriteCond %{REQUEST_FILENAME} !-f RewriteRule ^fileadmin/downloads/Collateral/(.+)$ %{ENV:CWD}collateral-fallback.php?requested=$1 [QSA,L,NC] # Stop rewrite processing, if we are in any known directory # NOTE: Add your additional local storages here RewriteRule ^(?:fileadmin/|typo3conf/|typo3temp/|uploads/) - [L] # If the file/symlink/directory does not exist but is below /typo3/, redirect to the main TYPO3 entry point. RewriteCond %{REQUEST_FILENAME} !-f RewriteRule ^typo3/(.*)$ %{ENV:CWD}index.php [QSA,L] # --- VITEC phase B: SPA fallback (PREPARED, switch day only) ---------- # Uncomment this block to make every page URL serve the React app # (public/_frontend/index.html). TYPO3 keeps answering JSON under # /_json (the JsonPrefixRewrite middleware strips the prefix) plus the # direct endpoints excluded below. Requires the front-end build with # router basename "/" and the /_json API prefix FIRST. Roll back by # re-commenting. See work log section 5r (2026-09-28). # TYPO3 v14 install tool: its entry point is the SITE ROOT plus # ?__typo3_install (install.php only redirects there, PathGuard). The # backend's Settings/Environment/Maintenance/Upgrade modules depend on # it - without this exception they show the React app instead. RewriteCond %{QUERY_STRING} __typo3_install RewriteCond %{REQUEST_FILENAME} !-f RewriteRule ^.*$ %{ENV:CWD}index.php [QSA,L] # --- VITEC SSR routing (flag-gated) ----------------------------------- # Active ONLY while the flag file below exists. Mirrors the SPA # fallback's exclusions but PROXIES page requests to the SSR node on # the Solr VPS instead of serving the React shell (mod_proxy incl. # https target verified on this host 2026-11-09, see Nextcloud # vitec-solr/ssr/README-SSR-Setup.md). The flag is written/removed by # EXT:vitec (Site Set switch "vitec.ssr.enabled" -> SsrFlagService, # synced by the SyncSsrFlag middleware / vitec:ssr-flag command). # Emergency off without TYPO3: delete the flag file. RewriteCond /usr/www/users/vitecevo/live/var/vitec-ssr-on.flag -f RewriteRule ^$ https://vitec-ssr.evomedien.de/ [P,L,E=SSRPROXY:1] # Flag ON: the hashed JS/CSS files come from the VPS release too # (0054-FE 5.1 / 0055-BE question 1). No !-f guard on purpose: a # same-named file from an older local SPA build must not win, the # SSR HTML references the hashes of the VPS release. RewriteCond /usr/www/users/vitecevo/live/var/vitec-ssr-on.flag -f RewriteRule ^_frontend/assets/(.*)$ https://vitec-ssr.evomedien.de/_frontend/assets/$1 [P,L,E=SSRPROXY:1] RewriteCond /usr/www/users/vitecevo/live/var/vitec-ssr-on.flag -f RewriteCond %{REQUEST_FILENAME} !-f RewriteCond %{REQUEST_FILENAME} !-d RewriteCond %{REQUEST_FILENAME} !-l RewriteCond %{REQUEST_URI} !^/_json(/|$) RewriteCond %{REQUEST_URI} !^/typo3(/|$) RewriteCond %{REQUEST_URI} !^/download/ RewriteCond %{REQUEST_URI} !^/api/ RewriteCond %{REQUEST_URI} !^/_frontend/ RewriteCond %{REQUEST_URI} !^/sitemap RewriteRule ^(.*)$ https://vitec-ssr.evomedien.de/$1 [P,L,E=SSRPROXY:1] # The SSR node derives absolute URLs from X-Forwarded-Host/-Proto; # mod_proxy sends -Host on its own, -Proto needs a hand (0054-FE 5.2): RequestHeader set X-Forwarded-Proto https env=SSRPROXY # ---------------------------------------------------------------------- # The root path needs its own rule: for "/" REQUEST_FILENAME is the # docroot DIRECTORY, so the !-d guard below skips it and DirectoryIndex # would hand it to TYPO3 (JSON). The homepage JSON lives at /_json/. RewriteRule ^$ %{ENV:CWD}_frontend/index.html [L] RewriteCond %{REQUEST_FILENAME} !-f RewriteCond %{REQUEST_FILENAME} !-d RewriteCond %{REQUEST_FILENAME} !-l RewriteCond %{REQUEST_URI} !^/_json(/|$) RewriteCond %{REQUEST_URI} !^/typo3(/|$) RewriteCond %{REQUEST_URI} !^/download/ RewriteCond %{REQUEST_URI} !^/api/ RewriteCond %{REQUEST_URI} !^/_frontend/ RewriteCond %{REQUEST_URI} !^/sitemap RewriteRule ^.*$ %{ENV:CWD}_frontend/index.html [L] # ---------------------------------------------------------------------- # If the file/symlink/directory does not exist => Redirect to index.php. # For httpd.conf, you need to prefix each '%{REQUEST_FILENAME}' with '%{DOCUMENT_ROOT}'. RewriteCond %{REQUEST_FILENAME} !-f RewriteCond %{REQUEST_FILENAME} !-d RewriteCond %{REQUEST_FILENAME} !-l RewriteRule ^.*$ %{ENV:CWD}index.php [QSA,L] # Access block for files # Apache < 2.3 Order allow,deny Deny from all Satisfy All # Apache ≥ 2.3 Require all denied # Block access to vcs directories RedirectMatch 404 /\.(?:git|svn|hg)/ ### End: Rewriting and Access ### ### Begin: Miscellaneous ### # 404 error prevention for non-existing redirected folders Options -MultiViews # Make sure that directory listings are disabled. Options -Indexes # Force IE to render pages in the highest available mode Header set X-UA-Compatible "IE=edge" Header unset X-UA-Compatible # Reducing MIME type security risks Header set X-Content-Type-Options "nosniff" # TYPO3 cache-tag/debug headers: internal ids, and on news pages >16 KB, # which overflowed the SSR node's default header limit (0054-FE 5.4) - # never send them to clients. Header unset X-TYPO3-Cache-Tags Header unset X-TYPO3-Cache-Tags-1 Header unset X-TYPO3-Cache-Tags-2 Header unset X-TYPO3-Cache-Tags-3 Header unset X-TYPO3-Debug-Cache Header unset X-TYPO3-Cache-Lifetime Header unset X-TYPO3-Parsetime # Depending on the PHP SAPI these can sit in the "always" table: Header always unset X-TYPO3-Cache-Tags Header always unset X-TYPO3-Cache-Tags-1 Header always unset X-TYPO3-Cache-Tags-2 Header always unset X-TYPO3-Cache-Tags-3 Header always unset X-TYPO3-Debug-Cache Header always unset X-TYPO3-Cache-Lifetime Header always unset X-TYPO3-Parsetime # ETag removal - except for the /_json API: there TYPO3 (JsonCacheHeaders # middleware) sends a content ETag so browsers can revalidate with 304 # (tickets 0011-FE / 0055-BE). SetEnvIf Request_URI "^/_json($|/)" KEEP_ETAG=1 # After the mod_rewrite internal redirect to index.php the variable # is renamed REDIRECT_KEEP_ETAG - carry it back over: SetEnvIf REDIRECT_KEEP_ETAG 1 KEEP_ETAG=1 Header unset ETag env=!KEEP_ETAG FileETag None ### End: Miscellaneous ### # Add your own rules here. AuthUserFile "/usr/www/users/vitecevo/live/public/.htpasswd" AuthName "DEV" AuthType Basic Require ip 217.70.192.164 # The server itself (136.243.123.171 public, loopback variants): lets the # sub-market importer download assets from dev URLs and keeps the door # open for a future SSR process fetching /_json server-side (2026-10-02). Require ip 136.243.123.171 Require ip 127.0.0.1 Require ip ::1 Require valid-user