WordPressEscape

Kezdőlap / Útmutató

Műhelynapló

528 854 WordPress-oldal migrálása Hugo-ra: mérnöki jegyzetek

Ezek a munkajegyzetek az Unlimited Charters, a házon belüli testvérwebhelyünk WordPressről Hugo-ra történő átállításáról 2026 májusában. Az üzleti összefoglaló a sikertörténetben olvasható; itt az következik, ami annak szól, akinek el kell végeznie a munkát: mi romlott el félmillió oldalnál, mely parancsok okoztak gondot, és milyen ellenőrzéseket futtatunk mostantól minden webhelyen, legyen az kicsi vagy nagy.

6 perc olvasás 9 szakasz Jó helyezésre tervezve
Ezen az oldalon
  1. Környezet
  2. Sablonleltár a tartalom előtt
  3. Particionált buildek és fájlrendszer-buktatók
  4. Teljesítményjavítások: sablonmódosítás és a teljes korpusz átalakítása
  5. Fontos Cloudflare-beállítások
  6. Séma- és SEO-részletek
  7. A leadgyűjtés az a rész, amely nem veszhet el
  8. Mit csinálnánk másképp
  9. Források és további olvasnivaló
  10. Gyakran ismételt kérdések
Gyors válasz

Ebben a léptékben a problémák inkább fájlrendszer- és folyamatproblémák, mint Hugo-problémák: a build particionálása, a félretett tartalom Hugo tartalomcsatolási pontján kívül tartása, két mozgatási folyamat soha nem futhat ugyanazon a könyvtáron, és minden javítást sablonmódosításként, valamint az egész korpuszon lefuttatott szkriptelt átalakításként kell kezelni. A legnagyobb teljesítménynövekedést a képméretek megadása, a szinkron kritikus CSS, az LCP-kép lusta betöltésének kikapcsolása, a helyet előre lefoglaló, késleltetett ajánlatkérő widget, valamint a Cloudflare Email Obfuscation kikapcsolása hozta.

01

Környezet

Az Unlimited Charters ugyanahhoz a cégcsoporthoz tartozik, mint a WordPressEscape; ez a saját tesztmigrációnk volt, teljes szerverhozzáféréssel. A webhelynek valamivel több mint félmillió URL-je volt, főként sablonalapú helyszínoldalak, valamint huboldalak, flottával kapcsolatos oldalak és egy blog. A cél egy Hugo-build volt, amelyet statikus fájlokként, Cloudflare mögött szolgálunk ki, az összes meglévő útvonal megőrzésével.

02

Sablonleltár a tartalom előtt

Azzal kezdtük, hogy az URL-eket nem URL-minta, hanem az őket előállító WordPress-sablon szerint csoportosítottuk. Minden csoporthoz egy döntés tartozott: Hugo-layoutként építjük újra, vagy egyelőre a WordPress kimenetének statikus pillanatképét szolgáljuk ki. A nagy forgalmú csoportok újraépítése és a különleges esetek pillanatképként való kezelése lehetővé tette, hogy a projekt haladjon, és ne akadjon el az egyedi oldalak hosszú faroknyi sokaságán.

Egy fontos buktató: WordPressben az URL-útvonal nem mindig azonos a post_name sluggal. A szülőoldalak, az egyedi átírási szabályok és a régi importok olyan útvonalakat eredményeztek, amelyek nem egyeztek a sluggal, ezért az útvonalat nem az adatbázisból, hanem a feltérképezésből kellett kiolvasni.

03

Particionált buildek és fájlrendszer-buktatók

