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

Αναφορά CLI

Όλες οι λειτουργίες Queuety είναι διαθέσιμες μέσω του WP-CLI, στον χώρο ονομάτων wp queuety από προεπιλογή.

Ορίστε το QUEUETY_CLI_COMMAND πριν από την εκκίνηση του Queuety αν θέλετε να δημοσιεύσετε το ίδιο δέντρο εντολών με διαφορετική ρίζα, όπως το wp themequeue.

Για συστήματα δοκιμών πρακτόρων και άλλες ενσωματώσεις εικονικού bash, χρησιμοποιήστε αυτήν τη σελίδα ως αναφορά για ανθρώπους και τη γέφυρα PHP ως συμβόλαιο για μηχανές:

  • Το Queuety::cli_command_map() εκθέτει τον σειριοποιήσιμο κατάλογο εντολών
  • Το Queuety::resolve_cli_command( $path, $args, $assoc_args ) μετατρέπει την αναλυμένη είσοδο wp queuety ... σε κανονικοποιημένο σχέδιο εκτέλεσης που προτιμά τις άμεσες κλήσιμες λειτουργίες PHP

Οι μηχανές καταστάσεων δεν έχουν εντολές σε αυτό το δέντρο· εξετάστε τις μέσω του PHP API που περιγράφεται στις Μηχανές καταστάσεων.

Εντολές εργασιών

wp queuety work

Εκκινεί έναν worker που επεξεργάζεται εργασίες.

Κέλυφος
wp queuety work [--queue=<queue>] [--once] [--workers=<n>]
wp queuety work [--queue=<queue>] [--min-workers=<n>] --max-workers=<n>
Επιλογή Περιγραφή
--queue=<queue> Queue(s) προς επεξεργασία, χωρισμένες με κόμμα για σειρά προτεραιότητας (προεπιλογή: default)
--once Επεξεργάζεται το πολύ μία εργασία και τερματίζει (τερματίζει επίσης αμέσως όταν δεν υπάρχει διαθέσιμη εργασία προς ανάληψη)
--workers=<n> Δημιουργεί N διεργασίες worker (απαιτεί τις επεκτάσεις pcntl και posix, όπως και τα --min-workers και --max-workers)
--min-workers=<n> Ελάχιστος αριθμός worker για προσαρμοστική ομάδα. Απαιτεί το --max-workers
--max-workers=<n> Μέγιστος αριθμός worker για προσαρμοστική ομάδα
Κέλυφος
# Single worker on default queue
wp queuety work

# Process a specific queue
wp queuety work --queue=emails

# Process multiple queues in priority order
wp queuety work --queue=critical,default,low

# One-shot mode
wp queuety work --once

# Multi-worker mode
wp queuety work --workers=4

# Adaptive worker pool
wp queuety work --queue=providers --min-workers=2 --max-workers=6

Όταν καθορίζονται πολλές ουρές, ο worker προσπαθεί να αναλάβει εργασία από καθεμία με τη σειρά που παρατίθεται. Επιλέγεται η πρώτη ουρά με διαθέσιμη εργασία. Το --workers διατηρεί σταθερή την ομάδα. Τα --min-workers και --max-workers ενεργοποιούν την προσαρμοστική κλιμάκωση για το ίδιο σύνολο εντολών. Δείτε τους Worker για στρατηγικές ανάπτυξης και τη Διαχείριση πόρων για το μοντέλο εισαγωγής εργασιών που διέπει τις προσαρμοστικές ομάδες.

wp queuety flush

Επεξεργάζεται όλες τις εκκρεμείς εργασίες και τερματίζει.

Κέλυφος
wp queuety flush [--queue=<queue>]
Επιλογή Περιγραφή
--queue=<queue> Queue(s) προς εκκαθάριση, χωρισμένες με κόμμα για σειρά προτεραιότητας (προεπιλογή: default)
Κέλυφος
# Flush a single queue
wp queuety flush --queue=emails

# Flush multiple queues in priority order
wp queuety flush --queue=critical,default,low

wp queuety dispatch

Αποστέλλει μια εργασία από τη γραμμή εντολών.

