Liigu sisu juurde

Andmebaasi sisu teisaldamine failidesse sünkroonimise abil

Plokid, mallid ja failipõhised lehed asuvad juba teie hoidlas. Osa sisu sellesse mudelisse ei sobi, sest toimetajad loovad seda haldusliideses: meeskonnaliikmed, kontori asukohad ja juhtumiuuringud. See sisu on projektile siiski oluline. Testkeskkonnas peab olema sama meeskonna leht mis tootmiskeskkonnas, uus arendaja vajab realistlikke andmeid ning hindaja peaks muudatust nägema, kui keegi ametinimetust muudab. Andmebaasi tõmmised ei lahenda neid probleeme hästi. Need sisaldavad kõike, ID-d erinevad keskkonniti ja keegi ei vaata üle SQL diff-i.

Content Sync täidab selle lünga. Käsk WP-CLI projitseerib lubatud postitused, terminid, seosed ja metaandmed sinu teema JSON- ja HTML-failidesse. Teine käsk rakendab need failid teise andmebaasi. Iga olem saab teisaldatava UID-i ning olemitevahelised viited kirjutatakse ümber ainult seal, kus oled selle määranud.

See juhend käsitleb meeskonna kataloogi: selle failidesse toomist, ülevaatamist, faili muutmist, uude keskkonda viimist ja turvalist puhastamist.

Näide

Teema registreerib igas keskkonnas postitüübi acme_member ja taksonoomia acme_team. Iga liikmepostitus võib sisaldada järgmist:

Meta võti Sisaldab
_acme_role Ametinimetust lihttekstina
_acme_mentor Teise liikme postituse ID-d
_thumbnail_id Portree manuse ID-d
_acme_api_token Integratsioonitokenit, mis ei tohi kunagi git-i jõuda

Content Sync ei registreeri kunagi postitüüpe ega taksonoomiaid. Need peavad olemas olema igas keskkonnas, kuhu sisu edastad.

1. samm: Content Synci seadistamine

Content Sync on välja lülitatud, kuni selle blockstudio.json-is lubad. Seni tagastab iga käsk ühe rea kujul skipped:

Shell
wp bs content status
Kood
action   entity   id       uid  message
skipped  content  default       Content Sync is disabled. Set content.enabled to true to run this command.

Lisa rühm content:

JSON
{
  "$schema": "https://blockstudio.dev/schema/blockstudio",
  "content": {
    "enabled": true,
    "id": "team",
    "path": "content",
    "postTypes": ["acme_member"],
    "taxonomies": ["acme_team"],
    "meta": {
      "include": ["_acme_*", "_thumbnail_id"],
      "references": {
        "_acme_mentor": { "kind": "post" },
        "_thumbnail_id": { "kind": "attachment" }
      }
    },
    "media": "manifest"
  }
}

Iga võti määrab piirid:

  • postTypes ja taxonomies on lubatud loendid. Nendest väljapoole jäävat ei loeta, kirjutata ega puhastata. Tühi postTypes tähendab, et postitusi ei puudutata.
  • meta.include määrab meta võtmed, lubades metamärke *. meta.exclude on alati ülimuslik ning _edit_lock, _edit_last ja _wp_old_slug on vaikimisi välja jäetud.
  • meta.references määrab, millised meta väärtused on ID-d. Content Sync ei arva kunagi, et täisarv on ID.
  • id nimetab sisu hulga. See salvestatakse igale sünkroonitud olemile ning puhastamine puudutab ainult sama hulga olemeid.
  • path on väljundkaust aktiivse teemakataloogi suhtes.

2. samm: Too failidesse

Vaata esmalt eelvaadet. Midagi ei kirjutata ning kuvatud UID-e pole veel salvestatud:

Shell
wp bs content pull --dry-run
Kood
action       entity  id   uid          message
would-write  post    530  4c8e9997-...  .../posts/acme_member/jane.4c8e9997.json
would-write  post    531  6cddc303-...  .../posts/acme_member/sam.6cddc303.json
would-write  term    4    6661b6d9-...  .../terms/acme_team/leadership.6661b6d9.json

Seejärel too failidesse päriselt. See määrab püsiva _blockstudio_content_uid igale olemile, millel seda veel pole, ja kirjutab failid:

Shell
wp bs content pull
Kood
action   entity  id        uid          message
written  post    530       5d4bf9b5-...  .../posts/acme_member/jane.5d4bf9b5.json
written  post    531       208db72e-...  .../posts/acme_member/sam.208db72e.json
written  term    4         7491a6a1-...  .../terms/acme_team/leadership.7491a6a1.json
written  media   manifest                .../media/manifest.json

Tulemuseks on teemas järgmine:

Kood
content/
├── media/
│   └── manifest.json
├── posts/
│   └── acme_member/
│       ├── jane.5d4bf9b5.html
│       ├── jane.5d4bf9b5.json
│       └── sam.208db72e.json
└── terms/
    └── acme_team/
        └── leadership.7491a6a1.json

Failinimed ühendavad nälja UID-i esimese osaga. Postituse JSON sisaldab välju, terminite seoseid ja lubatud metaandmeid:

