PHPackages                             roots/wordpress-core-installer - 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. [DevOps & Deployment](/categories/devops)
4. /
5. roots/wordpress-core-installer

ActiveComposer-plugin[DevOps & Deployment](/categories/devops)

roots/wordpress-core-installer
==============================

A Composer custom installer to handle installing WordPress as a dependency

v4.0.0(2mo ago)3916.3M↓24.8%520GPL-2.0-or-laterPHPPHP >=7.2.24CI passing

Since Dec 9Pushed 2mo ago5 watchersCompare

[ Source](https://github.com/roots/wordpress-core-installer)[ Packagist](https://packagist.org/packages/roots/wordpress-core-installer)[ GitHub Sponsors](https://github.com/roots)[ RSS](/packages/roots-wordpress-core-installer/feed)WikiDiscussions master Synced 1w ago

READMEChangelog (6)Dependencies (6)Versions (11)Used By (20)

WordPress Core Installer
========================

[](#wordpress-core-installer)

[![Tests](https://camo.githubusercontent.com/e7552b87dbab6210e3273054f535dbe676eb6c9c8d733a7af6c33f84d89d7388/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f726f6f74732f776f726470726573732d636f72652d696e7374616c6c65722f74657374732e796d6c3f6272616e63683d6d6173746572266c6f676f3d676974687562266c6162656c3d4349267374796c653d666c61742d737175617265)](https://github.com/roots/wordpress-core-installer/actions/workflows/tests.yml)[![Packagist Downloads](https://camo.githubusercontent.com/070c30f827453c8fd9060e4fb2c7a5ce229d59182f1850f02593389d80815e7a/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f726f6f74732f776f726470726573732d636f72652d696e7374616c6c65723f6c6162656c3d646f776e6c6f61647326636f6c6f72423d32623330373226636f6c6f72413d353235646463267374796c653d666c61742d737175617265)](https://packagist.org/packages/roots/wordpress-core-installer)[![GitHub tag](https://camo.githubusercontent.com/07d3bb39e192a291ff084bd9c4dacb2cc4929cc0c44d5e90814958aa4d251c99/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f7461672f726f6f74732f776f726470726573732d636f72652d696e7374616c6c65722e7376673f7374796c653d666c61742d737175617265)](https://camo.githubusercontent.com/07d3bb39e192a291ff084bd9c4dacb2cc4929cc0c44d5e90814958aa4d251c99/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f7461672f726f6f74732f776f726470726573732d636f72652d696e7374616c6c65722e7376673f7374796c653d666c61742d737175617265)[![Follow Roots](https://camo.githubusercontent.com/222256dbdeac58e77f017d847dca30ff4cab027cdf3abfec8e5bfd59de240547/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f666f6c6c6f7725323040726f6f747377702d3164613166323f6c6f676f3d74776974746572266c6f676f436f6c6f723d666666666666266d6573736167653d267374796c653d666c61742d737175617265)](https://twitter.com/rootswp)[![Sponsor Roots](https://camo.githubusercontent.com/31e13361135ff96d01f1eb97157d052029e6f236249996072d8b6bd60b40e9cd/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f73706f6e736f72253230726f6f74732d3532356464633f6c6f676f3d676974687562267374796c653d666c61742d737175617265266c6f676f436f6c6f723d666666666666266d6573736167653d)](https://github.com/sponsors/roots)

Note

This is a fork of [johnpbloch/wordpress-core-installer](https://github.com/johnpbloch/wordpress-core-installer) with fixes to enhance compatibility with [roots/wordpress](https://packagist.org/packages/roots/wordpress).

A custom Composer plugin to install WordPress core outside of `vendor`.

This installer is meant to support a rather specific WordPress installation setup in which WordPress is installed in a subdirectory ([see the WordPress codex on that subject](https://codex.wordpress.org/Giving_WordPress_Its_Own_Directory)) and in which the location of `WP_CONTENT_DIR` and `WP_CONTENT_URL` have been customized to be outside of WordPress core ([see the WordPress codex on that subject](https://codex.wordpress.org/Editing_wp-config.php#Moving_wp-content_folder)). This is because composer will delete your whole wp-content directory every time it updates core if you don't separate the two. If that installation setup isn't what you are looking for, then this installer is probably not something you will want to use.

For more information on using Composer with WordPress, check out our [Composer WordPress resources](https://roots.io/composer-wordpress-resources/). Use [WP Packages](https://wp-packages.org/) to install WordPress plugins and themes via Composer, and see the [`roots/wordpress` documentation](https://wp-packages.org/roots-wordpress) for WordPress core installation options.

Support us
----------

[](#support-us)

Roots is an independent open source org, supported only by developers like you. Your sponsorship funds [WP Packages](https://wp-packages.org/) and the entire Roots ecosystem, and keeps them independent. Support us by purchasing [Radicle](https://roots.io/radicle/) or [sponsoring us on GitHub](https://github.com/sponsors/roots) — sponsors get access to our private Discord.

Requirements
------------

[](#requirements)

- Composer 2+
- PHP 7.2.24+

Composer 2 requires explicitly allowing plugins. If needed, run:

```
composer config --no-plugins allow-plugins.roots/wordpress-core-installer true
```

Community
---------

[](#community)

Keep track of development and community news.

- Join us on Discord by [sponsoring us on GitHub](https://github.com/sponsors/roots)
- Join us on [Roots Discourse](https://discourse.roots.io/)
- Follow [@rootswp on Twitter](https://twitter.com/rootswp)
- Follow the [Roots Blog](https://roots.io/blog/)
- Subscribe to the [Roots Newsletter](https://roots.io/subscribe/)

###  Health Score

62

—

FairBetter than 99% of packages

Maintenance85

Actively maintained with recent releases

Popularity58

Moderate usage in the ecosystem

Community34

Small or concentrated contributor base

Maturity62

Established project with proven stability

 Bus Factor1

Top contributor holds 74.7% 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 ~532 days

Recently: every ~665 days

Total

6

Last Release

80d ago

Major Versions

1.100.0 → 2.0.02024-12-14

2.0.0 → 3.0.02025-05-23

3.0.0 → v4.0.02026-03-22

PHP version history (3 changes)1.100.0PHP >=5.6.0

2.0.0PHP >=8.1

3.0.0PHP >=7.2.24

### Community

Maintainers

![](https://www.gravatar.com/avatar/4f6a3f6809aec26ab615cf9c5ae69c37d5068c8613e77a3aad4e97bad98d0fb3?d=identicon)[swalkinshaw](/maintainers/swalkinshaw)

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

---

Top Contributors

[![johnpbloch](https://avatars.githubusercontent.com/u/446833?v=4)](https://github.com/johnpbloch "johnpbloch (65 commits)")[![retlehs](https://avatars.githubusercontent.com/u/115911?v=4)](https://github.com/retlehs "retlehs (9 commits)")[![austinpray](https://avatars.githubusercontent.com/u/2192970?v=4)](https://github.com/austinpray "austinpray (7 commits)")[![szepeviktor](https://avatars.githubusercontent.com/u/952007?v=4)](https://github.com/szepeviktor "szepeviktor (2 commits)")[![vinkla](https://avatars.githubusercontent.com/u/499192?v=4)](https://github.com/vinkla "vinkla (1 commits)")[![Ayesh](https://avatars.githubusercontent.com/u/811553?v=4)](https://github.com/Ayesh "Ayesh (1 commits)")[![jstoone](https://avatars.githubusercontent.com/u/1711456?v=4)](https://github.com/jstoone "jstoone (1 commits)")[![Rarst](https://avatars.githubusercontent.com/u/737584?v=4)](https://github.com/Rarst "Rarst (1 commits)")

---

Tags

composerwordpresswordpress-composerwordpress-corewp-composerwp-packageswordpress

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/roots-wordpress-core-installer/health.svg)

```
[![Health](https://phpackages.com/badges/roots-wordpress-core-installer/health.svg)](https://phpackages.com/packages/roots-wordpress-core-installer)
```

###  Alternatives

[johnpbloch/wordpress-core-installer

A custom installer to handle deploying WordPress with composer

20611.1M50](/packages/johnpbloch-wordpress-core-installer)

PHPackages © 2026

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