PHPackages                             amzil-ayoub/wp-cli - 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. [CLI &amp; Console](/categories/cli)
4. /
5. amzil-ayoub/wp-cli

ActiveLibrary[CLI &amp; Console](/categories/cli)

amzil-ayoub/wp-cli
==================

A command-line tool to download and install any version of WordPress with custom folder naming. Perfect for developers who need to quickly set up WordPress instances.

1.2.3(11mo ago)157PHPPHP ^8.0

Since Mar 17Pushed 11mo ago1 watchersCompare

[ Source](https://github.com/ayoub-amzil/wp-cli)[ Packagist](https://packagist.org/packages/amzil-ayoub/wp-cli)[ RSS](/packages/amzil-ayoub-wp-cli/feed)WikiDiscussions main Synced today

READMEChangelog (6)DependenciesVersions (7)Used By (0)

WordPress Installation Tool
===========================

[](#wordpress-installation-tool)

A command-line tool to download and install any version of WordPress with custom folder naming. Perfect for developers who need to quickly set up WordPress instances.

---

Features
--------

[](#features)

- **Custom Folder Names**: Specify a custom folder name or use the default version-based name.
- **Version-Specific Downloads**:
    - Download specific WordPress versions (`v=major`, `v=major.minor`, or `v=major.minor.path`).
    - Automatically constructs the correct download URL based on the version format.
- **Cross-Platform**: Works on both Windows and Unix-based systems.
- **Error Handling**: Validates folder names, version formats, and checks if the specified version exists.

---

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

[](#installation)

**Install via Composer**

```
composer global require ayoub-amzil/wp-cli
```

Usage
-----

[](#usage)

**Basic Usage**

```
wp
```

This will:

- Fetch the latest WordPress version.
- Download and extract it into a folder named wordpress\_{version}\_{timestamp}.

**Custom Folder Name**

Specify a custom folder name:

```
wp my-project
```

This will:

- Fetch the latest WordPress version.
- Download and extract it into a folder named my-project.

**Specific WordPress Version**

Download a specific version of WordPress:

Major Version Only

```
wp v=6
```

Downloads:

Major and Minor Version

```
wp v=6.2
```

Downloads:

Full Version with Patch

```
wp v=6.2.1
```

Downloads:

**Custom Folder Name + Specific Version**

Combine a custom folder name with a specific version:

```
wp my-project v=6.2.1
```

This will:

- Download WordPress 6.2.1.
- Extract it into a folder named my-project.

Examples
--------

[](#examples)

**Example 1: Default Behavior**

```
wp
```

**Output:**

```
================================
 WordPress Installation Tool
================================

Fetching latest WordPress version...
⬇Downloading WordPress 6.7.2...
Extracting files to: wordpress_6.7.2_20250317020433

Success! WordPress 6.7.2 installed at:
/path/to/wordpress_6.7.2_20250317020433
```

**Example 2: Custom Folder + Specific Version**

```
wp my-site v=6.2
```

**Output:**

```
================================
 WordPress Installation Tool
================================

⬇Downloading WordPress 6.2...
Extracting files to: my-site

Sccess! WordPress 6.2 installed at:
/path/to/my-site
```

**Example 3: Invalid Version**

```
wp v=6.2.99
```

**Output:**

```
================================
 WordPress Installation Tool
================================

Error: WordPress version 6.2.99 does not exist.
```

Error Handling
--------------

[](#error-handling)

The tool provides clear error messages for common issues:

- Invalid folder name: Only alphanumeric, hyphens, and underscores are allowed.
- Invalid version format: Must be major, major.minor, or major.minor.path.
- Version does not exist: Checks if the specified WordPress version is available for download.
- Directory already exists: Prevents overwriting existing directories.
-

Development
-----------

[](#development)

**Requirements**

- PHP 8.0+
- Composer
- ext-zip PHP extension

###  Health Score

31

—

LowBetter than 66% of packages

Maintenance51

Moderate activity, may be stable

Popularity10

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity47

Maturing project, gaining track record

 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.

###  Release Activity

Cadence

Every ~27 days

Recently: every ~33 days

Total

6

Last Release

341d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/68514362?v=4)[Amzil Ayoub](/maintainers/amzil-ayoub)[@amzil-ayoub](https://github.com/amzil-ayoub)

---

Top Contributors

[![ayoub-amzil](https://avatars.githubusercontent.com/u/85901966?v=4)](https://github.com/ayoub-amzil "ayoub-amzil (18 commits)")

---

Tags

clicomposerphpwordress

### Embed Badge

![Health badge](/badges/amzil-ayoub-wp-cli/health.svg)

```
[![Health](https://phpackages.com/badges/amzil-ayoub-wp-cli/health.svg)](https://phpackages.com/packages/amzil-ayoub-wp-cli)
```

###  Alternatives

[illuminate/console

The Illuminate Console package.

13046.0M6.5k](/packages/illuminate-console)[styleci/cli

The CLI tool for StyleCI

71470.5k9](/packages/styleci-cli)[winbox/args

Windows command-line formatter

20720.9k21](/packages/winbox-args)[tomatophp/filament-artisan

Simple but yet powerful library for running some artisan commands for FilamentPHP

3275.4k1](/packages/tomatophp-filament-artisan)

PHPackages © 2026

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