Μεταφορά περιεχομένου βάσης δεδομένων σε αρχεία με συγχρονισμό περιεχομένου
Τα block, τα πρότυπα και οι σελίδες που βασίζονται σε αρχεία βρίσκονται ήδη στο αποθετήριό σας. Κάποιο περιεχόμενο δεν ταιριάζει σε αυτό το μοντέλο, επειδή οι συντάκτες το δημιουργούν στη διαχείριση: μέλη ομάδας, τοποθεσίες γραφείων, μελέτες περίπτωσης. Αυτό το περιεχόμενο εξακολουθεί να έχει σημασία για το έργο. Ένας ιστότοπος δοκιμών χρειάζεται την ίδια σελίδα ομάδας με την παραγωγή, ένας νέος προγραμματιστής χρειάζεται ρεαλιστικά δεδομένα και ένας αξιολογητής πρέπει να βλέπει πότε κάποιος αλλάζει έναν τίτλο θέσης εργασίας. Τα αντίγραφα βάσης δεδομένων δεν λύνουν καλά κανένα από αυτά τα ζητήματα. Περιλαμβάνουν τα πάντα, τα ID διαφέρουν ανά περιβάλλον και κανείς δεν ελέγχει διαφορές SQL.
Το Content Sync καλύπτει αυτό το κενό. Μια εντολή WP-CLI προβάλλει μια λίστα επιτρεπόμενων αναρτήσεων, όρων, σχέσεων και μεταδεδομένων σε αρχεία JSON και HTML στο θέμα σας. Μια άλλη εντολή εφαρμόζει αυτά τα αρχεία σε διαφορετική βάση δεδομένων. Κάθε οντότητα αποκτά ένα φορητό UID και οι αναφορές μεταξύ οντοτήτων ξαναγράφονται μόνο όπου το δηλώσετε.
Αυτός ο οδηγός παρουσιάζει έναν κατάλογο ομάδας: πώς να τον εξαγάγετε σε αρχεία, να τα ελέγξετε, να επεξεργαστείτε ένα αρχείο, να τον μεταφέρετε σε νέο περιβάλλον και να διαγράψετε στοιχεία με ασφάλεια.
Το παράδειγμα
Το θέμα καταχωρίζει έναν τύπο ανάρτησης acme_member και μια ταξινομία acme_team σε κάθε περιβάλλον. Κάθε ανάρτηση μέλους μπορεί να περιέχει:
| Κλειδί μεταδεδομένων | Περιέχει |
|---|---|
_acme_role |
Τον τίτλο εργασίας, ως απλό συμβολοσειράς |
_acme_mentor |
Το ID ανάρτησης ενός άλλου μέλους |
_thumbnail_id |
Το ID συνημμένου του πορτρέτου |
_acme_api_token |
Ένα διακριτικό ενσωμάτωσης που δεν πρέπει ποτέ να φτάσει στο git |
Το Content Sync δεν καταχωρίζει ποτέ τύπους αναρτήσεων ή ταξινομίες. Πρέπει να υπάρχουν όπου κι αν κάνετε push.
Βήμα 1: Ρυθμίστε το Content Sync
Το Content Sync είναι απενεργοποιημένο μέχρι να το ενεργοποιήσετε στο blockstudio.json. Μέχρι τότε, κάθε εντολή επιστρέφει μία μόνο γραμμή 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.
Προσθέστε μια ομάδα 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"
}
}
Κάθε κλειδί ορίζει ένα όριο:
- Τα
postTypesκαιtaxonomiesείναι λίστες επιτρεπόμενων τιμών. Δεν διαβάζεται, δεν εγγράφεται και δεν διαγράφεται τίποτα εκτός αυτών. Ένα κενόpostTypesσημαίνει ότι δεν επηρεάζονται αναρτήσεις. - Το
meta.includeορίζει τα επιτρεπόμενα κλειδιά μεταδεδομένων, με χαρακτήρες μπαλαντέρ*. Τοmeta.excludeυπερισχύει πάντα, ενώ τα_edit_lock,_edit_lastκαι_wp_old_slugεξαιρούνται από προεπιλογή. - Το
meta.referencesδηλώνει ποιες τιμές μεταδεδομένων είναι ID. Το Content Sync δεν μαντεύει ποτέ ότι ένας ακέραιος είναι ID. - Το
idορίζει το σύνολο περιεχομένου. Αποθηκεύεται σε κάθε συγχρονισμένη οντότητα και η διαγραφή αφορά μόνο οντότητες του ίδιου συνόλου. - Το
pathείναι ο φάκελος εξόδου, σε σχέση με τον ενεργό κατάλογο του θέματος.
Βήμα 2: Εξαγωγή
Κάντε πρώτα προεπισκόπηση της προβολής. Δεν εγγράφεται τίποτα και τα UID που εμφανίζονται δεν έχουν ακόμη αποθηκευτεί:
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
Έπειτα εκτελέστε την εξαγωγή κανονικά. Αυτό αποδίδει ένα μόνιμο _blockstudio_content_uid σε κάθε οντότητα που δεν έχει και γράφει τα αρχεία:
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
Το αποτέλεσμα στο θέμα:
content/
├── media/
│ └── manifest.json
├── posts/
│ └── acme_member/
│ ├── jane.5d4bf9b5.html
│ ├── jane.5d4bf9b5.json
│ └── sam.208db72e.json
└── terms/
└── acme_team/
└── leadership.7491a6a1.json
Τα ονόματα αρχείων συνδυάζουν το slug με το πρώτο τμήμα του UID. Η ανάρτηση 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"
}
}
Η σχέση όρου και η μικρογραφία είναι UID, όχι τοπικά ID. Το σώμα της ανάρτησης βρίσκεται δίπλα, στο jane.5d4bf9b5.html, ως ακατέργαστη σήμανση block. Μια ανάρτηση με κενό περιεχόμενο, όπως του Sam, δεν αποκτά αρχείο .html. Το _acme_mentor του Sam αποθηκεύεται ως το UID της Jane, επειδή το κλειδί έχει δηλωθεί ως αναφορά post.
Βήμα 3: Ελέγξτε πριν από την υποβολή
Εκτελέστε το status πριν από την υποβολή. Συγκρίνει αρχεία και βάση δεδομένων και επισημαίνει επίσης επικίνδυνα δεδομένα:
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.
Ο χαρακτήρας μπαλαντέρ _acme_* εντόπισε το διακριτικό. Αντιμετωπίστε το meta.include ως όριο υποβολής και εξαιρέστε ρητά το κλειδί:
"meta": {
"include": ["_acme_*", "_thumbnail_id"],
"exclude": ["_acme_api_token"],
"references": {
"_acme_mentor": { "kind": "post" },
"_thumbnail_id": { "kind": "attachment" }
}
}
Το επόμενο pull ξαναγράφει το sam.208db72e.json χωρίς το διακριτικό και αφήνει τα άλλα αρχεία ανέπαφα. Το status προειδοποιεί επίσης για αριθμητικά ID μέσα στα σώματα σήμανσης block, επειδή το Content Sync δεν ξαναγράφει ID σε αρχεία .html.
Υποβάλετε τον φάκελο content/.
Βήμα 4: Επεξεργασία αρχείου και push
Τα αρχεία είναι η μοναδική πηγή αλήθειας για το push. Αλλάξτε τον ρόλο της Jane στο αρχείο JSON από Design Lead σε Head of Design και, έπειτα, ελέγξτε τι θα συνέβαινε:
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 εμφανίζει το ίδιο σχέδιο με τη σειρά του push. Εφαρμόστε το:
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
Το push επικυρώνει ολόκληρο το σχέδιο πριν γράψει. Οι ανεπίλυτες δηλωμένες αναφορές, οι διενέξεις slug, οι τύποι αναρτήσεων που λείπουν και τα κακοσχηματισμένα αρχεία διακόπτουν τη διαδικασία.
Το WordPress δίνει σε μια ενημερωμένη ανάρτηση νέα ώρα τροποποίησης, ενώ το αρχείο εξακολουθεί να έχει την παλιά τιμή modified. Επομένως, μια εκτέλεση status αμέσως μετά από αυτό το push αναφέρει την ανάρτηση της Jane ως conflict με το μήνυμα “Η βάση δεδομένων άλλαξε από τον τελευταίο συγχρονισμό.” Εκτελέστε το pull μία φορά μετά το push, για να καταγράψετε τη νέα ώρα. Τότε το status αναφέρει unchanged.
Βήμα 5: Μεταφορά περιεχομένου σε άλλο περιβάλλον
Σε ένα νέο περιβάλλον, τα αρχεία περιγράφουν αναρτήσεις που δεν υπάρχουν ακόμη. Σε αυτό το παράδειγμα, ο όρος και το συνημμένο πορτρέτου υπάρχουν ήδη εκεί με τα ίδια UID, οπότε λείπουν μόνο τα δύο μέλη:
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
Οι αναρτήσεις έλαβαν νέα τοπικά ID, 536 και 537. Οι αναφορές ακολούθησαν: το _acme_mentor του Sam περιέχει τώρα το 536, η Jane βρίσκεται ξανά στον όρο leadership και το _thumbnail_id της δείχνει το τοπικό συνημμένο με το αντίστοιχο UID. Οι γονικές αναρτήσεις, οι γονικοί όροι και οι σχέσεις όρων αποθηκεύονται πάντα ως UID. Οι τιμές μεταδεδομένων ξαναγράφονται μόνο για τα κλειδιά στο meta.references.
Ασφαλής διαγραφή
Η διαγραφή ενός αρχείου δεν διαγράφει τίποτα κατά το push, εκτός αν το ζητήσετε. Αφαιρέστε το sam.208db72e.json και δοκιμάστε τη διαγραφή:
wp bs content push --prune
Error: Refusing to prune without --yes. Re-run with --dry-run to inspect the plan or --yes to confirm.
Η δοκιμαστική εκτέλεση δείχνει τι θα διαγραφόταν:
wp bs content push --prune --dry-run
action entity id uid message
...
would-prune-trash post 537 208db72e-...
Το push --prune --yes μεταφέρει έπειτα την ανάρτηση του Sam στον κάδο και αναφέρει pruned-trash. Αρκετές δικλίδες περιορίζουν την ενέργεια:
- Υποψήφιες είναι μόνο οι οντότητες που ανήκουν σε αυτό το σύνολο περιεχομένου (
content.id). - Λαμβάνονται υπόψη μόνο οι ρυθμισμένοι τύποι αναρτήσεων και οι ταξινομίες.
- Ολόκληρο το σχέδιο προέλευσης αναλύεται και επικυρώνεται πριν από οποιαδήποτε εγγραφή ή διαγραφή. Αν υπάρχει κακοσχηματισμένο αρχείο JSON στον φάκελο, το push αναφέρει μια γραμμή
errorόπως ηcould not be read: Syntax errorκαι δεν διαγράφει τίποτα.
Η προεπιλεγμένη ενέργεια είναι trash. Το φίλτρο blockstudio/content/orphan_action μπορεί να επιστρέψει trash, delete ή keep για κάθε οντότητα. Έτσι, οι όροι διατηρούνται, ενώ για τις αναρτήσεις ισχύει η προεπιλεγμένη ενέργεια:
add_filter(
'blockstudio/content/orphan_action',
function ( string $action, string $type ) {
return 'term' === $type ? 'keep' : $action;
},
10,
2
);
Με αυτό, ένας ορφανός όρος αναφέρεται ως would-prune-keep αντί για would-prune-trash.
Πολυμέσα
Τα αρχεία πολυμέσων δεν αντιγράφονται ποτέ. Το content.media καθορίζει τι συμβαίνει με τις δηλωμένες αναφορές σε συνημμένα:
- Το
"manifest"(προεπιλογή) αποθηκεύει τα UID συνημμένων και τα παραθέτει στοcontent/media/manifest.jsonμαζί με τη διαδρομή, τον τύπο MIME και το εναλλακτικό κείμενο. Για το push απαιτείται να υπάρχει κάθε αναφερόμενο UID συνημμένου στον προορισμό, οπότε μεταφέρετε πρώτα τα αρχεία μεταφόρτωσης με τη συνήθη ροή εργασίας πολυμέσων. - Το
"none"παραλείπει από τα αρχεία τις δηλωμένες αναφορές σε συνημμένα. Τότε το JSON της Jane περιέχει μόνο το_acme_role. Επειδή ένα κλειδί που παραλείπεται δεν εφαρμόζεται κατά το push, μια υπάρχουσα ανάρτηση στον προορισμό διατηρεί την τρέχουσα μικρογραφία της.
Κλείδωμα οντότητας
Μερικές φορές ένα περιβάλλον προορισμού πρέπει να διατηρήσει τη δική του έκδοση μιας ανάρτησης. Ορίστε τα μεταδεδομένα _blockstudio_content_locked σε αληθή τιμή σε εκείνη την ανάρτηση και το push θα την παραλείψει με μια γραμμή locked και το μήνυμα “Η κλειδωμένη οντότητα παραλείφθηκε.” Διαγράψτε τα μεταδεδομένα για να συμπεριληφθεί ξανά.
Κανόνες ιδιοκτησίας
- Οι αναρτήσεις που διαχειρίζονται σελίδες βάσει αρχείων εξαιρούνται από προεπιλογή. Με το
includePageSyncManaged: true, το Content Sync μπορεί να συγχρονίζει τα διαμορφωμένα μεταδεδομένα τους, αλλά το Page Sync εξακολουθεί να διαχειρίζεται τοpost_contentτους. Αυτές οι προβολές JSON περιλαμβάνουν τοbodyOwner: "page-sync", και η λήψη αναφέρει ρητά το σώμα που παραλείφθηκε. Τα υπάρχοντα αντίγραφα ελέγχου.htmlδιατηρούνται και αγνοούνται κατά την αποστολή. Συγχρονίστε τις σελίδες σε ένα περιβάλλον προορισμού πριν από την αποστολή των προβολών μεταδεδομένων τους. - Οι συντάκτες αγνοούνται από προεπιλογή, επειδή οι χρήστες δεν συγχρονίζονται. Με το
authors: "login", τα αρχεία αναρτήσεων αποθηκεύουν το όνομα σύνδεσης του συντάκτη και η αποστολή το αντιστοιχίζει σε έναν υπάρχοντα χρήστη· αν ο χρήστης λείπει, προκύπτει σφάλμα προελέγχου. - Το
pullδεν διαγράφει ποτέ αρχεία. Όταν μια οντότητα της βάσης δεδομένων δεν υπάρχει πλέον, η λήψη αναφέρει το αρχείο της ως παλιό και αφήνει τον καθαρισμό σε εσάς.
Πότε να μην το χρησιμοποιείτε
Το Content Sync ενδείκνυται για επιμελημένο περιεχόμενο με λίγες αλλαγές: δεκάδες ή εκατοντάδες εγγραφές, έως και λίγες χιλιάδες όταν τα δεδομένα είναι δομημένα και κατανεμημένα σε στοχευμένους τύπους αναρτήσεων. Δεν αντικαθιστά τα αντίγραφα ασφαλείας ή τις μετεγκαταστάσεις βάσεων δεδομένων. Οι παραγγελίες, οι υποβολές φορμών, τα αρχεία καταγραφής, τα αναλυτικά στοιχεία και το εκδοτικό περιεχόμενο μεγάλου όγκου ανήκουν σε αυτά τα εργαλεία. Οι ορισμοί ταξινομιών, τα δυαδικά αρχεία πολυμέσων και τα ID μέσα στη σήμανση block δεν εμπίπτουν στο πεδίο εφαρμογής του.
Επόμενα βήματα
- Αναφορά Content Sync: όλα τα κλειδιά ρύθμισης, οι μορφές αρχείων και η αποθηκευμένη κατάσταση συγχρονισμού.
- Δημιουργία ιστότοπου τεκμηρίωσης: περιεχόμενο που ξεκινά σε αρχεία και συγχρονίζεται στο WordPress προς την αντίθετη κατεύθυνση.
- Δημιουργία σελίδων βασισμένων σε αρχεία: σελίδες των οποίων η δομή καθορίζεται από πρότυπα του θέματος.