amzil-ayoub/wp-cli

There is no license information available for the latest version (1.2.1) of this package.

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.

Maintainers

Details

github.com/ayoub-amzil/wp-cli

Source

Issues

Installs: 47

Dependents: 0

Suggesters: 0

Security: 0

Stars: 0

Watchers: 1

Forks: 0

Open Issues: 0

1.2.1 2025-03-17 04:26 UTC

Requires

Unknown License 123b5e32ec6aade9223dffcca3b3d05ca7b845b3

  • Amzil Ayoub <dev.amzil.ayoub.woop@gmail.com>

This package is auto-updated.

Last update: 2025-06-17 05:05:45 UTC

README

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

  • 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

Install via Composer

composer global require amzil-ayoub/wp-cli

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: https://wordpress.org/wordpress-6.0.zip

Major and Minor Version

wp v=6.2

Downloads: https://wordpress.org/wordpress-6.2.zip

Full Version with Patch

wp v=6.2.1

Downloads: https://wordpress.org/wordpress-6.2.1.zip

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

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

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

Requirements

  • PHP 8.0+

  • Composer

  • ext-zip PHP extension