PHP balíčky, Github & Packagist

Témata: Composer, Gigthub, Packagist

Jak zaregistrovat PHP balíček pro použití přes Composer

Každý vývojář dříve nebo později narazí na potřebu znovu využít část svého kódu, ať už pro vlastní projekty nebo pro ostatní. A právě k tomu slouží PHP balíčky. Vytvořit vlastní knihovnu a umožnit její jednoduchou instalaci přes composer require je snazší, než se zdá. Tento návod vás provede celým procesem krok za krokem.

1. Připravte repozitář s composer.json

Ujistěte se, že váš GitHub repozitář obsahuje validní soubor composer.json v kořenovém adresáři. Například:

{
    "name": "tvujuzivatel/nazev-balicku",
    "description": "Krátký popis balíčku",
    "type": "library",
    "license": "MIT",
    "autoload": {
        "psr-4": {
            "TvujNamespace\\": "src/"
        }
    },
    "require": {
    "php": ">=7.4"
    }
}

Poznámka: Pole name musí být ve formátu vendor/package-name (např. janmarek/muj-balicek).

2. Zaregistrujte balíček na Packagist

Packagist je hlavní veřejný repozitář pro PHP balíčky. Zaregistrováním svého balíčku zde ho zpřístupníte celému PHP ekosystému – od jednotlivců po velké týmy.

1. Přejděte na https://packagist.org/packages/submit
2. Přihlaste se nebo si vytvořte účet
3. Vložte URL svého veřejného GitHub repozitáře (např. https://github.com/janmarek/muj-balicek)
4. Odešlete formulář

Packagist si načte composer.json a zaregistruje balíček.

3. Nastavte GitHub webhook pro automatické aktualizace

Abyste nemuseli po každé změně manuálně aktualizovat balíček na Packagistu, nastavte si GitHub webhook:

1. Na Packagistu jděte do nastavení balíčku a propojte ho se svým GitHub účtem
2. Pokud se webhook nevytvoří automaticky, nastavte ho ručně:

URL: https://packagist.org/api/github
Content type: application/json
Event: Just the push event

Přidává se v GitHub repozitáři v sekci Settings → Webhooks → Add webhook.

4. Použití balíčku přes Composer

Jakmile je balíček zaregistrován a veřejně dostupný, může ho kdokoli nainstalovat pomocí:

composer require tvujuzivatel/nazev-balicku

Příklad:

composer require janmarek/muj-balicek

Tímto způsobem si budujete vlastní ekosystém znovupoužitelného kódu a můžete přispět i komunitě. A kdo ví – možná se váš balíček jednoho dne stane nepostradatelným nástrojem pro stovky dalších vývojářů.

Moje balíčky