Μπλοκ πλήρους στοίβας
Βάση δεδομένων, συναρτήσεις διακομιστή, cron και CLI σε έναν φάκελο.
db.php
Ορίστε το σχήμα, λάβετε τελικά σημεία CRUD
<?php
return [
'storage' => 'sqlite',
'userScoped' => true,
'capability' => [
'create' => true,
'read' => true,
'update' => true,
'delete' => true,
],
'fields' => [
'text' => ['type' => 'string', 'required' => true],
'done' => ['type' => 'boolean', 'default' => false],
],
];rpc.php
Προσαρμοσμένες λειτουργίες διακομιστή
<?php
use Blockstudio\Db;
return [
'toggle' => function (array $params): array {
$db = Db::get('my-theme/todo');
$id = (int) ($params['id'] ?? 0);
$todo = $db->get_record($id);
if ($todo) {
$db->update($id, ['done' => !$todo['done']]);
}
return ['success' => (bool) $todo];
},
'clear_done' => function (): array {
$db = Db::get('my-theme/todo');
foreach ($db->list(['done' => true], 500) as $todo) {
$db->delete((int) $todo['id']);
}
return ['cleared' => true];
},
];Κάθε δυνατότητα είναι ένα αρχείο
Κάθε αρχείο προσθέτει μία δυνατότητα. Χωρίς ρυθμίσεις και κώδικα καταχώρισης.
Μπλοκ εφαρμογής
blockstudio/
└── my-app/
├── block.json Ορισμός μπλοκ
├── index.php Πρότυπο + Interactivity API
├── style.css Στοχευμένα στυλ
├── script-inline.js Λογική πελάτη
├── db.php Μοντέλο δεδομένων + CRUD
├── rpc.php Λειτουργίες διακομιστή
├── cron.php Προγραμματισμένες εργασίες
└── db/default.sqlite
Βάση δεδομένων
Ορίστε σχήματα, λάβετε τελικά σημεία CRUD.
6 λειτουργίες αποθήκευσης
table, sqlite, jsonc, storh, meta, post_type. Επιλέξτε ανάλογα με τη φορητότητα και τις ανάγκες ερωτημάτων.
αρχεία Storh
Ένα αρχείο ανά εγγραφή στον φάκελο uploads, με ευρετήρια που δημιουργούνται από το σχήμα και ασφαλέστερες ταυτόχρονες εγγραφές. Η εντολή wp bs db migrate –to=storh μεταφέρει τις εγγραφές JSONC και διατηρεί τα αναγνωριστικά τους.
Πίνακες και τύποι αναρτήσεων
Η αποθήκευση σε table διαχειρίζεται έναν πίνακα MySQL με το dbDelta και προσθέτει στήλες για νέα πεδία. Η αποθήκευση σε post_type δημιουργεί μια ανάρτηση για κάθε εγγραφή, ώστε τα WP_Query, τα πρόσθετα REST API και τα εργαλεία GraphQL να μπορούν να τη διαβάσουν.
Πολλαπλά σχήματα
Επιστρέψτε ονομασμένα σχήματα από ένα db.php. Καθένα έχει τη δική του αποθήκευση, τα δικά του endpoints και τον δικό του έλεγχο πρόσβασης.
Δεδομένα ανά χρήστη
Ορίστε το userScoped για αυτόματο διαχωρισμό των εγγραφών, χωρίς χειροκίνητο φιλτράρισμα.
Επικύρωση και hooks
Τύποι, υποχρεωτικές τιμές, απαριθμήσεις, μορφές, μήκη, συναρτήσεις επανάκλησης και hooks κύκλου ζωής.
RPC
Συναρτήσεις διακομιστή που καλούνται από το frontend.
Πελάτης bs.fn()
Καλέστε συναρτήσεις από το JavaScript· τα ενσωματωμένα σκριπτ εντοπίζουν αυτόματα το όνομα του μπλοκ.
Έλεγχος πρόσβασης
Δημόσια με CSRF, ανοιχτή για webhooks ή βάσει δικαιωμάτων, ανά συνάρτηση.
Κλήσεις μεταξύ μπλοκ
Καλέστε οποιαδήποτε συνάρτηση μπλοκ από το JavaScript ή το PHP και συνθέστε λογική.
Επίπεδο δεδομένων πελάτη
Διαβάστε, αποθηκεύστε προσωρινά και γράψτε εγγραφές από τον browser.
client του bs.db()
Δημιουργήστε, καταγράψτε, ανακτήστε, ενημερώστε και διαγράψτε εγγραφές από το JavaScript. Η list δέχεται φίλτρα πεδίων, όριο και μετατόπιση.
bs.query()
Ανακτήσεις με προσωρινή αποθήκευση ανά κλειδί. Οι κλήσεις που εκτελούνται ταυτόχρονα μοιράζονται την ίδια promise, ενώ το staleTime παραλείπει το αίτημα όσο τα δεδομένα είναι ενημερωμένα.
bs.mutate()
Αισιόδοξη δημιουργία, ενημέρωση και διαγραφή σε έναν αντιδραστικό πίνακα κατάστασης, με επαναφορά σε στιγμιότυπο αν αποτύχει το αίτημα.
bs.cache
Η προσωρινή μνήμη στη μνήμη πίσω από τα bs.query() και bs.mutate(). Διαβάστε, ορίστε, ακυρώστε ή διαγράψτε απευθείας τις καταχωρίσεις.
Περιοδικός έλεγχος σε πραγματικό χρόνο
Ορίστε το realtime στο db.php και ο πελάτης συγκρίνει ένα hash δεδομένων ανά τακτά διαστήματα, έπειτα ενημερώνει το store του Interactivity API. Ο περιοδικός έλεγχος σταματά σε κρυφές καρτέλες.
Σελίδες με προσωρινή αποθήκευση
Τα bs.fn() και bs.db() ανακτούν νέα διαπιστευτήρια από ένα endpoint χωρίς προσωρινή αποθήκευση κατά την πρώτη κλήση, ώστε οι δημόσιες κλήσεις να συνεχίζουν να λειτουργούν σε σελίδες που παρέχονται από μακρόβιες προσωρινές μνήμες.
Φόρμες και οθόνες εφαρμογών
Φόρμες που αποδίδονται από το σχήμα και ενσωματωμένα UI για να βασιστείτε σε αυτά.
Φόρμες σχήματος
Δώστε σε ένα πεδίο ένα κλειδί component και το bs_db_form() αποδίδει τη φόρμα μέσω αυτών των μπλοκ, περνώντας σε καθένα τον ορισμό του πεδίου.
Ομαδοποιημένη φόρμα
Με το ui.enabled, το bsui/form block=”…” στέλνει τα πεδία του στο endpoint δημιουργίας αυτού του μπλοκ, εμφανίζει κάθε σφάλμα επικύρωσης κάτω από το αντίστοιχο πεδίο και εκπέμπει τα formsuccess ή formerror.
Παραδείγματα εφαρμογών
Η ρύθμιση ui καταχωρίζει επίσης τα παραδείγματα app/*, όπως τα app/kitchen-sink και app/chat, που έχουν δημιουργηθεί από τα ίδια στοιχεία bsui.
Υποδομή
Cron, CLI, κώδικας αρχικοποίησης και φορητότητα.
Προγραμματισμένες εργασίες
Οι εργασίες cron.php καταχωρίζονται στο WP-Cron. Οι απεγκαταστάσεις Composer τις αφαιρούν με wp bs teardown.
CLI βάσης δεδομένων
Η εντολή wp bs db καταγράφει εγγραφές με φίλτρα πεδίων, τις ανακτά, τις δημιουργεί, τις ενημερώνει και τις διαγράφει, και εμφανίζει πίνακες, JSON ή CSV.
Δοκιμές από το τερματικό
Η εντολή wp bs rpc call εκτελεί μια συνάρτηση με παραμέτρους –key=value, ενώ η wp bs cron run εκτελεί αμέσως μια εργασία, ανεξάρτητα από το πρόγραμμά της.
Αρχεία αρχικοποίησης
Τα init.php και τα υπόλοιπα αρχεία init*.php σε έναν φάκελο μπλοκ εκτελούνται μία φορά κατά το init, για εργασίες ρύθμισης όπως η καταχώριση ενός τύπου ανάρτησης.
Ορισμοί εγγενείς στο PHP
Τα rpc.php και cron.php μπορούν να επιστρέψουν μια κλάση με μεθόδους #[Rpc] και #[Cron], καθώς και τα enum Access, Method και Schedule. Το db.php μπορεί να χρησιμοποιήσει τα Schema::make() και τους builders Field.
Φορητότητα
Τα SQLite και JSONC συνοδεύουν τον κώδικα: αντιγράψτε έναν φάκελο για να αναπτύξετε την εφαρμογή.
Το επίσημο κιτ επεκτάσεων
Premium πρότυπα ιστοτόπων, οδηγίες συστήματος AI και ιδιωτική κοινότητα Discord. Εφάπαξ αγορά, ενημερώσεις εφ’ όρου ζωής.
- 500+ πρότυπα ιστοτόπων
- Οδηγίες συστήματος AI
- Ενημερώσεις εφ’ όρου ζωής
- Ιδιωτική κοινότητα Discord