Když odejde PHP programátor nebo agentura: co udělat hned a co potom
Když odejde vývojář nebo agentura, nejdřív zajistěte přístupy: kód, server, databázi, doménu, hosting a všechna hesla a klíče musíte mít pod kontrolou vy. Pak si vyžádejte řádné předání, nechte nového vývojáře kód posoudit a o přepisu rozhodujte až s výsledky auditu v ruce.
První dny: zajistěte přístupy
Ať už spolupráce skončila v dobrém, nebo ve sporu, platí stejné pravidlo: aplikace je vaše a přístupy k ní musíte mít vy, ne dodavatel. Dokud je nemáte, nemůže na projektu bezpečně pracovat nikdo další – a v horším případě nemáte jistotu, že se k produkci nedostane někdo, kdo už by neměl.
Projděte postupně tyto oblasti a u každé si ověřte, že máte vlastní přístup na firemní e-mail, ne sdílený účet dodavatele:
- Zdrojový kód – repozitář v gitu (GitLab, GitHub, Bitbucket nebo vlastní server). Ideálně tak, aby repozitář patřil firemnímu účtu a vývojáři do něj byli jen přizváni.
- Server nebo hosting – administrace hostingu, SSH nebo FTP přístup, správa cloudového účtu.
- Databáze – přístupové údaje a hlavně aktuální záloha, kterou máte u sebe.
- Doména a DNS – u registrátora zkontrolujte, kdo je zapsán jako držitel domény. Pokud je to dodavatel nebo jeho zaměstnanec, řešte převod co nejdřív.
- E-mail a odesílání zpráv – SMTP služba, nastavení SPF a DKIM, účty, ze kterých aplikace posílá e-maily.
- Externí služby – platební brána, dopravci, účetní systém, SMS brána, mapy, analytika, cloudová úložiště. U každé zjistěte, na čí účet je vedená.
- Hesla, API klíče a certifikáty – soubory s konfigurací, správce hesel, přístupy do administrace aplikace.
Jakmile máte přístupy, změňte hesla a klíče, ke kterým měl odcházející dodavatel přístup – včetně API klíčů platebních bran a hesel k databázi. Udělejte to promyšleně a s někým, kdo ví, kde všude se klíče v aplikaci používají, aby výměna nezpůsobila výpadek.
Záloha a dohled ještě před první změnou
Než kdokoli na aplikaci sáhne, udělejte si kompletní zálohu kódu, databáze a nahraných souborů (obrázky, dokumenty, faktury) a uložte ji mimo produkční server. Ověřte také, že zálohy vznikají pravidelně i do budoucna – při odchodu dodavatele se občas zjistí, že je zajišťoval jeho vlastní skript na jeho vlastním serveru.
Zapněte si alespoň jednoduchý dohled dostupnosti webu a zkontrolujte, kam chodí chybové hlášky a upozornění o expiraci domény a SSL certifikátu. Pokud chodily na e-mail odcházejícího vývojáře, přesměrujte je na firemní adresu. Výpadek, o kterém se dozvíte od zákazníků, je to nejhorší, co se v přechodném období může stát.
Co si vyžádat při předání
Pokud je předchozí vývojář ochotný spolupracovat, i krátká předávací schůzka ušetří novému vývojáři hodiny zkoumání. Požádejte o:
- kompletní zdrojový kód včetně všech větví a historie v gitu, ne jen archiv souborů,
- informaci, zda kód v repozitáři odpovídá tomu, co skutečně běží na produkci,
- popis nasazení – jak se změny dostávají na server, co se spouští ručně,
- seznam cron úloh a procesů běžících na pozadí,
- seznam napojení na externí systémy a kde jsou uložené jejich přístupové údaje,
- známé chyby, rozpracované úpravy a místa, kterých se „radši nedotýkat“,
- existující dokumentaci, testy a instrukce ke zprovoznění lokálního prostředí.
Ověřte si také ve smlouvě, jaká práva ke kódu máte – zda máte licenci k jeho dalším úpravám, případně výhradní. U sporných situací je dobré obrátit se na právníka dřív, než spolupráce definitivně skončí.
Když předchozí dodavatel nespolupracuje, nepanikařte. Nejúplnějším zdrojem kódu bývá často samotný produkční server a přístup k němu obvykle zařídíte přes poskytovatele hostingu jako jeho zákazník.
Jak nový vývojář posoudí stav aplikace
Než nový vývojář začne dělat úpravy, měl by vědět, co přebírá. Při převzetí projektu postupuji zhruba takto:
- Zprovoznění lokálně – pokud aplikace nejde spustit mimo produkci, je to první zjištění a první úkol.
- Verze a závislosti – verze PHP a frameworku, knihovny v Composeru,
composer auditna známé zranitelnosti. Aplikace na PHP 7.x nebo 8.0 už nedostává bezpečnostní opravy. - Statická analýza – PHPStan rychle ukáže, jak konzistentní kód je a kde jsou zjevné chyby.
- Bezpečnost – SQL injection, XSS, ochrana administrace, hesla a klíče uložené přímo v kódu nebo v gitu.
- Architektura – kde je obchodní logika, jak moc je kód provázaný, zda existují testy.
- Provoz – zálohy, logování chyb, způsob nasazení, testovací prostředí.
Výsledkem by měla být písemná zpráva srozumitelná i pro vedení firmy: co je kritické a opravit hned, co naplánovat a co může počkat – s odhadem pracnosti. Bez ní se o dalším vývoji rozhoduje podle dojmů.
Přepsat od nuly, nebo postupně opravovat?
Nový vývojář často po prvním pohledu do starého kódu navrhne přepsání celé aplikace. Někdy je to správně, většinou ne. Stávající aplikace v sobě nese roky obchodní logiky a ošetřených výjimek, které nikdo nesepsal – a které se při přepisu musí znovu objevit, často až po spuštění.
Postupný refactoring dává smysl, když:
- aplikace funguje a firma na ní vydělává,
- problémy jsou soustředěné do určitých částí,
- kód jde postupně převést na podporovanou verzi PHP a frameworku,
- nemůžete si dovolit měsíce, kdy se vyvíjí nový systém a starý stojí.
Nahrazení nebo přepis stojí za zvážení, když:
- aplikace stojí na technologii, kterou už nejde rozumně provozovat ani aktualizovat,
- firma se od jejího vzniku natolik změnila, že většina funkcí neodpovídá potřebám,
- existuje hotový produkt, který potřeby pokryje lépe,
- audit prokáže, že oprava by stála víc než nové řešení.
Častým rozumným kompromisem je postupné nahrazování: aplikace dál běží a jednotlivé části se jedna po druhé přepisují nebo vyčleňují. Riziko se tak rozloží do menších kroků, z nichž každý jde vrátit.
Jak se příště vyhnout závislosti na jednom dodavateli
Odchod vývojáře by neměl být krize. Dá se na něj připravit už během spolupráce:
- Účty vlastní firma. Repozitář, hosting, doména a externí služby jsou vedené na firmu, dodavatel má jen přidělený přístup.
- Hesla ve firemním správci hesel, ne v hlavě nebo e-mailu jednoho člověka.
- Standardní technologie. Rozšířený framework jako Nette nebo Symfony znamená, že najdete dalšího vývojáře. Vlastní framework jednoho autora je riziko.
- Kód v gitu a opakovatelné nasazení, ideálně automatizované v CI, například v GitLab CI.
- Testy a statická analýza pro klíčové procesy – usnadňují práci každému dalšímu vývojáři.
- Krátká dokumentace: jak aplikaci spustit, nasadit a kde jsou důležitá nastavení. Stačí jedna stránka v repozitáři.
- Jasná smlouva o právech ke kódu a o povinnosti součinnosti při předání.
Checklist: když odchází PHP vývojář
- Vlastní přístup do repozitáře s kompletní historií
- Vlastní přístup k hostingu nebo serveru
- Přístup k databázi a aktuální záloha uložená mimo server
- Doména zapsaná na firmu, přístup k registrátorovi a DNS
- Seznam externích služeb a účtů, všechny vedené na firmu
- Změněná hesla, API klíče a přístupy po odchodu dodavatele
- Popis nasazení, cron úloh a napojení na další systémy
- Ověřená práva ke zdrojovému kódu ve smlouvě
- Aplikace zprovozněná mimo produkci
- Písemné posouzení stavu kódu s prioritami a odhadem pracnosti
- Rozhodnutí o dalším postupu podle auditu, ne podle dojmu
Jak můžu pomoci
Projekty po jiných vývojářích a agenturách přebírám pravidelně – v Nette, Symfony i ve starém PHP bez frameworku. Začínám auditem PHP aplikace, který při převzetí trvá typicky 4–8 h (10 000–20 000 Kč bez DPH) a dá vám přehled o tom, co máte a co je potřeba řešit nejdřív.
Jak celé převzetí PHP projektu probíhá – od zajištění přístupů po stabilizaci a další vývoj – popisuji na samostatné stránce. A pokud audit ukáže, že je rozumnější část aplikace nahradit, můžeme se bavit o vývoji na míru.