PHPackages                             aubreypwd/ultimate-wp-config - 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. [Utility &amp; Helpers](/categories/utility)
4. /
5. aubreypwd/ultimate-wp-config

ActiveProject[Utility &amp; Helpers](/categories/utility)

aubreypwd/ultimate-wp-config
============================

CONSTANT controlled ultimate wp-config.php enhancements meant mostly for LocalWP development.

00PHP

Since Oct 20Pushed 2y ago1 watchersCompare

[ Source](https://github.com/aubreypwd/ultimate-wp-config)[ Packagist](https://packagist.org/packages/aubreypwd/ultimate-wp-config)[ RSS](/packages/aubreypwd-ultimate-wp-config/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependenciesVersions (1)Used By (0)

`aubreypwd/ultimate-wp-config`
==============================

[](#aubreypwdultimate-wp-config)

A PHP CONSTANT controled wp-config enhancement for WordPress local development.

You can easily turn things on and off (and configure them) using `wp config set|delete` or by editing CONSTANTS directly in your `wp-config.php` file.

---

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

[](#installation)

```
composer require aubreypwd/ultimate-wp-config:dev-main@dev --dev
```

---

Usage
-----

[](#usage)

After installation, add:

```
require_once  __DIR__ . '/vendor/autoload.php';
```

...after the `/* That's all, stop editing! Happy publishing. */` bit in `wp-config.php`but before `/** Absolute path to the WordPress directory. */`.

---

### Core

[](#core)

- Use `define( 'HOST' )` to set your host to something other than what's defined in the database (does not work on multisite).

---

### LocalWP &amp; WP-CLI

[](#localwp--wp-cli)

WP CLI w/ LocalWP can be confusing, and sometimes not work at all. This recommends you setup `DB_HOST` with a Socket file. We don't recommend you copy/paste the socket value directly into the `DB_HOST`, instead run `wp` in a Site Shell to find out what to do.

The way this does it ensures if you clone, blueprint, or import a site you don't accidentally connect to the original site's database. I also recommend you exclude `*.sock` from being exported in your Preferences.

Just run `wp` to find out what to do.

To ignore this recommendation:

```
define( 'LOCALWP_ALLOW_EXTERNAL_CLI', true );
```

```
wp config set LOCALWP_ALLOW_EXTERNAL_CLI true
```

---

### Multisite

[](#multisite)

When `WP_ALLOW_MULTISITE` is set to `true`, multisite will automatically be enabled for a multisite DB.

```
define( 'WP_ALLOW_MULTISITE', true|false );
```

```
wp config set WP_ALLOW_MULTISITE true|false --raw
```

---

### AffiliateWP License

[](#affiliatewp-license)

This is specific to use with [AffiliateWP](https://affiliatewp.com), a plugin I work on.

To use the below easily, first you have to set your Pro and Personal licenses:

```
wp config set AFFWP_LICENSE_PRO key
wp config set AFFWP_LICENSE_PERSONAL key
```

Then you can use this more easily to switch while your keys are safely stored forever:

Set `AFFWP_LICENSE` to `pro` or `personal` will activate the set keys for AffiliateWP.

```
define( 'AFFWP_LICENSE', 'pro|personal' );
```

```
wp config set AFFWP_LICENSE "pro|personal"
```

- Use `wp config delete AFFWP_LICENSE` to use your own.

---

### LocalWP Development &amp; Live Links

[](#localwp-development--live-links)

When not using multisite, you can force LocalWP to use the livelinks URL for your site by using:

```
define( 'LOCALWP_LIVE', true ); // $> wp config set LOCALWP_LIVE true --raw
define( 'LOCALWP_LIVE_USERNAME', 'username' ); // $> wp config set LOCALWP_LIVE_USERNAME 'username'
define( 'LOCALWP_LIVE_PASSWORD', 'password' ); // $> wp config set LOCALWP_LIVE_PASSWORD 'password'
define( 'LOCALWP_LIVE_HOST', 'subdomain.localsite.io' ); // $> wp config set LOCALWP_LIVE_HOST 'example.com'
```

Use `wp config set LOCALWP_LIVE false --raw` to turn off live links mode.

---

### Jetpack protection

[](#jetpack-protection)

This is on by default, set `define( 'DISABLE_JETPACK_PROTECTION', true )` to bypass this protection.

When enabled, it should keep JetPack from connecting to wordpress.com or VIP services.

---

### Disable Email

[](#disable-email)

Email is disabled by default, unless you set:

```
define( 'MAIL', true );
```

```
wp config set MAIL true --raw
```

###  Health Score

12

—

LowBetter than 0% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity0

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity20

Early-stage or recently created project

 Bus Factor1

Top contributor holds 100% 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.

### Community

Maintainers

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

---

Top Contributors

[![aubreypwd](https://avatars.githubusercontent.com/u/1753298?v=4)](https://github.com/aubreypwd "aubreypwd (24 commits)")

### Embed Badge

![Health badge](/badges/aubreypwd-ultimate-wp-config/health.svg)

```
[![Health](https://phpackages.com/badges/aubreypwd-ultimate-wp-config/health.svg)](https://phpackages.com/packages/aubreypwd-ultimate-wp-config)
```

###  Alternatives

[franmomu/silex-pagerfanta-provider

Silex ServiceProvider for Pagerfanta Library

1312.1k](/packages/franmomu-silex-pagerfanta-provider)

PHPackages © 2026

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