JSON
{
    "uid": "5d4bf9b5-16b7-4975-acc6-51dc1d4e49ec",
    "type": "acme_member",
    "status": "publish",
    "slug": "jane",
    "title": "Jane Doe",
    "date": "2026-10-13T03:03:02+00:00",
    "modified": "2026-10-13T03:03:02+00:00",
    "parent": null,
    "menuOrder": 0,
    "terms": {
        "acme_team": [
            "7491a6a1-702c-4a29-9993-9ae7b2a79c0a"
        ]
    },
    "meta": {
        "_acme_role": "Design Lead",
        "_thumbnail_id": "72a2db75-6fd2-41f9-8d3c-b323ce3b3551"
    },
    "metaEncoding": {
        "_acme_role": "scalar",
        "_thumbnail_id": "scalar"
    }
}

Termini seos ja pisipilt on UID-d, mitte kohalikud ID-d. Postituse sisu asub selle kõrval failis jane.5d4bf9b5.html töötlemata plokimärgistusena. Tühja sisuga postitusele, nagu Sami omale, .html faili ei looda. Sami _acme_mentor salvestatakse Jane’i UID-na, sest võti on määratud kui post viide.

3. samm: Vaata enne sissekandmist üle

Käivita enne sissekandmist status. See võrdleb faile ja andmebaasi ning annab märku ka riskantsetest andmetest:

Shell
wp bs content status
Kood
action     entity  id               uid          message
unchanged  post    530              5d4bf9b5-...  .../posts/acme_member/jane.5d4bf9b5.json
unchanged  post    531              208db72e-...  .../posts/acme_member/sam.208db72e.json
unchanged  term    4                7491a6a1-...  .../terms/acme_team/leadership.7491a6a1.json
warning    meta    _acme_api_token                Allowlisted meta key may contain secrets or PII; review before committing synced files.

Metamärk _acme_* leidis tokeni. Käsitle meta.include-i sissekandmise piirina ja jäta võti selgesõnaliselt välja:

JSON
"meta": {
  "include": ["_acme_*", "_thumbnail_id"],
  "exclude": ["_acme_api_token"],
  "references": {
    "_acme_mentor": { "kind": "post" },
    "_thumbnail_id": { "kind": "attachment" }
  }
}

Järgmine pull kirjutab sam.208db72e.json ilma tokenita uuesti ega puuduta teisi faile. status hoiatab ka plokimärgistuse sisus olevate numbriliste ID-de eest, sest Content Sync ei kirjuta ID-sid .html-failides ümber.

Anna content/-kaust sisse.

4. samm: Muuda faili ja edasta

Failid on push-i tõeallikas. Muuda Jane’i ametikohta JSON-failis väärtuselt Design Lead väärtusele Head of Design ja vaata siis, mis juhtuks:

Shell
wp bs content status
Kood
action        entity  id   uid          message
would-update  post    530  5d4bf9b5-...  .../posts/acme_member/jane.5d4bf9b5.json
unchanged     post    531  208db72e-...  .../posts/acme_member/sam.208db72e.json
unchanged     term    4    7491a6a1-...  .../terms/acme_team/leadership.7491a6a1.json

push --dry-run väljastab sama plaani edastamise järjekorras. Rakenda see:

Shell
wp bs content push
Kood
action     entity  id   uid          message
unchanged  term    4    7491a6a1-...  .../terms/acme_team/leadership.7491a6a1.json
updated    post    530  5d4bf9b5-...  .../posts/acme_member/jane.5d4bf9b5.json
unchanged  post    531  208db72e-...  .../posts/acme_member/sam.208db72e.json

Edastamisel kontrollitakse kogu plaan enne kirjutamist. Lahendamata määratud viited, nälja konfliktid, puuduvad postitüübid ja vigased failid peatavad toimingu.

WordPress annab uuendatud postitusele uue muutmisaja, kuid failis on endiselt vana modified väärtus. Seepärast teatab kohe pärast seda edastust tehtav status käivitus Jane’i postituse olekuks conflict koos sõnumiga „Andmebaasi on pärast viimast sünkroonimist muudetud.“ Käivita pärast edastamist üks kord pull, et uus aeg talletada; seejärel teatab status tulemuseks unchanged.

5. samm: Vii sisu teise keskkonda

Uues keskkonnas kirjeldavad failid postitusi, mida seal veel pole. Selles näites on termin ja portree manus seal juba samade UID-dega olemas, seega puuduvad vaid kaks liiget:

Shell
wp bs content status
Kood
action      entity  id    uid          message
missing-db  post    jane  5d4bf9b5-...  .../posts/acme_member/jane.5d4bf9b5.json
missing-db  post    sam   208db72e-...  .../posts/acme_member/sam.208db72e.json
unchanged   term    4     7491a6a1-...  .../terms/acme_team/leadership.7491a6a1.json
Shell
wp bs content push
Kood
action     entity  id   uid          message
unchanged  term    4    7491a6a1-...  .../terms/acme_team/leadership.7491a6a1.json
created    post    536  5d4bf9b5-...  .../posts/acme_member/jane.5d4bf9b5.json
created    post    537  208db72e-...  .../posts/acme_member/sam.208db72e.json

