Μετάβαση στο περιεχόμενο

Μεταφορά περιεχομένου βάσης δεδομένων σε αρχεία με συγχρονισμό περιεχομένου

Τα 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:

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"
  }
}

Κάθε κλειδί ορίζει ένα όριο:

  • Τα 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 περιέχει τα πεδία, τις σχέσεις όρων και τα επιτρεπόμενα μεταδεδομένα:

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 ως όριο υποβολής και εξαιρέστε ρητά το κλειδί:

JSON
"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 για κάθε οντότητα. Έτσι, οι όροι διατηρούνται, ενώ για τις αναρτήσεις ισχύει η προεπιλεγμένη ενέργεια:

PHP
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 δεν εμπίπτουν στο πεδίο εφαρμογής του.

Επόμενα βήματα