Κέλυφος
wp queuety dispatch <handler> [--payload=<json>] [--queue=<queue>] [--priority=<priority>] [--delay=<seconds>]
Επιλογή Περιγραφή
<handler> Όνομα χειριστή ή κλάση (απαιτείται)
--payload=<json> Ωφέλιμο φορτίο JSON (προεπιλογή: {})
--queue=<queue> Όνομα ουράς (προεπιλογή: default)
--priority=<priority> Επίπεδο προτεραιότητας 0-3 (προεπιλογή: 0)
--delay=<seconds> Καθυστέρηση σε δευτερόλεπτα (προεπιλογή: 0)
Κέλυφος
wp queuety dispatch send_email --payload='{"to":"user@example.com"}' --queue=emails

wp queuety status

Εμφανίζει στατιστικά ουρών.

Κέλυφος
wp queuety status [--queue=<queue>]
Επιλογή Περιγραφή
--queue=<queue> Φιλτράρισμα κατά όνομα ουράς

wp queuety list

Παραθέτει τις εργασίες.

Κέλυφος
wp queuety list [--queue=<queue>] [--status=<status>] [--format=<format>]
Επιλογή Περιγραφή
--queue=<queue> Φιλτράρισμα κατά ουρά
--status=<status> Φιλτράρισμα κατά κατάσταση (pending, processing, completed, failed, buried)
--format=<format> Μορφή εξόδου: table (προεπιλογή), json, csv, yaml

wp queuety inspect

Εμφανίζει πλήρεις λεπτομέρειες μιας εργασίας, συμπεριλαμβανομένου του ωφέλιμου φορτίου και του ιστορικού καταγραφής.

Κέλυφος
wp queuety inspect <id>
Επιλογή Περιγραφή
<id> Αναγνωριστικό εργασίας (απαιτείται)

wp queuety retry

Επαναλαμβάνει μια συγκεκριμένη εργασία.

Κέλυφος
wp queuety retry <id>
Επιλογή Περιγραφή
<id> Αναγνωριστικό εργασίας για επανάληψη (απαιτείται)

wp queuety retry-buried

Επαναλαμβάνει όλες τις εργασίες που βρίσκονται σε αναμονή.

Κέλυφος
wp queuety retry-buried

wp queuety bury

Θέτει χειροκίνητα μια εργασία σε αναμονή.

Κέλυφος
wp queuety bury <id>
Επιλογή Περιγραφή
<id> Αναγνωριστικό εργασίας προς θέση σε αναμονή (απαιτείται)

wp queuety delete

Διαγράφει μια εργασία.

Κέλυφος
wp queuety delete <id>
Επιλογή Περιγραφή
<id> Αναγνωριστικό εργασίας προς διαγραφή (απαιτείται)

wp queuety recover

Ανακτά παλιές εργασίες που έχουν κολλήσει στην κατάσταση processing.

Κέλυφος
wp queuety recover

wp queuety purge

Εκκαθαρίζει τις ολοκληρωμένες εργασίες.

Κέλυφος
wp queuety purge [--older-than=<days>]
Επιλογή Περιγραφή
--older-than=<days> Διαγράφει εργασίες παλαιότερες από N ημέρες (προεπιλογή: QUEUETY_RETENTION_DAYS)

wp queuety pause

Παύει μια ουρά ώστε να την παραλείπουν οι workers.

Κέλυφος
wp queuety pause <queue>
Επιλογή Περιγραφή
<queue> Όνομα ουράς για παύση (απαιτείται)

wp queuety resume

Συνεχίζει μια ουρά που βρίσκεται σε παύση.

Κέλυφος
wp queuety resume <queue>
Επιλογή Περιγραφή
<queue> Όνομα ουράς για συνέχιση (απαιτείται)

wp queuety metrics

Εμφανίζει μετρήσεις ανά χειριστή.

Κέλυφος
wp queuety metrics [--minutes=<minutes>] [--format=<format>]
Επιλογή Περιγραφή
--minutes=<minutes> Χρονικό διάστημα σε λεπτά (προεπιλογή: 60)
--format=<format> Μορφή εξόδου: table (προεπιλογή), json, csv, yaml

wp queuety discover

Ανακαλύπτει κλάσεις χειριστών σε έναν κατάλογο.

