WP Composer: yhteisörahoitteinen seuraaja WPackagistille WordPressin Composer-työnkulussa

Jos rakennat WordPress-projekteja modernimmin (Bedrock, CI/CD, lukitut riippuvuudet, toistettavat deployt), Composer on yleensä työnkulun ydin. Pitkään käytännössä ainoa “helppo” tapa asentaa WordPress.org-hakemiston lisäosia ja teemoja Composerilla oli WPackagist.

Maaliskuussa 2026 WPackagist siirtyi WP Enginen omistukseen. Koska kyse on WordPressin Composer-ekosysteemissä erittäin keskeisestä infrastruktuurista, yhden yrityksen kontrolli herättää väistämättä kysymyksiä läpinäkyvyydestä, suunnasta ja saatavuudesta. Tähän tarpeeseen Roots rakensi vaihtoehdon: WP Composerin.

WP Composer (https://wp-composer.com) on itsenäinen, yhteisörahoitteinen ja täysin avoimen lähdekoodin Composer-repo WordPress-lisäosille ja -teemoille. Se on Rootsin rakentama ja ylläpitämä.

Miksi tällä on väliä (ja miksi WPackagist ei enää riitä)

WPackagist syntyi alun perin Outlandishin tekemänä ja toimi vuosia käytännössä standardina. Myöhempinä vuosina palvelussa alkoi näkyä ylläpidon puute: päivitykset hidastuivat, ylläpito oli rajallista eikä yhteisön osallistumiselle ollut kunnollista väylää.

Kun kehittäjien perustyökaluja hallitsee yksi yritys, päätöksiä saatavuudesta, hinnoittelusta ja suunnasta tehdään helposti suljetummin. Lisäksi WPackagistin avoimuus herättää nyt lisäkysymyksiä: sen julkinen GitHub-repo (https://github.com/outlandishideas/wpackagist) ei enää vastaa sitä, mitä tuotantosivustolla oikeasti pyörii.

WP Composerin idea on yksinkertainen: vaihtoehto, joka on läpinäkyvä, yhteisön rahoittama ja rakennettu porukan toimesta, jolla on pitkä historia WordPress-kehittäjien työkalujen parissa.

Jos haluat katsoa tarkemmat erot suorituskyvyssä, metadatassa ja toteutuksessa, Rootsilta löytyy vertailu: https://wp-composer.com/wp-composer-vs-wpackagist.

Mitä WP Composer tarjoaa käytännössä

WP Composer sisältää kaikki ilmaiset lisäosat ja teemat WordPress.org-hakemistosta, asennettavissa Composerilla. Mukana tulee myös selkeä pakettinimeäminen, joka siivoaa yhden vanhan harmin pois: enää ei tarvita wpackagist-plugin/<em> ja wpackagist-theme/</em> -etuliitteitä.

Uusi nimeämismalli:

• Lisäosat: wp-plugin/*
• Teemat: wp-theme/*

Esimerkki composer.json-konfiguraatiosta, jossa repo lisätään ja otetaan käyttöön lisäosa + teema:

{
  "repositories": [
    {
      "name": "wp-composer",
      "type": "composer",
      "url": "https://repo.wp-composer.com",
      "only": ["wp-plugin/*", "wp-theme/*"]
    }
  ],
  "require": {
    "wp-plugin/woocommerce": "^10.0",
    "wp-theme/twentytwentyfive": "^1.0"
  }
}

{
  "repositories": [
    {
      "name": "wp-composer",
      "type": "composer",
      "url": "https://repo.wp-composer.com",
      "only": ["wp-plugin/*", "wp-theme/*"]
    }
  ],
  "require": {
    "wp-plugin/woocommerce": "^10.0",
    "wp-theme/twentytwentyfive": "^1.0"
  }
}

Yhteensopivuus Rootsin WordPress core -pakettien kanssa

WP Composer on Rootsin suosittelema repo käytettäväksi yhdessä heidän WordPress core -pakettiensa kanssa: roots/wordpress, roots/wordpress-full ja roots/wordpress-no-content.

Tyypillisessä Bedrock-projektissa malli on tämä: WordPressin core tulee paketista roots/wordpress ja lisäosat/teemat tulevat WP Composerin kautta.

Migraatio WPackagistista WP Composeriin

Vaihto onnistuu suoraviivaisesti muutamalla komennolla. Alla on käytännön askel askeleelta -polku, joka tekee samalla selväksi mitä projektissa muuttuu.

1) Poista vanhat WPackagist-paketit

composer remove wpackagist-plugin/woocommerce wpackagist-theme/twentytwentyfive

composer remove wpackagist-plugin/woocommerce wpackagist-theme/twentytwentyfive

2) Vaihda repository-asetus WP Composeriin

composer config --unset repositories.wpackagist && composer config repositories.wp-composer composer https://repo.wp-composer.com

composer config --unset repositories.wpackagist && composer config repositories.wp-composer composer https://repo.wp-composer.com

3) Lisää riippuvuudet uudella nimeämisellä

composer require wp-plugin/woocommerce wp-theme/twentytwentyfive

composer require wp-plugin/woocommerce wp-theme/twentytwentyfive

Vaihtoehto: aja migraati skripti, joka päivittää composer.json:n automaattisesti

Roots tarjoaa myös valmiin migraati skriptin, joka hoitaa composer.json-muutokset puolestasi:

curl -sO https://raw.githubusercontent.com/roots/wp-composer/main/scripts/migrate-from-wpackagist.sh && bash migrate-from-wpackagist.sh

curl -sO https://raw.githubusercontent.com/roots/wp-composer/main/scripts/migrate-from-wpackagist.sh && bash migrate-from-wpackagist.sh

Jos seuraat plugin-päivityksiä GitHub Actionsilla

Jos käytät Rootsin GitHub Actionia lisäosien päivitysten seurantaan, se on nimetty uudelleen WPackagist Changelog Actionista muotoon WP Composer Changelog Action ja tukee suoraan uutta wp-plugin/<em> ja wp-theme/</em> -nimeämistä: https://github.com/roots/wp-composer-changelog-action.

Suorituskyky: miksi WP Composer on selvästi nopeampi

WP Composer hyödyntää Composer v2:n metadata-url-protokollaa, jonka idea on, että Composer hakee metadatan vain niille paketeille, joita se oikeasti tarvitsee riippuvuuksien ratkaisuun. WPackagist nojaa vanhempaan provider-includes-malliin, jossa Composer joutuu lataamaan isoja indeksitiedostoja (metadataa tuhansista paketeista) ennen kuin se edes pääsee kunnolla resolvoimaan projektin riippuvuuksia.

Composerin resolve-ajat (cold resolve, ei cachea)

Alla olevat luvut ovat cold resolve -tilanteesta (ei välimuistia). Pienempi aika on parempi.

• 10 lisäosaa: WP Composer 0,7 s vs WPackagist 12,3 s → 17× nopeampi
• 20 lisäosaa: WP Composer 1,1 s vs WPackagist 19,0 s → 17× nopeampi

Metadata ja välimuisti (caching)

• Composer v2 metadata-url: WP Composer kyllä, WPackagist ei
• CDN-caching: WP Composer public, max-age=300, WPackagist no-cache, private
• Per-package-tiedostot: WP Composerissa immuuttiset, content-addressed ja voidaan cachettaa käytännössä loputtomiin; WPackagistissa ei content-addressed-mallia

Täysin avoin lähdekoodi (ja oikeasti forkattaessa ajettavissa)

WP Composerin koko paketti – sovelluskoodi, dokumentaatio ja deployment-konfiguraatio – on avoimena GitHubissa: https://github.com/roots/wp-composer. Käytännössä tämä tarkoittaa myös sitä, että kuka tahansa voi forkata projektin ja ajaa omaa instanssia.

Yhteisörahoitteinen malli

WP Composer rahoitetaan kokonaan yhteisön toimesta GitHub Sponsorsin kautta: https://github.com/sponsors/roots. Sponsoroimalla tuet suoraan infrastruktuuria, kehitystä ja ylläpitoa – sekä samalla laajemmin Roots-ekosysteemiä.

Yhteenveto: milloin WP Composer kannattaa ottaa käyttöön

Jos WordPressin riippuvuudet elävät composer.json:ssa ja haluat työkaluketjun, joka on läpinäkyvä, nopeasti toimiva ja riippumaton yhden yrityksen päätöksistä, WP Composer on looginen valinta. Migraatio on muutaman komennon operaatio, nimeämismalli selkeytyy (wp-plugin/<em>, wp-theme/</em>) ja samalla saat Composer v2:n modernin metadata-haun tuomat nopeushyödyt.