# A WP Rocket szabályai a .htaccess fájlban

> Milyen szabályokat ír a WP Rocket a .htaccess fájlba, mikor írja át, és hogyan adhatsz hozzá saját szabályt vagy kapcsolhatod ki az írást.

A WP Rocket aktiválásakor szabályokat ír a `.htaccess` fájlba. Ezek a böngészős gyorsítótárat, a GZIP-tömörítést és a gyorsítótárazott oldalak kiszolgálását állítják be. A szabályok Apache és LiteSpeed szerveren működnek. NGINX-en ugyanezt a szerverkonfigurációban kell beállítani.

Ha a szabályok hibát okoznak (rossz átirányítás, 500-as hiba), a hibaelhárítási fejezetekben találsz megoldást. Saját szabályokat az alábbi segédbővítménnyel adhatsz hozzá.

## Mikor ír a WP Rocket a .htaccess fájlba?

A WP Rocket a következő esetekben módosítja a fájlt:

- Ha bekapcsolod vagy kikapcsolod a **mobil gyorsítótárat**, a **WebP-kompatibilitást** vagy a **CDN / RocketCDN** funkciót.
- Ha értéket adsz hozzá a **Soha ne gyorsítótárazott URL-ek**, a **Soha ne gyorsítótárazott sütik** vagy a **Soha ne gyorsítótárazott felhasználói ügynökök** listához.
- Ha olyan harmadik féltől származó bővítményt kapcsolsz be vagy ki, amellyel a WP Rocket automatikusan kompatibilis, és az dinamikus sütit vagy mobilspecifikus sablont használ.
- Ha aktiválod vagy deaktiválod a WP Rocketet, vagy a fent említett esetekhez tartozó segédbővítményeket.
- Egyes WP Rocket-frissítések után, ha azok a fenti esetekhez kapcsolódnak.

Ez azért hasznos, mert korlátozott fájljogosultságú környezetben tudnod kell, mikor kell a `.htaccess` jogosultságait átállítani, és hibakereséskor is segít.

## Milyen blokkokat ír a WP Rocket?

### Karakterkódolás

A `.atom`, `.css`, `.js`, `.json`, `.rss`, `.vtt` és `.xml` fájlok UTF-8 kódolást kapnak.

```apache
# Use UTF-8 encoding for anything served text/plain or text/html
AddDefaultCharset UTF-8
# Force UTF-8 for a number of file formats
<IfModule mod_mime.c>
AddCharset UTF-8 .atom .css .js .json .rss .vtt .xml
</IfModule>
```

### ETag

A blokk eltávolítja az `ETag` fejlécet az állományokról.

```apache
# FileETag None is not enough for every server.
<IfModule mod_headers.c>
Header unset ETag
</IfModule>
# Since we’re sending far-future expires, we don’t need ETags for static content.
# developer.yahoo.com/performance/rules.html#etags
FileETag None
```

### Webfontok és CORS

A WP Rocket CORS-fejléceket küld, ha a böngésző kéri, és minden domainről engedélyezi a webfontok elérését.

```apache
# Send CORS headers if browsers request them; enabled by default for images.
<IfModule mod_setenvif.c>
<IfModule mod_headers.c>
# mod_headers, y u no match by Content-Type?!
<FilesMatch "\.(cur|gif|png|jpe?g|svgz?|ico|webp)$">
SetEnvIf Origin ":" IS_CORS
Header set Access-Control-Allow-Origin "*" env=IS_CORS
</FilesMatch>
</IfModule>
</IfModule>

# Allow access to web fonts from all domains.
<FilesMatch "\.(eot|otf|tt[cf]|woff2?)$">
<IfModule mod_headers.c>
Header set Access-Control-Allow-Origin "*"
</IfModule>
</FilesMatch>
```

### Pragma, Cache-Control és Last-Modified fejlécek

A HTML-oldalak kapnak egy `X-Powered-By` fejlécet (támogatási és hibakeresési célra). A `Pragma` fejlécet a WP Rocket eltávolítja, mert elavult. A `Cache-Control` fejléc a `public` direktívát kapja, hogy bármelyik réteg gyorsítótárazhassa az állományt.

```apache
<IfModule mod_alias.c>
<FilesMatch "\.(html|htm|rtf|rtx|txt|xsd|xsl|xml)$">
<IfModule mod_headers.c>
Header set X-Powered-By "WP Rocket/3.15.9"
Header unset Pragma
Header append Cache-Control "public"
Header unset Last-Modified
</IfModule>
</FilesMatch>
<FilesMatch "\.(css|htc|js|asf|asx|wax|wmv|wmx|avi|bmp|class|divx|doc|docx|eot|exe|gif|gz|gzip|ico|jpg|jpeg|jpe|json|mdb|mid|midi|mov|qt|mp3|m4a|mp4|m4v|mpeg|mpg|mpe|mpp|otf|odb|odc|odf|odg|odp|ods|odt|ogg|pdf|png|pot|pps|ppt|pptx|ra|ram|svg|svgz|swf|tar|tif|tiff|ttf|ttc|wav|wma|wri|xla|xls|xlsx|xlt|xlw|zip)$">
<IfModule mod_headers.c>
Header unset Pragma
Header append Cache-Control "public"
</IfModule>
</FilesMatch>
</IfModule>
```

