PHPackages                             10up/wp-minions - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. 10up/wp-minions

AbandonedArchivedWordpress-plugin

10up/wp-minions
===============

Job Queue for WordPress

4.1.0(7y ago)230191.6k41[5 issues](https://github.com/10up/WP-Minions/issues)[6 PRs](https://github.com/10up/WP-Minions/pulls)GPL-2.0-or-laterPHP

Since Oct 23Pushed 2y ago43 watchersCompare

[ Source](https://github.com/10up/WP-Minions)[ Packagist](https://packagist.org/packages/10up/wp-minions)[ RSS](/packages/10up-wp-minions/feed)WikiDiscussions develop Synced 3d ago

READMEChangelog (2)Dependencies (4)Versions (11)Used By (0)

WP Minions
==========

[](#wp-minions)

> Provides a framework for using job queues with [WordPress](http://wordpress.org/) for asynchronous task running. Provides an integration with [Gearman](http://gearman.org/) and [RabbitMQ](https://www.rabbitmq.com) out of the box.

[![Support Level](https://camo.githubusercontent.com/bda18bd40847957c7c2fd168847c0be1c844a01a7e8938bbadef330bcd0f6790/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f737570706f72742d61726368697665642d7265642e737667)](#support-level) [![Build Status](https://camo.githubusercontent.com/50d7be03c16c4345213156fca3ce494ef8ebe547f2cd71e1c78c01d909ba8a9c/68747470733a2f2f7472617669732d63692e6f72672f313075702f57502d4d696e696f6e732e7376673f6272616e63683d6d6173746572)](https://travis-ci.org/10up/WP-Minions) [![Release Version](https://camo.githubusercontent.com/650a01be1684d5932b35ebdf2d42786b8bb26951a771707d0c815403f0c7f4b5/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f72656c656173652f313075702f57502d4d696e696f6e732e737667)](https://github.com/10up/WP-Minions/releases/latest) [![GPLv2 License](https://camo.githubusercontent.com/bbee99a0dbbef9164fea47a6c8215be797f07d2b111af7c8dbf31be87b796b2f/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f313075702f57502d4d696e696f6e732e737667)](https://github.com/10up/WP-Minions/blob/master/LICENSE.md)

Caution

As of 12 April 2024, this project is archived and no longer being actively maintained.

Background & Purpose
------------------------

[](#background--purpose)

As WordPress becomes a more popular publishing platform for increasingly large publishers, with complex workflows, the need for increasingly complex and resource-intensive tasks has only increased. Things like generating reports, expensive API calls, syncing users to mail providers, or even ingesting content from feeds all take a lot of time or a lot of memory (or both), and commonly can't finish within common limitations of web servers, because things like timeouts and memory limits get in the way.

WP Minions provides a few helper functions that allow you to add tasks to a queue, and specify an action that should be called to trigger the task, just hook a callback into the action using `add_action()`

During configuration, a number of minions (workers) are specified. As minions are free, they will take the next task from the queue, call the action, and any callbacks hooked into the action will be run.

In the situation of needing more ram or higher timeouts, a separate server to process the tasks is ideal - Just set up WordPress on that server like the standard web servers, and up the resources. Make sure not to send any production traffic to the server, and it will exclusively handle tasks from the queue.

Installation
------------

[](#installation)

1. Install the plugin in WordPress. If desired, you can [download a zip](http://github.com/10up/WP-Minions/archive/master.zip) and install via the WordPress plugin installer.
2. Create a symlink at the site root (the same directory as `wp-settings.php`) that points to the `wp-minions-runner.php` file in the plugin (or copy the file, but a symlink will ensure it is updated if the plugin is updated)
3. Define a unique salt in `wp-config.php` so that multiple installs don't conflict.

```
define( 'WP_ASYNC_TASK_SALT', 'my-unique-salt-1' );
```

**Note:** If you are using multisite, you'll also have to add the following to your `wp-config.php` file, *after* the block with the multisite definitions. This is due to the fact that multisite relies on `HTTP_HOST` to detect the site/blog it is running under. You'll also want to make sure you are actually defining `DOMAIN_CURRENT_SITE` in the multisite configuration.

```
if ( ! isset( $_SERVER['HTTP_HOST'] ) && defined( 'DOING_ASYNC' ) && DOING_ASYNC ) {
  $_SERVER['HTTP_HOST'] = DOMAIN_CURRENT_SITE;
}
```

4. Next, you'll need to choose your job queue system. Gearman and RabbitMQ are supported out of the box.

### Gearman

[](#gearman)

There are a few parts to get this all running. First, the Gearman backend needs to be setup - this part will vary depending on your OS. Once that is complete, we can install the WordPress plugin, and set the configuration options for WordPress.

#### Backend Setup - CentOS 6.x

[](#backend-setup---centos-6x)

1. You'll need the [EPEL](https://fedoraproject.org/wiki/EPEL) repo for gearman, and the [REMI](http://rpms.famillecollet.com/) repo for some of the php packages. Make sure to enable the appropriate remi repo for the version of php you are using.
    - `wget http://dl.fedoraproject.org/pub/epel/6/i386/epel-release-6-8.noarch.rpm && rpm -Uvh epel-release-6*.rpm`
    - `wget http://rpms.famillecollet.com/enterprise/remi-release-6.rpm && rpm -Uvh remi-release-6*.rpm`
    - `rm *.rpm`
2. Make sure that remi is enabled, as well as any specific version of php you may want in `/etc/yum.repos.d/remi.repo`
3. `yum install gearmand php-pecl-gearman python-pip`
4. `easy_install supervisor`
5. `chkconfig supervisord on && chkconfig gearmand on`
6. If everything is running on one server, I would recommend limiting connections to localhost only. If not, you'll want to set up firewall rules to only allow certain clients to connect on the Gearman port (Default 4730)

- edit `/etc/sysconfig/gearmand` - set `OPTIONS="--listen=localhost"`

1. `service gearmand start`

#### Backend Setup - CentOS 7.x

[](#backend-setup---centos-7x)

1. You'll need the [EPEL](https://fedoraproject.org/wiki/EPEL) repo for gearman, and the [REMI](http://rpms.famillecollet.com/) repo for some of the php packages.
    - `yum install https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm`
    - `yum install http://rpms.famillecollet.com/enterprise/remi-release-7.rpm`
2. `yum install gearmand php-pecl-gearman --enablerepo=remi-php`. For example, if you are using php 7.2 your command would look like this `yum install gearmand php-pecl-gearman --enablerepo=remi-php72`
3. Optionally, install supervisord if you prefer it
    - `yum install python-pip`
    - `easy_install supervisor`
4. If everything is running on one server, I would recommend limiting connections to localhost only. If not, you'll want to set up firewall rules to only allow certain clients to connect on the Gearman port (Default 4730)
    - edit `/etc/sysconfig/gearmand` - set `OPTIONS="--listen=localhost"`
5. `systemctl enable gearmand`
6. `systemctl start gearmand`

#### Backend Setup - Ubuntu

[](#backend-setup---ubuntu)

As you go through this, you may need to install additional packages, if you do not have them already, such as php-pear or a php\*-dev package

1. `apt-get update`
2. `apt-get install gearman python-pip libgearman-dev supervisor`
3. `pecl install gearman`
4. Once pecl install is complete, it will tell you to place something like `extension=gearman.so` into your php.ini file - Do this.
5. `update-rc.d gearman-job-server defaults && update-rc.d supervisor defaults`
6. If everything is running on one server, I would recommend limiting connections to localhost only. If not, you'll want to set up firewall rules to only allow certain clients to connect on the Gearman port (Default 4730)

- edit `/etc/default/gearman-job-server` - set `PARAMS="--listen=localhost"`

1. `service gearman-job-server restart`

#### Supervisor Configuration

[](#supervisor-configuration)

Filling in values in `` as required, add the following config to either `/etc/supervisord.conf` (CentOS) or `/etc/supervisor/supervisord.conf` (Ubuntu)

```
[program:my_wp_minions_workers]
command=/usr/bin/env php /wp-minions-runner.php
process_name=%(program_name)s-%(process_num)02d
numprocs=
directory=
autostart=true
autorestart=true
killasgroup=true
user=
```

- path\_to\_wordpress: Absolute path to the root of your WordPress install, ex: `/var/www/html/wordpress`
- number\_of\_minions: How many minions should be spawned (How many jobs can be running at once).
- path\_to\_temp\_directory: probably should just be the same as path\_to\_wordpress.
- user: The system user to run the processes under, probably apache (CentOS), nginx (CentOS), or www-data (Ubuntu).
- You can optionally change the "my\_wp\_minions\_workers" text to something more descriptive, if you'd like.

After updating the supervisor configuration, restart the service (CentOS or Ubuntu)

```
systemctl restart supervisord

```

```
service supervisor restart

```

#### Systemd Configuration (CentOS 7.x)

[](#systemd-configuration-centos-7x)

Filling in values in `` as required, add the following to /etc/systemd/system/[wp-minions-runner@.service](mailto:wp-minions-runner@.service)

```
[Unit]
Description=WP-Minions Runner %i
After=network.target

[Service]
PIDFile=/var/run/wp-minions-runner.%i.pid
User=
Type=simple
ExecStart=/usr/bin/env php /wp-minions-runner.php
Restart=always

[Install]
WantedBy=multi-user.target

```

- path\_to\_wordpress: Absolute path to the root of your WordPress install, ex: `/var/www/html/wordpress`
- user: The system user to run the processes under, probably apache (CentOS), nginx (CentOS), or www-data (Ubuntu).

Reload systemd:

`systemctl daemon-reload`

Enable and start as many runners as you'd like to have running:

```
systemctl enable wp-minions-runner@{1..n}
systemctl start wp-minions-runner@{1..n}

```

Where 'n' is the number of processes you want.

#### WordPress Configuration

[](#wordpress-configuration)

Define the `WP_MINIONS_BACKEND` constant in your `wp-config.php`. Valid values are `gearman` or `rabbitmq`. If left blank, it will default to a cron client.

```
define( 'WP_MINIONS_BACKEND', 'gearman' );

```

If your job queue service not running locally or uses a non-standard port, you'll need define your servers in `wp-config.php`

```
# Gearman config
global $gearman_servers;
$gearman_servers = array(
  '127.0.0.1:4730',
);

```

```
# RabbitMQ config
global $rabbitmq_server;
$rabbitmq_server = array(
  'host'     => '127.0.0.1',
  'port'     => 5672,
  'username' => 'guest',
  'password' => 'guest',
);

Note: On RabbitMQ the guest/guest account is the default administrator account, RabbitMQ will only allow connections connections on that account from localhost. Connections to any non-loopback address will be denied. See the RabbitMQ manual on [user management](https://www.rabbitmq.com/rabbitmqctl.8.html#User_Management) and [Access Control](https://www.rabbitmq.com/rabbitmqctl.8.html#Access_Control) for information on adding users and allowing them access to RabbitMQ resources.

## MySQL Persistent Queue (Recommended)

By default, gearman will store the job queue in memory. If for whatever reason the gearman service goes away, so does the queue. For persistence, you can optionally use a MySQL database for the job queue:

#### CentOS

Edit the gearman config at ```/etc/sysconfig/gearmand```, adding the following to the OPTIONS line (or creating the line, if it doesn't exist yet), inserting database credentials as necessary:
```sh
OPTIONS="-q MySQL --mysql-host=localhost --mysql-port=3306 --mysql-user= --mysql-password= --mysql-db=gearman --mysql-table=gearman_queue"

```

#### Ubuntu

[](#ubuntu)

Edit the gearman config at `/etc/default/gearman-job-server`, adding the following to the PARAMS line (or creating the line, if it doesn't exist yet), inserting database credentials as necessary:

```
PARAMS="-q MySQL --mysql-host=localhost --mysql-port=3306 --mysql-user= --mysql-password= --mysql-db=gearman --mysql-table=gearman_queue"
```

Note: For some setups, the above will not work as `/etc/default/gearman-job-server` does not get read. If you don't see the persistent queue setup then:

1. Create a `gearman` db in mysql (the database must be present in the database, but when gearmand is initialized the first time it will create the table).
2. Create a file in `/etc/gearmand.conf`
3. In the file paste the configuration all on one line:

```
-q MySQL --mysql-host=localhost --mysql-port=3306 --mysql-user= --mysql-password= --mysql-db=gearman --mysql-table=gearman_queue
```

Then restart the gearman-job-server: `sudo service gearman-job-server restart`.

Verification
------------

[](#verification)

Once everything is installed, you can quickly make sure your job queue is accepting jobs with the `test-client.php` and `test-worker.php` files located in the `system-tests/YOURQUEUE` directory. The worker is configured to reverse any text passed to it. In the client file, we pass "Hello World" to the worker.

In one window, run `php test-worker.php` - You'll now have one worker process running, waiting for jobs.

In another window, run `php test-client.php "Hello World"` - You should see "dlroW olleH" printed on your screen.

`ctrl-c` will stop the worker once you are done testing.

Usage
-----

[](#usage)

Once configured and activated, you'll have access to `wp_async_task_add()`. If you are at all familiar with `wp_schedule_single_event()`, the way `wp_async_task_add()` works should be very familiar to you.

The function takes up to three arguments, the first of which is required:

1. `$hook`: This is the name of the action hook to execute when the job runs. Your callback function should hook into this with `add_action( $hook, $callback )`
2. `$args`: This is optional, and defaults to an empty array. You can pass an array of arbitrary data to this, and it will be passed to your callback function.
3. `$priority`: This is optional, and defaults to "normal". Other valid options are "high" or "low". High priority jobs will be run before normal priority jobs, even if they normal priority job has been in the queue longer.

Set an option in the database, when a worker becomes available:

```
// Add a task, that will call the "myplugin_update_option" action when it is run
wp_async_task_add( 'myplugin_update_option', array( 'mykey' => 'myvalue' ) );

function myplugin_update_option_callback( $args ) {
	// In reality, you are probably doing a lot of resource intensive work here
	update_option( 'my-option-name', $args['mykey'] );
}

// Add the action that links the task and the callback.
// Notice the hook below is the same as the hook provided to wp_async_task_add.
add_action( 'myplugin_update_option', 'myplugin_update_option_callback' );
```

Once a worker is free, and runs the above task, you'd have an option called "my-option-name" in the options table, with a value of "myvalue", since "myvalue" was passed in via the `$args`

Customization
-------------

[](#customization)

The following constants can be used to customize the behaviour of WP Minions.

1. `WP_MINIONS_JOBS_PER_WORKER` - The number of jobs to execute per Worker, default is 1. Running multiple jobs per worker will reduce the number workers spawned, and can significantly boost performance. However too large a value will cause issues if you have memory leaks. Use with caution.
2. `WP_MINIONS_CLIENT_CLASS` - You can also alter the Client class used to send jobs to your job queue. It should match the interface of `\WpMinions\Client`.
3. `WP_MINIONS_WORKER_CLASS` - Similarly you can alter the Worker class used to execute jobs. It should match the interface of `\WpMinions\Worker`.

Issues
------

[](#issues)

If you identify any errors or have an idea for improving the plugin, please [open an issue](https://github.com/10up/WP-Minions/issues). We're excited to see what the community thinks of this project, and we would love your input!

Support Level
-------------

[](#support-level)

**Archived:** This project is no longer maintained by 10up. We are no longer responding to Issues or Pull Requests unless they relate to security concerns. We encourage interested developers to fork this project and make it their own!

Like what you see?
------------------

[](#like-what-you-see)

[![](https://camo.githubusercontent.com/5ec5223fa6fe20a5ca00d8d768bd7ee91e93f67c9d7a06e575c87e3ed1d00263/68747470733a2f2f313075702e636f6d2f75706c6f6164732f323031362f31302f313075702d4769746875622d42616e6e65722e706e67)](http://10up.com/contact/)

###  Health Score

44

—

FairBetter than 92% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity46

Moderate usage in the ecosystem

Community29

Small or concentrated contributor base

Maturity69

Established project with proven stability

 Bus Factor1

Top contributor holds 51.6% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~184 days

Recently: every ~226 days

Total

7

Last Release

2747d ago

Major Versions

1.0.0 → 2.0.02016-01-21

2.1.0 → 3.0.02017-07-06

3.0.0 → 4.0.02018-07-06

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/3358927?v=4)[10up](/maintainers/10up)[@10up](https://github.com/10up)

![](https://www.gravatar.com/avatar/f68fbe09c5420ee0676953baff55817859648785c94582adddae43a41833548c?d=identicon)[cmmarslender](/maintainers/cmmarslender)

---

Top Contributors

[![cmmarslender](https://avatars.githubusercontent.com/u/1915905?v=4)](https://github.com/cmmarslender "cmmarslender (98 commits)")[![dsawardekar](https://avatars.githubusercontent.com/u/3541543?v=4)](https://github.com/dsawardekar "dsawardekar (51 commits)")[![jeffpaul](https://avatars.githubusercontent.com/u/2818133?v=4)](https://github.com/jeffpaul "jeffpaul (13 commits)")[![nerrad](https://avatars.githubusercontent.com/u/1429108?v=4)](https://github.com/nerrad "nerrad (7 commits)")[![tlovett1](https://avatars.githubusercontent.com/u/1844351?v=4)](https://github.com/tlovett1 "tlovett1 (7 commits)")[![petenelson](https://avatars.githubusercontent.com/u/1757075?v=4)](https://github.com/petenelson "petenelson (4 commits)")[![cadwell](https://avatars.githubusercontent.com/u/167076?v=4)](https://github.com/cadwell "cadwell (3 commits)")[![kish2011](https://avatars.githubusercontent.com/u/5745798?v=4)](https://github.com/kish2011 "kish2011 (2 commits)")[![selul](https://avatars.githubusercontent.com/u/3330746?v=4)](https://github.com/selul "selul (2 commits)")[![ParhamG](https://avatars.githubusercontent.com/u/1007718?v=4)](https://github.com/ParhamG "ParhamG (1 commits)")[![johnpbloch](https://avatars.githubusercontent.com/u/446833?v=4)](https://github.com/johnpbloch "johnpbloch (1 commits)")[![dustinrue](https://avatars.githubusercontent.com/u/573953?v=4)](https://github.com/dustinrue "dustinrue (1 commits)")

---

Tags

archived

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/10up-wp-minions/health.svg)

```
[![Health](https://phpackages.com/badges/10up-wp-minions/health.svg)](https://phpackages.com/packages/10up-wp-minions)
```

###  Alternatives

[magento/community-edition

Magento 2 (Open Source)

12.1k52.1k10](/packages/magento-community-edition)[elgg/elgg

Elgg is an award-winning social networking engine, delivering the building blocks that enable businesses, schools, universities and associations to create their own fully-featured social networks and applications.

1.7k15.7k5](/packages/elgg-elgg)[pressbooks/pressbooks

Pressbooks is an open source book publishing tool built on a WordPress multisite platform. Pressbooks outputs books in multiple formats, including PDF, EPUB, web, and a variety of XML flavours, using a theming/templating system, driven by CSS.

44643.1k1](/packages/pressbooks-pressbooks)[johnbillion/user-switching

Instant switching between user accounts in WordPress and WooCommerce.

19768.3k2](/packages/johnbillion-user-switching)[rainlab/blog-plugin

Blog plugin for October CMS

17257.7k](/packages/rainlab-blog-plugin)[rainlab/user-plugin

User plugin for October CMS

11954.3k13](/packages/rainlab-user-plugin)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)