Εξυπηρέτηση του WordPress ως στατικού HTML
Οι περισσότερες σελίδες ενός ιστότοπου μάρκετινγκ ή τεκμηρίωσης είναι ίδιες για όλους τους ανώνυμους επισκέπτες. Το WordPress εξακολουθεί να εκκινείται, να φορτώνει κάθε πρόσθετο, να εκτελεί το θέμα και να αποδίδει τα μπλοκ σε κάθε αίτημα. Ένα πρόσθετο προσωρινής αποθήκευσης σελίδων μπορεί να βοηθήσει, αλλά προσθέτει ακόμη ένα στοιχείο με τους δικούς του κανόνες για το τι είναι ασφαλές να αποθηκευτεί.
Το Blockstudio παρέχει προαιρετική προαπόδοση στατικού περιεχομένου. Αποθηκεύει πλήρη έγγραφα HTML ανώνυμων επισκεπτών στον δικό του κατάλογο προσωρινής αποθήκευσης και, αν το επιτρέψετε, τα εξυπηρετεί από ένα πρόσθετο αρχείο advanced-cache.php πριν εκκινηθεί το WordPress. Όλες οι ρυθμίσεις βρίσκονται στο blockstudio.json.
Αυτός ο οδηγός ενεργοποιεί τη λειτουργία βήμα προς βήμα, δείχνει πώς να ελέγξετε τι αποθηκεύεται και τι όχι, εξηγεί τον έναν κανόνα που προστατεύει τους συνδεδεμένους επισκέπτες και ολοκληρώνεται με μια ρύθμιση CDN που αποθηκεύει στην κρυφή μνήμη μόνο ό,τι ο διακομιστής προέλευσης χαρακτηρίζει ως αποθηκεύσιμο.
Πώς εξυπηρετείται ένα αίτημα
Με ενεργοποιημένη την προαπόδοση, ένα επιλέξιμο αίτημα καταλήγει με έναν από τρεις τρόπους:
- Άμεση εύρεση. Το πρόσθετο αρχείο εντοπίζει ένα αποθηκευμένο έγγραφο στον χάρτη διαδρομών του και το μεταδίδει πριν φορτωθεί το WordPress. Η απόκριση περιέχει το
X-Blockstudio-Static-Prerender: HIT-EARLY. - Εύρεση. Εκκινείται το WordPress και, στο
template_redirect, το Blockstudio εντοπίζει ένα πρόσφατο αποθηκευμένο έγγραφο και το στέλνει αντί να αποδώσει το πρότυπο. Η απόκριση περιέχει τοX-Blockstudio-Static-Prerender: HIT. - Απουσία. Το WordPress αποδίδει κανονικά τη σελίδα. Αν ο επισκέπτης είναι ανώνυμος και το αποτέλεσμα είναι πλήρες έγγραφο HTML με κατάσταση 200, το Blockstudio το αποθηκεύει για το επόμενο αίτημα.
Τα μη επιλέξιμα αιτήματα δεν αγγίζουν ποτέ την κρυφή μνήμη.
Βήμα 1: Ενεργοποίηση του προφίλ και της κρυφής μνήμης
Ξεκινήστε με το προφίλ απόδοσης και την προαπόδοση, με απενεργοποιημένη την πρόωρη εξυπηρέτηση:
{
"$schema": "https://blockstudio.dev/schema/blockstudio",
"performance": {
"profile": "speed",
"staticPrerender": {
"enabled": true,
"ttl": 86400,
"earlyServe": false,
"dynamicPaths": ["/account", "/checkout", "/login"],
"warm": {
"enabled": true,
"interval": 900,
"concurrency": 4
}
}
}
}
Τι κάνει κάθε ρύθμιση:
- Το
profile: "speed"ενεργοποιεί τις προεπιλογές παραγωγής για το frontend: αφαιρούνται ο περιττός κώδικας κεφαλίδας, η ανακάλυψη oEmbed, τα XML-RPC και τα γενικά στοιχεία frontend του πυρήνα, ενώ οι σύνδεσμοι ίδιας προέλευσης προφορτώνονται με πρόθεση. Δοκιμάστε πρώτα την αφαίρεση των στοιχείων frontend του πυρήνα, γιατί μια σελίδα που εξαρτάται από αυτά θα παρουσιάσει εμφανή προβλήματα. Κάθε θυγατρική τιμή υπερισχύει του προφίλ. - Το
staticPrerender.enabledκαταχωρίζει τον χρόνο εκτέλεσης. Όσο είναιfalse, η λειτουργία δεν γράφει αρχεία ούτε καταχωρίζει hooks αιτημάτων. - Το
ttlείναι η μέγιστη διάρκεια διατήρησης ενός αποθηκευμένου εγγράφου σε δευτερόλεπτα (προεπιλογή86400). - Το
dynamicPathsπαραθέτει τα προθέματα διαδρομών που πρέπει πάντα να αποδίδονται ζωντανά. - Το
warmπρογραμματίζει μια εργασία παρασκηνίου που ανανεώνει τις παρωχημένες δημόσιες διευθύνσεις URL κάθεintervalδευτερόλεπτα.
Η γραμμή $schema καλύπτει όλα τα κλειδιά, επομένως ένας επεξεργαστής με υποστήριξη σχήματος JSON επισημαίνει ένα λάθος όπως το "ttl": 0 (η ελάχιστη τιμή είναι 1).
Βήμα 2: Κατανόηση των επιλέξιμων αιτημάτων
Το Blockstudio εφαρμόζει συντηρητικούς κανόνες αποθήκευσης. Αυτά τα αιτήματα παρακάμπτουν πάντα την κρυφή μνήμη:
- οτιδήποτε άλλο εκτός από
GET - οποιοδήποτε URL με συμβολοσειρά ερωτήματος
wp-admin,wp-json,wp-login.php,xmlrpc.php, Ajax και cron- ροές, αναζητήσεις και διαδρομές προεπισκόπησης
- αιτήματα που στέλνουν κεφαλίδα
X-WP-Nonce - διαδρομές κάτω από το
dynamicPaths - επισκέπτες με cookie
wordpress_logged_in_*,wp-postpass_*ήcomment_author_email_*, εκτός αν είναι ενεργό τοserveLoggedIn
Οι δυναμικές διαδρομές αντιστοιχίζονται με βάση τα όρια διαδρομών. Με την παραπάνω διαμόρφωση:
| Αίτημα | Παράκαμψη |
|---|---|
/pricing/ |
όχι |
/account/orders/ |
ναι |
/accounting/ |
όχι |
/checkout |
ναι |
/pricing/?utm_source=x |
ναι |
/blog/feed/ |
ναι |
Κατά την αποθήκευση διατηρούνται μόνο πλήρη έγγραφα: η απόκριση πρέπει να ξεκινά με <!doctype html ή <html, να έχει κατάσταση 200 και να μην περιέχει τον δείκτη εξαίρεσης. Ένα πρότυπο που δεν πρέπει ποτέ να αποθηκεύεται μπορεί να εμφανίσει τον δείκτη οπουδήποτε στη σελίδα:
<!-- blockstudio:no-cache -->
Οι σελίδες σφάλματος δεν αποθηκεύονται ποτέ, επομένως μια θεματοποιημένη σελίδα 404 δεν μπορεί να αναπαραχθεί ως επιτυχής.
Βήμα 3: Έλεγχος ευρεμάτων
Επισκεφθείτε μερικές σελίδες σε ιδιωτικό παράθυρο και έπειτα ρωτήστε το Blockstudio τι περιέχει:
wp bs prerender status
{
"enabled": true,
"invalidate": "signature",
"identity": "e6cdd3fcda14ad6ded85a763bd01a33b",
"cacheRoot": ".../wp-content/blockstudio/cache/sites/.../static-prerender",
"files": 0,
"bytes": 0,
"records": 0,
"queue": {
"pending": 0,
"processing": 0,
"done": 0,
"unique": 0,
"bytes": 0
},
...
"diagnostics": []
}
Τα files και bytes αυξάνονται καθώς αποθηκεύονται έγγραφα, το queue εμφανίζει την ουρά αναμονής της εργασίας ανανέωσης και το diagnostics περιέχει μετρητές ευρημάτων, αστοχιών, δημιουργιών και αποτυχιών ανά εύρος. Για να ελέγξετε μία σελίδα, ζητήστε την δύο φορές ως ανώνυμος επισκέπτης και αναζητήστε την κεφαλίδα:
curl -s -o /dev/null -D - https://example.com/pricing/ | grep -i x-blockstudio-static-prerender
Η δεύτερη απόκριση περιέχει το X-Blockstudio-Static-Prerender: HIT. Χρησιμοποιήστε ένα GET όπως παραπάνω: το curl -I στέλνει αίτημα HEAD, το οποίο παρακάμπτει πάντα την κρυφή μνήμη.
Βήμα 4: Εξυπηρέτηση πριν από την εκκίνηση του WordPress
Μόλις τα ευρήματα φαίνονται σωστά, ορίστε το "earlyServe": true. Το Blockstudio αναλαμβάνει τότε τρία μικρά στοιχεία κατάστασης: ένα πρόσθετο αρχείο wp-content/advanced-cache.php, έναν κοινό χάρτη διαδρομών wp-content/blockstudio-static-prerender-map.php και μια δήλωση WP_CACHE στο wp-config.php. Εγκαθίστανται στο επόμενο αίτημα διαχείρισης.
Μερικοί κανόνες διασφαλίζουν την ασφαλή λειτουργία σε κοινόχρηστη φιλοξενία και σε εγκαταστάσεις πολλών ιστοτόπων:
- Το Blockstudio δεν αντικαθιστά ποτέ ένα drop-in, έναν χάρτη ή μια γραμμή
WP_CACHEπου δεν του ανήκει. Αν κάποιο άλλο πρόσθετο προσωρινής αποθήκευσης έχει ήδη την κυριότητα τουadvanced-cache.php, η πρώιμη εξυπηρέτηση παραμένει απενεργοποιημένη. - Αν το
WP_CACHEέχει ήδη οριστεί ωςtrue, τοwp-config.phpπαραμένει ανέπαφο. Σε περιβάλλοντα φιλοξενίας όπου τοwp-config.phpδεν είναι εγγράψιμο, ορίστε το εσείς. - Πριν από την εξυπηρέτηση, τόσο το drop-in όσο και η διαδρομή PHP ελέγχουν αν εξακολουθεί να υπάρχει το φύλλο στυλ Tailwind με κατακερματισμένο περιεχόμενο, στο οποίο συνδέεται ένα έγγραφο. Αν δεν υπάρχει, το αίτημα προωθείται στο WordPress αντί να εξυπηρετηθεί χωρίς στυλ.
- Οι καταχωρίσεις Multisite μοιράζονται έναν χάρτη, αλλά απομονώνονται ανά κεντρικό υπολογιστή, διαδρομή αρχικής σελίδας και αναγνωριστικό ιστότοπου.
- Οι κεφαλίδες απόκρισης που ορίζονται στο
replayHeaders, με προεπιλογή τοLink, αποθηκεύονται μαζί με κάθε έγγραφο και επαναποστέλλονται σε κάθε επιτυχημένη ανάκτηση, ώστε μια κεφαλίδαLinkπου στέλνει μια σελίδα με τοheader()να διατηρείται κατά την πρώιμη εξυπηρέτηση. Οι κεφαλίδες cookie και προσωρινής αποθήκευσης δεν επαναποστέλλονται ποτέ.
Οι πρώιμες επισκέψεις φέρουν X-Blockstudio-Static-Prerender: HIT-EARLY. Αν απενεργοποιήσετε το earlyServe ή το enabled, αφαιρείται μία φορά η κατάσταση που διαχειρίζεται το Blockstudio, ενώ το wp bs teardown την αφαιρεί ρητά για εγκαταστάσεις Composer χωρίς hook απενεργοποίησης.
Συνδεδεμένοι επισκέπτες και πανομοιότυπη σήμανση
Από προεπιλογή, οι συνδεδεμένοι επισκέπτες λαμβάνουν πάντα ζωντανή απόδοση. Με τη ρύθμιση "serveLoggedIn": true μπορούν επίσης να χρησιμοποιούν ένα υπάρχον αποθηκευμένο έγγραφο, ώστε ο ιστότοπος να είναι εξίσου γρήγορος για συντάκτες και πελάτες όσο και για ανώνυμους επισκέπτες.
Οι εξατομικευμένες αποκρίσεις δεν δημιουργούν ποτέ εγγραφές στην προσωρινή μνήμη: αν δεν υπάρχει αποθηκευμένο έγγραφο για συνδεδεμένο χρήστη, η σελίδα αποδίδεται ζωντανά και δεν αποθηκεύεται. Η συνέπεια συχνά περνά απαρατήρητη. Όταν είναι ενεργό το serveLoggedIn, ένας συνδεδεμένος επισκέπτης λαμβάνει το ανώνυμο έγγραφο όποτε υπάρχει και εξατομικευμένη ζωντανή απόδοση μόνο όταν δεν υπάρχει. Κάθε διακλάδωση προτύπου που εξαρτάται από τον τρέχοντα χρήστη εμφανίζεται μόνο όταν δεν υπάρχει αποθηκευμένο έγγραφο. Έτσι, η ίδια σελίδα αλλάζει από επίσκεψη σε επίσκεψη και η εξατομικευμένη διακλάδωση ουσιαστικά δεν χρησιμοποιείται στις διαδρομές με προσωρινή αποθήκευση.
Ο κανόνας που προκύπτει είναι ο εξής: σε κάθε διαδρομή εκτός του dynamicPaths, η σήμανση για συνδεδεμένους χρήστες πρέπει να είναι πανομοιότυπη byte προς byte με την ανώνυμη σήμανση. Αυτό σημαίνει ότι δεν πρέπει να υπάρχουν διακλαδώσεις is_user_logged_in() ή wp_get_current_user() σε πρότυπα που αποδίδονται σε στατικές διαδρομές:
<?php // Do not do this on a static route. ?>
<?php if ( is_user_logged_in() ) : ?>
<a href="/account/">Hi, <?php echo esc_html( wp_get_current_user()->display_name ); ?></a>
<?php else : ?>
<a href="/login/">Sign in</a>
<?php endif; ?>
Υπάρχουν δύο καθαρές λύσεις. Μεταφέρετε τη διαδρομή στο dynamicPaths όταν ολόκληρη η σελίδα είναι εξατομικευμένη, όπως ένας πίνακας ελέγχου λογαριασμού. Ή διατηρήστε τη σελίδα στατική και αποδώστε το εξατομικευμένο μέρος ως δυναμικό block island, το οποίο τοποθετεί ένα ασφαλές για την προσωρινή μνήμη placeholder στο αποθηκευμένο HTML και ανακτά το πραγματικό απόσπασμα με ξεχωριστό αίτημα του επισκέπτη:
<?php echo bs_block( array( 'name' => 'acme/greeting' ) ); ?>
Ο οδηγός Εξατομικευμένα αποσπάσματα σε σελίδες με προσωρινή αποθήκευση υλοποιεί αυτό το block.
Ακύρωση βάσει υπογραφής ή γράφου
Το invalidate καθορίζει πότε λήγουν τα αποθηκευμένα έγγραφα.
| Πτυχή | signature (προεπιλογή) |
graph |
|---|---|---|
| Ποιος γεμίζει την προσωρινή μνήμη | αιτήματα χωρίς αποθηκευμένο έγγραφο από ανώνυμους χρήστες και η διεργασία προθέρμανσης | το βήμα δημιουργίας, καθώς και αιτήματα χωρίς αποθηκευμένο έγγραφο από ανώνυμους χρήστες |
| Τι λήγει τις εγγραφές | TTL, αποθηκεύσεις αναρτήσεων, αλλαγές σε επίπεδο ιστότοπου | νέα δημιουργία, με το TTL ως ανώτατο όριο |
| Διεργασία προθέρμανσης στο παρασκήνιο | διαθέσιμη | απενεργοποιημένη |
| Κατάλληλο για | συνηθισμένους ιστότοπους | ιστότοπους με pipeline ανάπτυξης |
Η λειτουργία signature δεν απαιτεί εργαλεία. Η αποθήκευση μιας ανάρτησης εκκαθαρίζει ή ξαναθερμαίνει την αρχική σελίδα και τον μόνιμο σύνδεσμο της ανάρτησης, ενώ αλλαγές σε επίπεδο ιστότοπου, όπως η αλλαγή θέματος, ανανεώνουν την ταυτότητα της προσωρινής μνήμης.
Η λειτουργία graph προορίζεται για ντετερμινιστικές αναπτύξεις. Μια διαδικασία δημιουργίας υπολογίζει ένα πλάνο με το Static_Prerender_Runtime::build_plan(), αποδίδει μόνο τις επηρεαζόμενες διευθύνσεις URL, καταγράφει κάθε αποτέλεσμα και ενεργοποιεί ατομικά το ολοκληρωμένο σύνολο με το Static_Prerender_Early_Serve::install_artifact_entry(). Αν αποτύχει η επικύρωση οποιουδήποτε εγγράφου στο οποίο γίνεται αναφορά, το προηγούμενο σύνολο παραμένει ενεργό. Οι αντιστοιχισμένες διαδρομές εξυπηρετούνται από το ενεργοποιημένο τεχνούργημα μέχρι να το αντικαταστήσει η επόμενη διαδικασία δημιουργίας, επομένως το περιεχόμενο που τροποποιείται στο wp-admin φτάνει σε αυτές τις διαδρομές με την επόμενη ανάπτυξη. Η διεργασία προθέρμανσης ανά URL είναι απενεργοποιημένη σε αυτήν τη λειτουργία, επειδή τα τεχνουργήματα δημιουργούνται και ενεργοποιούνται ως ενιαία μονάδα. Μια τυπική διαμόρφωση παραγωγής είναι η εξής:
{
"performance": {
"profile": "speed",
"staticPrerender": {
"enabled": true,
"invalidate": "graph",
"ttl": 2592000,
"earlyServe": true,
"serveLoggedIn": true,
"dynamicPaths": [
"/account",
"/cart",
"/checkout",
"/login",
"/reset-password"
]
}
}
}
Το ttl διάρκειας 30 ημερών απλώς ορίζει το μέγιστο επιτρεπόμενο διάστημα παλαιότητας ενός εγγράφου που εξυπηρετείται. Η ενημέρωση γίνεται με την ανάπτυξη που αναδημιουργεί τον γράφο. Η διαδικασία δημιουργίας API, η τμηματοποίηση και η εσωτερική μεταφορά απόδοσης περιγράφονται στην αναφορά Στατικής προαπόδοσης.
Τοποθέτηση ενός CDN μπροστά
Η προαπόδοση υποδεικνύει ήδη ποιες αποκρίσεις είναι ασφαλές να κοινοποιούνται: ακριβώς όσες έχουν κεφαλίδα HIT. Ρυθμίστε τον origin ώστε να τη μετατρέπει σε κεφαλίδα προσωρινής μνήμης και αφήστε το CDN να ακολουθεί τον origin. Με nginx μπροστά από το PHP-FPM:
map $upstream_http_x_blockstudio_static_prerender $edge_cache_control {
"~^HIT" "public, s-maxage=604800";
default "";
}
server {
listen 80;
server_name example.com;
root /var/www/html;
index index.php;
location / {
try_files $uri $uri/ /index.php?$args;
}
location ~ \.php$ {
include fastcgi_params;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
fastcgi_pass unix:/run/php/php-fpm.sock;
add_header Cache-Control $edge_cache_control;
}
}
Η κανονική έκφραση αντιστοιχίζει τόσο το HIT όσο και το HIT-EARLY. Για κάθε άλλη απόκριση, η μεταβλητή είναι κενή και το nginx δεν προσθέτει κεφαλίδα με κενή τιμή. Έτσι, τα αιτήματα χωρίς αποθηκευμένο έγγραφο, οι δυναμικές διαδρομές και οι αποδόσεις για συνδεδεμένους χρήστες δεν αποκτούν κοινό χρόνο ζωής προσωρινής μνήμης στον origin.
Από την πλευρά του CDN:
- Να αποθηκεύετε στο HTML μόνο όταν ο origin στέλνει διάρκεια προσωρινής αποθήκευσης. Απενεργοποιήστε κάθε προεπιλεγμένο TTL στο edge για αποκρίσεις χωρίς διάρκεια.
- Να παρακάμπτετε το edge για τα ίδια cookies που το Blockstudio αντιμετωπίζει ως εξατομικευμένα (
wordpress_logged_in_,wp-postpass_,comment_author_email_), καθώς και για ταdynamicPaths,wp-adminκαιwp-jsonσας. - Να εκκαθαρίζετε το CDN μετά από κάθε ανάπτυξη που αλλάζει σελίδες, πρότυπα ή στοιχεία. Η προσωρινή μνήμη του origin ανανεώνεται αυτόματα· το edge δεν γνωρίζει ότι πρέπει να την ανανεώσει.
Αν χρησιμοποιείτε το Tailwind με το "output": "link", το φύλλο στυλ URL έχει hash περιεχομένου, επομένως αυτή η διαδρομή μπορεί να εξυπηρετείται με κεφαλίδα προσωρινής μνήμης μακράς διάρκειας και αμετάβλητου περιεχομένου.
Εντολές συντήρησης
wp bs prerender warm
wp bs prerender status
wp bs prerender purge
wp bs teardown
Το warm προσθέτει παλιές δημόσιες διευθύνσεις URL στην ουρά και αποδίδει έως warm.concurrency ανά εκτέλεση, εκτυπώνοντας μια σύνοψη JSON. Το purge αφαιρεί τα αποθηκευμένα έγγραφα και την ουρά του τρέχοντος ιστότοπου. Το teardown αφαιρεί τα συμβάντα cron και την κατάσταση πρώιμης εξυπηρέτησης που ανήκει σε αυτήν την εγκατάσταση, χωρίς να τροποποιεί τα αρχεία ρυθμίσεων.
Ακολουθήστε αυτήν τη σειρά για τη διάθεση: πρώτα το προφίλ, έπειτα η προαπόδοση με απενεργοποιημένο το earlyServe και, τέλος, η πρώιμη εξυπηρέτηση αφού επιβεβαιώσετε ότι το status και οι κεφαλίδες είναι σωστά. Κάθε επίπεδο μπορεί να επανέλθει ανεξάρτητα, επαναφέροντας την τιμή του.
Επόμενα βήματα
- Αναφορά Στατικής προαπόδοσης: δημιουργία γράφου, ενεργοποίηση τεχνουργήματος, διατήρηση και hooks παρατηρησιμότητας.
- Απόδοση: τι αλλάζει το προφίλ
speedκαι πώς να το μετρήσετε. - Προσωρινή αποθήκευση: ο κατάλογος προσωρινής αποθήκευσης όπου βρίσκονται όλα τα αποθηκευμένα έγγραφα.
- Εξατομικευμένα αποσπάσματα σε σελίδες με προσωρινή αποθήκευση: περιεχόμενο ανά επισκέπτη σε στατικές διαδρομές.
- Ανάπτυξη ιστότοπου Blockstudio: πού εντάσσονται ο συγχρονισμός, η εκκαθάριση και η προθέρμανση σε μια έκδοση.