### AVIF

A blokk felveszi a szerverkonfigurációba az `image/avif` és az `image/avif-sequence` MIME-típust.

```apache
<IfModule mod_mime.c>
	AddType image/avif                                  avif
    AddType image/avif-sequence                         avifs
</IfModule>
```

### Böngészős gyorsítótár

Ez a blokk tartalmazza a böngészős gyorsítótár összes lejárati szabályát: a HTML-re és az adatfájlokra 0 másodpercet, a hírcsatornákra 1 órát, a képekre, videókra, hangokra és webfontokra 4 hónapot, a CSS- és JavaScript-fájlokra 1 évet állít, a többi fájl alapértéke 1 hónap.

```apache
# Expires headers (for better cache control)
<IfModule mod_expires.c>
	ExpiresActive on
	ExpiresDefault                              "access plus 1 month"
	# cache.appcache needs re-requests in FF 3.6 (thanks Remy ~Introducing HTML5)
	ExpiresByType text/cache-manifest           "access plus 0 seconds"
	# Your document html
	ExpiresByType text/html                     "access plus 0 seconds"
	# Data
	ExpiresByType text/xml                      "access plus 0 seconds"
	ExpiresByType application/xml               "access plus 0 seconds"
	ExpiresByType application/json              "access plus 0 seconds"
	# Feed
	ExpiresByType application/rss+xml           "access plus 1 hour"
	ExpiresByType application/atom+xml          "access plus 1 hour"
	# Favicon (cannot be renamed)
	ExpiresByType image/x-icon                  "access plus 1 week"
	# Media: images, video, audio
	ExpiresByType image/gif                     "access plus 4 months"
	ExpiresByType image/png                     "access plus 4 months"
	ExpiresByType image/jpeg                    "access plus 4 months"
	ExpiresByType image/webp                    "access plus 4 months"
	ExpiresByType video/ogg                     "access plus 4 months"
	ExpiresByType audio/ogg                     "access plus 4 months"
	ExpiresByType video/mp4                     "access plus 4 months"
	ExpiresByType video/webm                    "access plus 4 months"
	ExpiresByType image/avif                    "access plus 4 months"
	ExpiresByType image/avif-sequence           "access plus 4 months"
	# HTC files  (css3pie)
	ExpiresByType text/x-component              "access plus 1 month"
	# Webfonts
	ExpiresByType font/ttf                      "access plus 4 months"
	ExpiresByType font/otf                      "access plus 4 months"
	ExpiresByType font/woff                     "access plus 4 months"
	ExpiresByType font/woff2                    "access plus 4 months"
	ExpiresByType image/svg+xml                 "access plus 4 months"
	ExpiresByType application/vnd.ms-fontobject "access plus 1 month"
	# CSS and JavaScript
	ExpiresByType text/css                      "access plus 1 year"
	ExpiresByType text/javascript               "access plus 1 year"
	ExpiresByType application/javascript        "access plus 1 year"
</IfModule>
```

### GZIP-tömörítés

Ez a blokk tömöríti az oldal állományait. A már tömörített tartalmakat (képek, archívumok, videók, PDF) kihagyja.

```apache
# Gzip compression
<IfModule mod_deflate.c>
# Active compression
SetOutputFilter DEFLATE
# Force deflate for mangled headers
<IfModule mod_setenvif.c>
<IfModule mod_headers.c>
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
# Don’t compress images and other uncompressible content
SetEnvIfNoCase Request_URI \
\.(?:gif|jpe?g|png|rar|zip|exe|flv|mov|wma|mp3|avi|swf|mp?g|mp4|webm|webp|pdf)$ no-gzip dont-vary
</IfModule>
</IfModule>

# Compress all output labeled with one of the following MIME-types
<IfModule mod_filter.c>
AddOutputFilterByType DEFLATE application/atom+xml \
		                          application/javascript \
		                          application/json \
		                          application/rss+xml \
		                          application/vnd.ms-fontobject \
		                          application/x-font-ttf \
		                          application/xhtml+xml \
		                          application/xml \
		                          font/opentype \
		                          image/svg+xml \
		                          image/x-icon \
		                          text/css \
		                          text/html \
		                          text/plain \
		                          text/x-component \
		                          text/xml
</IfModule>
<IfModule mod_headers.c>
Header append Vary: Accept-Encoding
</IfModule>
</IfModule>
```

### A .html_gzip kódolás

A blokk felveszi a szerverkonfigurációba a `.html_gzip` MIME-típust.

