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:
wp bs content status
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:
{
"$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:
postTypesjataxonomieson lubatud loendid. Nendest väljapoole jäävat ei loeta, kirjutata ega puhastata. TühipostTypestähendab, et postitusi ei puudutata.meta.includemäärab meta võtmed, lubades metamärke*.meta.excludeon alati ülimuslik ning_edit_lock,_edit_lastja_wp_old_slugon vaikimisi välja jäetud.meta.referencesmäärab, millised meta väärtused on ID-d. Content Sync ei arva kunagi, et täisarv on ID.idnimetab sisu hulga. See salvestatakse igale sünkroonitud olemile ning puhastamine puudutab ainult sama hulga olemeid.pathon väljundkaust aktiivse teemakataloogi suhtes.
2. samm: Too failidesse
Vaata esmalt eelvaadet. Midagi ei kirjutata ning kuvatud UID-e pole veel salvestatud:
wp bs content pull --dry-run
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:
wp bs content pull
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:
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:
{
"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:
wp bs content status
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:
"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:
wp bs content status
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:
wp bs content push
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:
wp bs content status
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
wp bs content push
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:
wp bs content push --prune
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:
wp bs content push --prune --dry-run
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
errorkujulcould not be read: Syntax errorega 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:
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 failiscontent/media/manifest.jsonkoos 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: truevõib Content Sync nende seadistatud metaandmeid sünkroonida, kuid Page Sync haldab endiselt nendepost_content. Need JSON projektsioonid sisaldavad väärtustbodyOwner: "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. pullei 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
- Content Synci viide: kõik seadistusvõtmed, failivormingud ja salvestatud sünkroonimisolek.
- Dokumentatsioonisaidi loomine: sisu, mis algab failides ja sünkroonitakse vastupidises suunas WordPress.
- Failipõhiste lehtede loomine: lehed, mille struktuuri määravad teema mallid.