Postitused said uued kohalikud ID-d: 536 ja 537. Viited kandusid üle: Sami _acme_mentor sisaldab nüüd väärtust 536, Jane on taas terminis leadership ja tema _thumbnail_id viitab vastava UID-ga kohalikule manusele. Postituste ülem-elemendid, terminite ülem-elemendid ja terminite seosed salvestatakse alati UID-dena; meta väärtused kirjutatakse ümber ainult võtmete puhul, mis on määratud väärtuses meta.references.

Turvaline puhastamine

Faili kustutamine ei kustuta edastamisel midagi, kui sa seda ei palu. Eemalda sam.208db72e.json ja proovi puhastada:

Shell
wp bs content push --prune
Kood
Error: Refusing to prune without --yes. Re-run with --dry-run to inspect the plan or --yes to confirm.

Kuivkäivitus näitab, mis kustutataks:

Shell
wp bs content push --prune --dry-run
Kood
action             entity  id   uid          message
...
would-prune-trash  post    537  208db72e-...

Seejärel teisaldab push --prune --yes Sami postituse prügikasti ja teatab tulemuseks pruned-trash. Mitmed kaitsemeetmed hoiavad ulatuse kitsana:

  • Kandidaadid on ainult sellele sisuhulgale (content.id) kuuluvad olemid.
  • Arvesse võetakse ainult seadistatud postitüüpe ja taksonoomiaid.
  • Kogu lähteplaan parsitakse ja valideeritakse enne kirjutamist või puhastamist. Kui kaustas on vigane JSON-fail, teatab edastamine näiteks rea error kujul could not be read: Syntax error ega puhasta midagi.

Vaikimisi toiming on trash. Filter blockstudio/content/orphan_action võib iga olemi kohta tagastada trash, delete või keep. Nii säilivad terminid, samal ajal kui postitustele rakendub vaikeseade:

PHP
add_filter(
	'blockstudio/content/orphan_action',
	function ( string $action, string $type ) {
		return 'term' === $type ? 'keep' : $action;
	},
	10,
	2
);

Selle korral teatatakse orvuks jäänud termini olekuks would-prune-keep, mitte would-prune-trash.

Meedia

Meediafaile ei kopeerita kunagi. content.media määrab, mis saab määratud manusviidetest:

  • "manifest" (vaikeseade) salvestab manuste UID-d ja loetleb need failis content/media/manifest.json koos tee, MIME tüübi ja alternatiivtekstiga. Edastamiseks peab iga viidatud manuse UID sihtkeskkonnas olemas olema, seega vii üleslaaditud failid esmalt oma tavapärase meediatöövoo abil üle.
  • "none" jätab määratud manusviited failidest välja. Jane’i JSON sisaldab siis ainult väärtust _acme_role. Kuna väljajäetud võtit edastamisel ei rakendata, säilitab olemasolev sihtpostitus oma praeguse pisipildi.

Olemi lukustamine

Mõnikord peab sihtkeskkond säilitama ühe postituse enda versiooni. Määra selle postituse meta väärtuseks _blockstudio_content_locked tõeväärtusena tõene ja edastamine jätab selle vahele, lisades rea locked ning sõnumi „Lukustatud olem jäeti vahele.“ Meta kustutamisel kaasatakse see uuesti.

Omanikureeglid

  • Failipõhiste lehtedega hallatavad postitused jäetakse vaikimisi välja. Valikuga includePageSyncManaged: true võib Content Sync nende seadistatud metaandmeid sünkroonida, kuid Page Sync haldab endiselt nende post_content. Need JSON projektsioonid sisaldavad väärtust bodyOwner: "page-sync" ning tõmbamisel antakse vahele jäetud sisuosast selgesõnaliselt teada. Olemasolevad .html ülevaatuskoopiad säilitatakse ja push eirab neid. Sünkroonige lehed sihtkeskkonnas enne nende metaandmete projektsioonide push’imist.
  • Autorid jäetakse vaikimisi välja, sest kasutajaid ei sünkroonita. Valikuga authors: "login" salvestavad postituse failid autori kasutajanime ning push leiab sellele vastava olemasoleva kasutaja; puuduva kasutaja korral tekib eelkontrolli viga.
  • pull ei kustuta kunagi faile. Kui andmebaasi üksus puudub, teatatakse tõmbamisel, et selle fail on aegunud, ning puhastamise jätab süsteem teile.

Millal seda mitte kasutada

Content Sync sobib kureeritud ja harva muutuvale sisule: kümnetele või sadadele kirjetele ning kuni mõnele tuhandele, kui andmed on struktureeritud ja jaotatud kindla eesmärgiga postitüüpidesse. See ei asenda andmebaasi varukoopiaid ega migratsioone. Tellimused, vormi esildised, logid, analüütika ja suure mahuga toimetussisu kuuluvad nende tööriistade alla. Taksonoomiamääratlused, meedia kahendandmed ja plokimärgistuse sees olevad ID-d jäävad selle ulatusest välja.

Järgmised sammud