```apache
<IfModule mod_mime.c>
AddType text/html .html_gzip
AddEncoding gzip .html_gzip
</IfModule>
<IfModule mod_setenvif.c>
SetEnvIfNoCase Request_URI \.html_gzip$ no-gzip
</IfModule>
```

### Átírási szabályok

Ezek döntik el, hogy a szerver a gyorsítótárból szolgálja-e ki az oldalt, a WP Rocket beállításai alapján.

Ez a blokk nincs mindig a fájlban. Akkor szerepel, ha a mobil gyorsítótár vagy a WebP-kompatibilitás ki van kapcsolva, és nincsenek telepítve olyan bővítmények (például a Cookie Notice), amelyekkel a kompatibilitás kötelező és dinamikus sütikre épül. Ha a blokk hiányzik, az átirányításokat a PHP kezeli.

```apache
<IfModule mod_rewrite.c>
RewriteEngine On
RewriteBase /
RewriteCond %{HTTPS} on [OR]
RewriteCond %{SERVER_PORT} ^443$ [OR]
RewriteCond %{HTTP:X-Forwarded-Proto} https
RewriteRule .* - [E=WPR_SSL:-https]
RewriteCond %{HTTP:Accept-Encoding} gzip
RewriteRule .* - [E=WPR_ENC:_gzip]
RewriteCond %{REQUEST_METHOD} GET
RewriteCond %{QUERY_STRING} =""
RewriteCond %{HTTP:Cookie} !(wordpress_logged_in_.+|wp-postpass_|wptouch_switch_toggle|comment_author_|comment_author_email_) [NC]
RewriteCond %{REQUEST_URI} !^(/(?:.+/)?feed(?:/(?:.+/?)?)?$|/(?:.+/)?embed/|/(index.php/)?(.*)wp-json(/.*|$))$ [NC]
RewriteCond %{HTTP_USER_AGENT} !^(facebookexternalhit|WhatsApp).* [NC]
RewriteCond "%{DOCUMENT_ROOT}/wp-content/cache/wp-rocket/%{HTTP_HOST}%{REQUEST_URI}/index%{ENV:WPR_SSL}%{ENV:WPR_WEBP}.html%{ENV:WPR_ENC}" -f
RewriteRule .* "/wp-content/cache/wp-rocket/%{HTTP_HOST}%{REQUEST_URI}/index%{ENV:WPR_SSL}%{ENV:WPR_WEBP}.html%{ENV:WPR_ENC}" [L]
</IfModule>
```

## Saját szabályok hozzáadása

A WP Rocket a beállítások módosításakor újraírja a `.htaccess` fájlt, és a saját blokkját mindig a fájl elejére teszi. A korábban ott lévő saját szabályaid ezért a blokk alá csúsznak. Ha egy funkcióhoz az kell, hogy a szabály a fájl elején vagy a végén maradjon, használd az **Add custom htaccess rules** segédbővítményt.

Csak akkor telepítsd, ha kényelmesen szerkesztesz fájlokat (S)FTP-n. A bővítmény működik, de ha a környezetedben ütközés lenne, előfordulhat, hogy (S)FTP-n kell eltávolítanod, és a `.htaccess` fájlt kézzel javítanod.

1. Írd be a saját szabályaidat a segédbővítmény 27. és 32. sora közé.
2. Állítsd be, hova kerüljenek a szabályok:
   - **A WP Rocket blokkja elé:** a 42. és 73. sor elé tegyél `//` jelet (kommentbe), a 41. és 72. sorról pedig vedd le a `//` jelet.
   - **A WP Rocket blokkja mögé:** a 41. és 72. sor elé tegyél `//` jelet, a 42. és 73. sorról vedd le. A segédbővítmény alapból így van beállítva, ilyenkor nem kell módosítanod.
3. Tömörítsd ZIP-be, töltsd fel, és aktiváld.
4. A módosítás ezután megjelenik a `.htaccess` fájlban. Ha a szabályokat a WP Rocket blokkja mögé teszed, ott fognak megjelenni a fájl végén egy külön blokkban.

## A .htaccess használatának kikapcsolása

Ha a szerveren nincs jogod módosítani a `.htaccess` fájlt, vagy más kompatibilitási okból nem akarod, hogy a WP Rocket hozzányúljon (és szeretnéd elkerülni a felesleges figyelmeztetéseket), telepítsd a **No .htaccess** segédbővítményt:

1. Töltsd le a segédbővítmény ZIP-fájlját.
2. Menj ide: **Bővítmények → Új hozzáadása → Bővítmény feltöltése**, és válaszd ki a ZIP-et.
3. Aktiváld a bővítményt.

## Az expires szabályok eltávolítása

Ha nem akarod, hogy a WP Rocket `mod_expires` szabályokat írjon a `.htaccess` fájlba, telepítsd a **Remove expires (mod_expires) rules** segédbővítményt. A telepítés ugyanúgy megy, mint az előző pontban: **Bővítmények → Új hozzáadása → Bővítmény feltöltése**, majd aktiválás.