Κέλυφος
wp queuety discover <directory> <namespace> [--register]
Επιλογή Περιγραφή
<directory> Κατάλογος προς σάρωση για κλάσεις χειριστών (απαιτείται)
<namespace> Πρόθεμα χώρου ονομάτων PSR-4 για τον κατάλογο (απαιτείται)
--register Καταχωρίζει πράγματι τους χειριστές που ανακαλύφθηκαν

Εντολές ροών εργασιών

wp queuety workflow status

Εμφανίζει την κατάσταση και την πρόοδο της ροής εργασιών.

Κέλυφος
wp queuety workflow status <id>
Επιλογή Περιγραφή
<id> Αναγνωριστικό ροής εργασιών (απαιτείται)

Το status εμφανίζει το τρέχον βήμα, το προαιρετικό όνομα βήματος, τα μεταδεδομένα έκδοσης/hash, τη λειτουργία αναμονής, τη σύνοψη τεχνουργημάτων και ένα blob WaitInfo JSON όταν η ροή εργασιών έχει αποκλειστεί λόγω σημάτων ή εξαρτήσεων.

wp queuety workflow list

Παραθέτει τις ροές εργασιών.

Κέλυφος
wp queuety workflow list [--status=<status>] [--format=<format>]
Επιλογή Περιγραφή
--status=<status> Φιλτράρισμα κατά κατάσταση: running, completed, failed, paused, waiting_for_signal, waiting_for_workflows, cancelled
--format=<format> Μορφή εξόδου: table (προεπιλογή), json, csv, yaml