Az összes oldal egyetlen futtatásban történő renderelése lassú volt, és minden apró módosítást költségessé tett. Particionáltunk: a nem éppen buildelt forrásfájlokat áthelyeztük egy ideiglenes tárolóba, felépítettünk egy részhalmazt, telepítettük, majd visszaállítottuk. Négy buktató sok időnkbe került:

  1. Az ideiglenes tárolónak Hugo tartalomcsatolási pontján kívül kell lennie. Ha a csatolt tartalomkönyvtáron belül bárhol elhelyezkedik, Hugo továbbra is végigjárja az összes fájlt, így a particionálás semmit sem ér.
  2. A rsync --exclude=index.html minden szinten kizárja az összes index.html fájlt, nem csak a legfelső szinten lévőt. Rögzítsd a mintát a gyökérhez (--exclude=/index.html).
  3. Ha két párhuzamos mozgatási folyamat ugyanazon a könyvtáron dolgozik, egymásba ágyazzák azt. Két, egymással versengő visszaállítási folyamat körülbelül 367 000 könyvtárat hozott létre egy szinttel mélyebben a kelleténél. Élesben ez nem okozott problémát, mert a buildelt kimenetet szolgáltattuk ki; egyetlen szkriptelt mozgatás laposította vissza a struktúrát. A könyvtárat egyetlen folyamat kezeli, amit zárolással kényszerítünk ki.
  4. A mv dir/* target/ ekkora méretnél meghiúsul (túl hosszú argumentumlista). Használd a find ... -exec mv -t target {} + parancsot.
# néhány oldal renderelése a teljes újraépítés nélkül
flock /tmp/uc-content.lock bash -c '
  mv content/migrated/* ../stash/            # a tároló a tartalomcsatolási ponton KÍVÜL legyen
  for s in $(cat targets.txt); do mv ../stash/$s content/migrated/; done
  hugo --minify -d ../staged
  find ../stash -mindepth 1 -maxdepth 1 -exec mv -t content/migrated/ {} +
'
04

Teljesítményjavítások: sablonmódosítás és a teljes korpusz átalakítása

Minden javításnak két része volt: kijavítottuk a Hugo-sablont, hogy a jövőbeli buildek már helyesen készüljenek, és módosítottuk a már létrehozott HTML-t is, hogy a javítás teljes újraépítés nélkül élesíthető legyen. Ezek hozták a legnagyobb eredményt:

  • Képméretek. Egy sablon rögzítetten a width="1600" height="700" értékeket adta meg, miközben a CSS eltérő képarányt használt. Ezt 527 815 oldalon javítottuk. A width/height értékeknek egyezniük kell a megjelenített képaránnyal, különben a böngésző hibás méretű helyet foglal le (CLS optimalizálása).
  • Egymásnak ellentmondó aspect-ratio szabályok szerepeltek ugyanahhoz a szelektorhoz két stíluslapon; ezeket egyetlen szabályba vontuk össze.
  • A kritikus CSS az aszinkron fájlban volt. Az első megjelenítéshez szükséges mobilos szabályok egy késleltetett stíluslapon szerepeltek, ami késői újratördelést okozott. Áthelyeztük őket a szinkron stíluslapba.
  • Lustán betöltött hero-kép. A hajtás feletti képen lévő loading="lazy" késleltette az LCP-t; ezt a fetchpriority="high" értékre cseréltük (LCP optimalizálása).
  • Túlméretezett LCP-képek helyett kisebb változatokat használtunk, amivel oldalanként 50-440 KB-ot takarítottunk meg.
  • Ajánlatkérő widget: az első interakciókor töltődik be (időtúllépési tartalékmechanizmussal), a konténere pedig 480 px, mobilon 560 px helyet foglal le előre. Korábban a beillesztése körülbelül 0,54-es CLS-értékű oldaleltolódást okozott.
05

Fontos Cloudflare-beállítások

  • Az Email Obfuscation kikapcsolva. A dekódoló az oldal betöltése után végigjárja a DOM-ot, és átírja az e-mail-hivatkozásokat, ami layout shiftként jelent meg. Ez volt a legmakacsabb CLS-forrás, amelyet találtunk.
  • A Rocket Loader kikapcsolva. Átrendezi a szkripteket, és zavarta a késleltetett betöltést.
  • Gyorsítótár ürítése telepítés után. A peremhálózati gyorsítótárak régi HTML-t tartottak meg; az egyes telepítések után, útvonal alapján végzett ürítéssel elkerültük az elavult oldalak kiszolgálását (Cloudflare-dokumentáció a gyorsítótár ürítéséről).
  • Éles környezetben mérj, ne stagingen. A stagingkörnyezetben, azonos Cloudflare-beállítások nélkül kapott laboreredmények nem egyeztek az éles eredményekkel.
06

Séma- és SEO-részletek

  • A Search Console strukturáltadat-hibákat jelzett, mert egy Service entitásban szerepelt az aggregateRating és a review. Eltávolítottuk őket ahelyett, hogy megpróbáltuk volna érvényesíthetővé tenni; a jelölésnek a felhasználók számára látható tartalmat kell tükröznie (strukturáltadat-irányelvek).
  • A blogbejegyzések kezdetben a helyszínoldalak sablonjával jelentek meg, és hibás séma­-típust örököltek. Most már minden sablon maga deklarálja a saját entitását.
  • 35 következetlen flottakezelési és szolgáltatási útvonalat állandó átirányítással a megfelelő, beágyazott oldalakra irányítottunk (átirányítások).
  • A médiafájlokat a /wp-content/uploads/ útvonalról a /uploads/ alá helyeztük át egyetlen 301-es szabállyal; egy párhuzamos sed-futtatás néhány perc alatt 528 854 fájlból 528 852-ben átírta a hivatkozásokat.
  • A Yoastot eltávolítottuk, miután Hugo előállította a sitemapet, a sémát, a meta tageket és a robots.txt fájlt.
find static-v5 -name '*.html' -print0 \
  | xargs -0 -P 8 -n 500 sed -i 's|/wp-content/uploads/|/uploads/|g'
07

A leadgyűjtés az a rész, amely nem veszhet el

Az ajánlatkérő űrlap termeli a webhely bevételét, ezért külön ellenőrzéseket kapott: a widget beillesztési pontjának szerepelnie kell minden olyan oldal buildelt HTML-jében, amelyen az űrlap megjelent; a mezőneveknek egyezniük kell az adatfogadó végpont által elvárt nevekkel; és egy könyvtárat lecserélő telepítés nem törölheti az önálló ajánlatkérő oldalt. Ha az élesítés csendben megszünteti a leadgyűjtést, az összes SEO-mutató alapján sikeresnek tűnhet, miközben a vállalkozás elveszíti az érdeklődőket.

08

Mit csinálnánk másképp

  1. Már az első CLS-mérés előtt kikapcsolnánk az Email Obfuscationt.
  2. Már az első naptól particionálnánk a buildet.
  3. Már az első naptól zárolnánk a tartalomkönyvtárat.
  4. Már az első javítás előtt leírnánk a sablonmódosítás és a teljes korpusz átalakításának mintáját, nem csak az ötödik után.
  5. Az élesítés ellenőrzőlistájába beépítenénk a valós felhasználói adatokat (CrUX) vizsgáló ellenőrzést, mert a stagingen mért laboreredmények nem azonosak az éles környezettel.

Ugyanezen projekt üzleti nézőpontja, beleértve azt is, mit hagytunk WordPressen, a sikertörténetben olvasható.

09

Források és további olvasnivaló

Gyakran ismételt kérdések

Ügyfélmigrációról van szó?

Nem. Az Unlimited Charters ugyanahhoz a cégcsoporthoz tartozó, házon belüli testvérwebhely, mint a WordPressEscape. Ez a saját tesztesetünk.

Elbír a Hugo félmillió oldalt?

Igen, de a teljes újraépítések elég lassúak ahhoz, hogy a particionált buildek és a körültekintő fájlkezelés sokat számítsanak. A legtöbb problémánk fájlrendszer- és folyamatprobléma volt, nem Hugo-hiba.

Mi okozta a legnagyobb layout shiftet?

A helyet előre le nem foglaló ajánlatkérő widget beillesztése (a huboldalakon körülbelül 0,54-es CLS), valamint az, hogy a Cloudflare Email Obfuscation betöltés után átírta az oldalt.

Alkalmazhatók ezek a tanulságok kisebb webhelyekre is?

Igen. Ugyanezek az ellenőrzések (URL-egyezés, képméretek, kritikus CSS, nem lusta hero-kép, késleltetett widgetek) egy 40 oldalas webhelyen is alkalmazhatók; csak percek alatt futnak le órák helyett.

Vizsgálja meg ingyen az oldalamat

Nézd meg, hogy a te webhelyednél is alkalmazható-e ugyanez

Az ingyenes, 60 másodperces audit megmutatja a tényleges PageSpeed-pontszámodat, a pontos oldalszámot, a SEO-hiányosságokat és azokat a WordPress-funkciókat, amelyeket le kell cserélni. Ezután a WordPressEscape Hugo-ra építi újjá a webhelyedet, megtartja az összes URL-t, és már az első napon átadja a forráskódot - ugyanúgy, ahogy az UC esetében történt.

Vizsgálja meg ingyen az oldalamat
Olvass tovább
Minden útmutató33
Kapcsolódó keresésekwordpressről hugo-ra történő migráció528 854 oldal (házon belüli teszt)hugo particionált buildcloudflare cls-javítássémaadatok rendbetételeurl-egyezés