Jak patchovat moduly pro Drupal

Systém patchů má výhodu v tom, že vám umožní ke stávající verzi modulu přidat opravu, která se v nové verzi modulu objeví v lepším případě s několikadenním zpožděním. Pokud potřebujete nějakou funkci již nyní, nezbývá než použít patch.

Tento postup má samozřejmě i nevýhody. Nikde není psáno, že patche ostatních uživatelů, které posílají na Drupal.org, se objeví ve finální verzi modulu, a že váš web, který na opatchované verzi modulu spočívá, tak bude stejně funkční i po instalaci finální verze.

Příkladem užitečného patche je oprava pro IMCE a TinyMCE (nebo WYSIWYG API), kdy vám pomůže propojit vizuální editor se správcem obrázků tak, aby fungoval bez problémů ve všech prohlížečích. Odkazy na příslušné patche jsem uvedl v článku Video: obrázky v Drupalu pomocí modulů Inline, Imagecache a Lightbox2.

Aplikace patche v Linuxu

Máte-li linuxový webhosting s přístupem přes SSH (jako to nabízí třeba osvědčený HostGator), nebo pokud používáte operační systém Linux na svém počítači, máte situaci v mnohém jednodušší. Soubor s patchem nakopírujte do složky, kde se nachází soubor, který bude patchem upraven.

Poté spusťte příkaz patch -p0 < cesta/soubor.patch. Některé patche si vyžádají zadání názvu souboru, který patchujete, jiné si rovnou po spuštění provedou úpravu.

Sledujte výstupní hlášení. Pokud dojde k chybě, měli byste zjistit proč. Nejčastěji se tak stává, pokud patch aplikujete na jinou verzi modulu, než pro kterou je určen. Také nezapomínejte vytvářet zálohy, abyste mohli původní verzi souboru v případě problémů nakopírovat zpět.

Aplikace patche ve Windows

O něco složitější (jen o málo) je situace, kdy chcete patch aplikovat v prostředí Windows. Můžete si nainstalovat balíček unixových utilit Cygwin, balíček UnxUtils nebo se spokojit s jednoduchým Patch for Windows. Tomu jsem dával přednost, než jsem přešel k HostGatoru, kde patche aplikuji přímo na serveru.

Ze stránek projektu si stáhněte zazipovanou binárku, rozbalte ji někde na disk a přejděte do adresáře ~/bin. V něm najdete soubor patch.exe. Spusťte si příkazový řádek Windows a do složky, ve které je patch.exe, se přepněte. V příkazovém řádku Windows tedy toto učiníte zadáním příkazu cd cesta. Cestu můžete zkopírovat i z dialogového okna vlastnosti, které zobrazíte pravým tlačítkem myši na souboru patch.exe. Je-li v názvu cesty mezera, dejte celou cestu do uvozovek.

Nyní jste tedy ve složce s patchem a můžete jej použít podobně, jako v Linuxu. V příkazovém řádku Windows teď zadejte patch -p0 -i soubor.patch. Pokud dostanete chybové hlášení „assertion failed", použijte příkaz ve tvaru patch -p0 --verbose --binary -i soubor.patch.

Další užitečné informace na Drupal.org

Nyní byste již měli vše potřebné, pro aplikaci patchů k Drupalu nebo dalším souborům v prostředí Windows a Linuxu znát. Máte-li další dotazy, koukněte na níže uvedené odkazy, nebo napište do komentářů. Upozorňuji, že následující odkazy a video jsou v angličtině:

• Applying patches
• Applying Patches to Drupal Core (video)
• Apply patches on Windows

Obrazový průvodce patchováním ve Windows

Aktualizováno: Protože výše uvedený návod možná není dostatečně výstižný, rozhodl jsem doplnit obrazového průvodce. Zde tedy je se stručnými popisky.

1. Do počítače stáhnete výše uvedený Patch for Windows jako soubor ZIP. V něm najdete složku bin a v ní soubor patch.exe. Ten rozbalte do složky c:\temp.Do složky s patch.exe dál enakopíruje soubor *.patch a soubor, který budete patchem upravovat.

Stiskněte Win-R, napište cmd a spusťte tak příkazový řádek. Ve Windows Vista ho spusťte zadáním cmd do hledacího políčka v nabídce Start a přes pravé tlačítko, kde vyberete spuštění v režimu správce. Uvidíte něco takového:

2. Přepněte se do složky c:\temp, kde jsou patch.exe, patch a patchovaný soubor. Uděláte to zadáním příkazu cd c:\temp a stiskem Enteru:

3. Příkazem dir si můžete prohlédnout, zda opravdu koukáte na složku, kde jsou potřené soubory:

4. Zadejte příkaz pro spuštění patche, patch -p0 --verbose --binary -i *.patch

5. Patch by měl proběhnout úspěšně za předpokladu, že:

• patchujete takovou verzi modulu/souboru, pro kterou je patch určen. To je nejčastější problém.
• nespletete zadání příkazu

Některé patche jsou udělány tak, že je lepší patch.exe a *.patch nakopírovat přímo do složky s modulem, protože patch může měnit více souborů, než jeden jediný.