Η εντολή επιστρέφει το πολύ 50 ροές εργασιών. Διαβάζει μια τιμή --limit, αλλά το WP-CLI απορρίπτει προς το παρόν τη σημαία, επειδή η εντολή δεν την έχει δηλώσει (#12)· χρησιμοποιήστε το Queuety::list_workflows() για διαφορετικό όριο.

Ο προεπιλεγμένος πίνακας περιλαμβάνει τα StepName και WaitMode, ώστε να εντοπίζονται ευκολότερα οι αποκλεισμένες ροές εργασιών.

wp queuety workflow retry

Επανεκκινήστε μια αποτυχημένη ροή εργασίας από το βήμα στο οποίο απέτυχε.

Κέλυφος
wp queuety workflow retry <id>
Επιλογή Περιγραφή
<id> Αναγνωριστικό ροής εργασιών (απαιτείται)

wp queuety workflow approve

Στέλνει σήμα έγκρισης σε μια ροή εργασιών.

Κέλυφος
wp queuety workflow approve <id> [--data=<json>] [--signal=<name>]
Επιλογή Περιγραφή
<id> Αναγνωριστικό ροής εργασιών (απαιτείται)
--data=<json> Προαιρετικό ωφέλιμο φορτίο αντικειμένου JSON
--signal=<name> Παρακάμπτει το όνομα σήματος έγκρισης (προεπιλογή: approval, που αντιστοιχεί στο wait_for_approval()· ένα βήμα wait_for_decision() ακούει από προεπιλογή το approved, επομένως περάστε εκεί το --signal=approved)

wp queuety workflow reject

Στέλνει σήμα απόρριψης σε μια ροή εργασιών.

Κέλυφος
wp queuety workflow reject <id> [--data=<json>] [--signal=<name>]
Επιλογή Περιγραφή
<id> Αναγνωριστικό ροής εργασιών (απαιτείται)
--data=<json> Προαιρετικό ωφέλιμο φορτίο αντικειμένου JSON
--signal=<name> Παρακάμπτει το όνομα σήματος απόρριψης (προεπιλογή: rejected)

wp queuety workflow input

Στέλνει δομημένη είσοδο σε μια ροή εργασιών.

Κέλυφος
wp queuety workflow input <id> [--data=<json>] [--signal=<name>]
Επιλογή Περιγραφή
<id> Αναγνωριστικό ροής εργασιών (απαιτείται)
--data=<json> Προαιρετικό ωφέλιμο φορτίο αντικειμένου JSON
--signal=<name> Παρακάμπτει το όνομα σήματος εισόδου (προεπιλογή: input)

wp queuety workflow artifacts

Παραθέτει τα αποθηκευμένα τεχνουργήματα μιας ροής εργασιών.

Κέλυφος
wp queuety workflow artifacts <id> [--format=<format>] [--with-content]
Επιλογή Περιγραφή
<id> Αναγνωριστικό ροής εργασιών (απαιτείται)
--format=<format> Μορφή εξόδου: table (προεπιλογή) ή json
--with-content Συμπεριλαμβάνει το περιεχόμενο των τεχνουργημάτων στην έξοδο

wp queuety workflow artifact

Εμφανίζει ένα αποθηκευμένο τεχνούργημα μιας ροής εργασιών.

Κέλυφος
wp queuety workflow artifact <id> <key>
Επιλογή Περιγραφή
<id> Αναγνωριστικό ροής εργασιών (απαιτείται)
<key> Κλειδί τεχνουργήματος (απαιτείται)

wp queuety workflow pause

Θέτει σε παύση μια εκτελούμενη ροή εργασιών.

Κέλυφος
wp queuety workflow pause <id>
Επιλογή Περιγραφή
<id> Αναγνωριστικό ροής εργασιών (απαιτείται)

wp queuety workflow resume

Συνεχίστε μια ροή εργασίας που βρίσκεται σε παύση.

Κέλυφος
wp queuety workflow resume <id>
Επιλογή Περιγραφή
<id> Αναγνωριστικό ροής εργασιών (απαιτείται)

wp queuety workflow cancel

Ακυρώνει μια ροή εργασιών που δεν βρίσκεται ήδη σε κατάσταση completed ή cancelled. Σε μία συναλλαγή, το Queuety ορίζει την κατάσταση σε cancelled, θέτει σε αναμονή τις εκκρεμείς και υπό επεξεργασία εργασίες της ροής και καταγράφει το workflow_cancelled· έπειτα εκτελεί τις αντισταθμίσεις και κάθε καταχωρισμένο χειριστή καθαρισμού.

Κέλυφος
wp queuety workflow cancel <id>
Επιλογή Περιγραφή
<id> Αναγνωριστικό ροής εργασιών προς ακύρωση (απαιτείται)
Κέλυφος
wp queuety workflow cancel 42

wp queuety workflow timeline

Εμφανίζει το χρονολόγιο συμβάντων μιας ροής εργασιών. Παρουσιάζει όλα τα συμβάντα βημάτων (έναρξη, ολοκλήρωση, αποτυχία) με χρονικές σημάνσεις, χειριστές και διάρκειες.

Κέλυφος
wp queuety workflow timeline <id> [--limit=<limit>] [--offset=<offset>] [--format=<format>]
Επιλογή Περιγραφή
<id> Αναγνωριστικό ροής εργασιών (απαιτείται)
--limit=<limit> Μέγιστος αριθμός συμβάντων προς επιστροφή (προεπιλογή: 100)
--offset=<offset> Αριθμός προηγούμενων συμβάντων προς παράλειψη (προεπιλογή: 0)
--format=<format> Μορφή εξόδου: table (προεπιλογή), json, csv, yaml
Κέλυφος
wp queuety workflow timeline 42

Στήλες εξόδου: ID, Step, Event, Handler, Duration_ms, Error, Created_at.

wp queuety workflow state-at

Εμφανίζει τη δημόσια κατάσταση της ροής εργασιών μετά την ολοκλήρωση ή την επανεκκίνηση συγκεκριμένου βήματος.

Κέλυφος
wp queuety workflow state-at <id> <step>
Επιλογή Περιγραφή
<id> Αναγνωριστικό ροής εργασιών (απαιτείται)
<step> Δείκτης βήματος, με αρίθμηση από το 0 (απαιτείται)
Κέλυφος
wp queuety workflow state-at 42 0

Δείτε το Αρχείο καταγραφής συμβάντων ροής εργασιών για λεπτομέρειες σχετικά με όσα καταγράφονται και τις περιπτώσεις χρήσης.

wp queuety workflow rewind

Επαναφέρει μια ροή εργασιών σε προηγούμενο βήμα και συνεχίζει από το επόμενο. Η κατάσταση αποκαθίσταται από το αρχείο καταγραφής συμβάντων state_after για το συγκεκριμένο βήμα και το επόμενο βήμα (<step> + 1) μπαίνει στην ουρά· το συγκεκριμένο βήμα δεν εκτελείται ξανά.

Κέλυφος
wp queuety workflow rewind <id> <step>
Επιλογή Περιγραφή
<id> Αναγνωριστικό ροής εργασιών (απαιτείται)
<step> Δείκτης βήματος στο οποίο θα γίνει επαναφορά, με αρίθμηση από το 0 (απαιτείται)
Κέλυφος
wp queuety workflow rewind 42 1

Δείτε το Ταξίδι στον χρόνο για λεπτομέρειες.

wp queuety workflow fork

Διακλαδώνει μια εκτελούμενη ροή εργασιών σε ανεξάρτητο αντίγραφο της τρέχουσας κατάστασής της. Η διακλαδισμένη ροή εργασιών αποκτά νέο αναγνωριστικό και συνεχίζεται ανεξάρτητα.

Κέλυφος
wp queuety workflow fork <id>
Επιλογή Περιγραφή
<id> Αναγνωριστικό ροής εργασιών προς διακλάδωση (απαιτείται)
Κέλυφος
wp queuety workflow fork 42
# Success: Workflow #42 forked. New workflow ID: 43.

Δείτε τη Διακλάδωση για λεπτομέρειες.

wp queuety workflow export

Εξάγει όλο το ιστορικό εκτέλεσης μιας ροής εργασιών στο JSON. Περιλαμβάνει την εγγραφή της ροής εργασιών, τις εργασίες, τα συμβάντα ροής εργασιών, τις καταχωρίσεις αρχείου καταγραφής, τα αποθηκευμένα σήματα και τις αναμονές εξαρτήσεων της ροής εργασιών.

Κέλυφος
wp queuety workflow export <id> [--output=<file>]
Επιλογή Περιγραφή
<id> Αναγνωριστικό ροής εργασίας (απαιτείται)
--output=<file> Διαδρομή αρχείου στην οποία θα γραφτεί το JSON. Από προεπιλογή, η έξοδος εμφανίζεται στην τυπική έξοδο.
Κέλυφος
# Print to stdout
wp queuety workflow export 42

# Write to a file
wp queuety workflow export 42 --output=/tmp/workflow-42.json

Δείτε την Εξαγωγή και αναπαραγωγή για λεπτομέρειες σχετικά με τη δομή JSON.

wp queuety workflow replay

Αναπαράγει μια εξαγόμενη ροή εργασιών από αρχείο JSON. Δημιουργεί μια νέα ροή εργασιών με την εξαγμένη κατάσταση, τα μεταδεδομένα και το ιστορικό χρονολόγιο.

Κέλυφος
wp queuety workflow replay <file>
Επιλογή Περιγραφή
<file> Διαδρομή προς το εξαγμένο αρχείο JSON (απαιτείται)
Κέλυφος
wp queuety workflow replay /tmp/workflow-42.json
# Success: Workflow replayed. New workflow ID: 85.

Δείτε την ενότητα Εξαγωγή και επανάληψη για λεπτομέρειες.

Εντολές προγραμματισμού

wp queuety schedule list

Παραθέτει όλα τα επαναλαμβανόμενα προγράμματα.

Κέλυφος
wp queuety schedule list [--format=<format>]
Επιλογή Περιγραφή
--format=<format> Μορφή εξόδου: table (προεπιλογή), json, csv, yaml

wp queuety schedule add

Προσθέτει ένα επαναλαμβανόμενο πρόγραμμα.

Κέλυφος
wp queuety schedule add <handler> [--every=<interval>] [--cron=<expression>] [--payload=<json>] [--queue=<queue>]
Επιλογή Περιγραφή
<handler> Όνομα χειριστή ή κλάση (απαιτείται)
--every=<interval> Έκφραση διαστήματος (e.g. 1 hour, 30 minutes)
--cron=<expression> Έκφραση Cron (e.g. 0 3 * * *)
--payload=<json> Ωφέλιμο φορτίο JSON (προεπιλογή: {})
--queue=<queue> Όνομα ουράς (προεπιλογή: default)

Πρέπει να καθορίσετε είτε το --every είτε το --cron.

Κέλυφος
wp queuety schedule add cleanup_handler --every="1 hour"
wp queuety schedule add nightly_report --cron="0 3 * * *" --queue=reports

wp queuety schedule remove

Αφαιρεί ένα πρόγραμμα βάσει ονόματος χειριστή.

Κέλυφος
wp queuety schedule remove <handler>
Επιλογή Περιγραφή
<handler> Όνομα χειριστή προς αφαίρεση (απαιτείται)

wp queuety schedule run

Ενεργοποιεί χειροκίνητα έναν κύκλο του προγραμματιστή. Βάζει στην ουρά εργασίες για όλα τα προγράμματα που είναι έτοιμα να εκτελεστούν.

Κέλυφος
wp queuety schedule run

Εντολές αρχείου καταγραφής

wp queuety log

Υποβάλλει ερώτημα για καταχωρίσεις αρχείου καταγραφής.

Κέλυφος
wp queuety log [--job=<id>] [--workflow=<id>] [--handler=<name>] [--event=<event>] [--since=<datetime>] [--limit=<n>] [--format=<format>]
Επιλογή Περιγραφή
--job=<id> Φιλτράρισμα κατά αναγνωριστικό εργασίας
--workflow=<id> Φιλτράρισμα κατά αναγνωριστικό ροής εργασιών
--handler=<name> Φιλτράρισμα κατά όνομα χειριστή
--event=<event> Φιλτράρισμα κατά τύπο συμβάντος (started, completed, failed, buried, retried, workflow_started, workflow_completed, workflow_failed, workflow_paused, workflow_resumed, workflow_cancelled, workflow_rewound, workflow_forked, workflow_deadline_exceeded, debug)
--since=<datetime> Εμφάνιση εγγραφών από αυτήν την ημερομηνία και ώρα
--limit=<n> Μέγιστος αριθμός εγγραφών προς εμφάνιση (προεπιλογή: 50)
--format=<format> Μορφή εξόδου: table (προεπιλογή), json, csv, yaml

Τα φίλτρα δεν συνδυάζονται: το Queuety εφαρμόζει το πρώτο που υπάρχει, με τη σειρά --job, --workflow, --handler, --event, --since. Τα --job και --workflow επιστρέφουν όλες τις εγγραφές, από την παλαιότερη προς τη νεότερη, και αγνοούν το --limit. Τα --handler και --event επιστρέφουν πρώτα τις νεότερες εγγραφές. Χωρίς φίλτρο, η εντολή διαβάζει τις τελευταίες 24 ώρες· αυτό το ερώτημα και το --since εμφανίζουν τις εγγραφές από την παλαιότερη προς τη νεότερη, οπότε το --limit διατηρεί τις παλαιότερες εγγραφές του χρονικού διαστήματος.

Κέλυφος
# Logs from the last 24 hours (oldest first)
wp queuety log

# Logs for a job
wp queuety log --job=42

# Failed events
wp queuety log --event=failed --limit=100

# Logs since a specific time
wp queuety log --since="2025-03-01 00:00:00"

Εκκαθάριση αρχείων καταγραφής

Το LogCommand ορίζει μια υποεντολή purge (wp queuety log purge --older-than=<days>), αλλά το WP-CLI καταχωρίζει το wp queuety log ως ενιαία εντολή, επομένως δεν είναι δυνατή η κλήση της υποεντολής και η εντολή αποτυγχάνει με το μήνυμα "Too many positional arguments: purge" (#11). Εκκαθαρίστε τις παλιές εγγραφές καταγραφής από το PHP:

Κέλυφος
wp eval 'echo Queuety\Queuety::purge_logs( 30 );'

Εντολές webhook

wp queuety webhook add

Καταχωρίστε ένα webhook URL για ένα συμβάν.

Κέλυφος
wp queuety webhook add <event> <url>
Επιλογή Περιγραφή
<event> Όνομα συμβάντος: job.completed, job.failed, job.buried ή workflow.failed (απαιτείται)
<url> URL για αποστολή ειδοποιήσεων με POST (απαιτείται)
Κέλυφος
wp queuety webhook add job.buried https://hooks.slack.com/services/...

wp queuety webhook list

Εμφάνιση όλων των καταχωρισμένων webhook.

Κέλυφος
wp queuety webhook list [--format=<format>]
Επιλογή Περιγραφή
--format=<format> Μορφή εξόδου: table (προεπιλογή), json, csv, yaml

wp queuety webhook remove

Αφαίρεση webhook με βάση το αναγνωριστικό του.

Κέλυφος
wp queuety webhook remove <id>
Επιλογή Περιγραφή
<id> Αναγνωριστικό webhook προς αφαίρεση (απαιτείται)