Composer Repository for WordPress core instalation

This repository simply generates a packages.json file that can be utilized as an additional Composer repository.

Note

OFFICIAL WordPress.org files: Each repository contains URLs to the WordPress zip archives hosted on the WordPress.org. Examples:

• https://downloads.wordpress.org/release/wordpress-6.3.1.zip
• https://downloads.wordpress.org/release/wordpress-6.3.1-new-bundled.zip
• https://downloads.wordpress.org/release/wordpress-6.3.1-no-content.zip

Important

This repository packages is designated with type: wordpress-dropin (rather than type: wordpress-core). This is non-standard way, but it allowes to use the default composer/installers package. This package, in turn, allows you to install WordPress core in the desired folder.

There are three types of repos

• full - with akismet and hello.php plugins.
• new-bundled - without akismet and hello.php plugins.
• no-content - without wp-content folder.

The URL of each composer repository are:

• https://raw.githubusercontent.com/doiftrue/wordpress-composer-repo/main/repo
• https://raw.githubusercontent.com/doiftrue/wordpress-composer-repo/main/repo/new-bundled
• https://raw.githubusercontent.com/doiftrue/wordpress-composer-repo/main/repo/no-content

You should add a new composer repository to your composer.json file to tell the composer which URL can be used to download a specific version of WP core.

Usage

Option 1: Install Full WP into the root dir

Warning

Do not use composer/installers for the full WP files instalation. Instead, utilize a custom command for post-autoload-dump event to copy the required files. This is because, during a future update, composer will overwrite all files in your project.

{
    "repositories": [
        {
            "type": "composer",
            "url": "https://raw.githubusercontent.com/doiftrue/wordpress-composer-repo/main/repo/new-bundled"
        }
    ],
    "require": {
        "wordpress/wordpress": "~6.3.0"
    },
    "scripts": {
        "post-autoload-dump": "rsync -a --exclude={wp-content/,wp-config-sample.php} ./vendor/wordpress/wordpress/* ./"
    }
}

Command under post-autoload-dump copies the vendor/wordpress/wordpress files to current root directory. It requires: linux system with rsync package installed.

The post-autoload-dump command runs automatically after composer install or composer update.

Option 2: Install WP core files only

Here we append /no-content to the repository URL. This will result in downloading WordPress core files without the wp-content folder.

In this scenario, you can utilize the composer/installers package to place WordPress core files to the desired folder (is the wp/ folder in example below).

{
    "repositories": [
        {
            "type": "composer",
            "url": "https://raw.githubusercontent.com/doiftrue/wordpress-composer-repo/main/repo/no-content"
        }
    ],
    "require": {
        "wordpress/wordpress": "~6.3.0",
        "composer/installers": "*"
    },
    "extra": {
        "installer-paths": {
            "wp/": [ "wordpress/wordpress" ]
        }
    },
    "config": {
        "allow-plugins": {
            "composer/installers": true
        }
    }
}

Versioning Info

WP Versions Schema: 6.3.1 = MAJOR.MINOR.PATCH.

Examples:

• "dev-master" - the latest development version.
• "~6.3.0" - allowes update PATCHs (last number) only. Same as "6.3.*".
• "^6.3.0" - allowes update MINORs and PATCHs (all numbers except first). Same as "^6".

Docs

https://getcomposer.org/doc/05-repositories.md#hosting-your-own