Slovník pojmů

Příkazový řádek

CLI dovoluje spouštět nástroje projektu přes přesné příkazy. Je rychlý a automatizovatelný, ale shell neodpouští neporozumění pracovnímu adresáři, argumentům ani oprávněním.

Stručná definice

Textový způsob, jak zadat programu úkol a jeho parametry.

Příkazový řádek může znamenat samotné rozhraní nástroje, například php, git nebo docker. Terminál je okno či aplikace, která zobrazuje textový vstup a výstup. Shell je program, který řádek přečte a vyhodnotí uvozovky, proměnné, roury, přesměrování a případné další příkazy. V běžné řeči se tato slova míchají, při řešení problému je dobré je odlišit.

IDE není grafické CLI, i když může CLI ukazovat v integrovaném terminálu. Příkaz php může spustit runtime, zatímco php bin/console je konkrétní rozhraní Symfony aplikace. Stejný příkaz na jiném počítači může pracovat s jinou verzí nástroje, jiným adresářem nebo jinými proměnnými prostředí.

Jaký problém řeší

Opakovatelnou práci bez klikání v rozhraních

Dobře pojmenovaný příkaz lze popsat v dokumentaci, spustit lokálně i ověřit v CI.

kontrola stavu repozitáře a vytvoření čitelné změny v Gitu
instalace a ověření PHP závislostí podle lock souboru
spuštění testů, linteru, statické analýzy nebo Symfony Console příkazu
ovládání lokálních služeb přes Docker Compose
diagnostika konfigurace a logů v určeném prostředí

Praktický příklad

Nejdřív bezpečné ověření PHP projektu

Před změnou vývojář zjistí, kde právě je a zda repozitář už neobsahuje cizí rozpracovanou práci. Pak spustí jen ověřovací příkazy. Ukázka nemění databázi, nemaže soubory ani neinstaluje novou verzi balíčků.

Výsledek příkazu je součást informace. Nenulový exit code znamená, že nástroj hlásí problém; není to pokyn příkaz automaticky opakovat s vyššími právy. Pokud příkaz očekává jiný adresář nebo proměnnou prostředí, je bezpečnější nejdřív zjistit proč.

Shell

pwd
git status --short
composer validate --no-check-publish
php bin/console about

Jak se příkaz vykoná

Od řádku v terminálu k výsledku programu

Textový diagram: terminál → shell → příkaz a argumenty → proces → výstup a návratový kód.

Terminál Přijme text od uživatele a zobrazí výstup. Může být samostatný nebo integrovaný v IDE.
Shell Vyhodnotí syntaxi, například mezery, uvozovky, proměnné, globy, roury a přesměrování. Stejný text může mít v jiném shellu jiný význam.
Příkaz a argumenty Spustí program s určenými parametry a pracovní cestou. Argument oddělený mezerou není totéž jako součást názvu souboru.
Proces a oprávnění Operační systém provede program pod identitou uživatele. sudo nebo administrátorský shell mění oprávnění, nikoli bezpečnost příkazu.
Výstup a exit code Program vypíše informaci na standardní výstup či chybový výstup a vrátí stav. Skript a CI mohou podle něj rozhodnout o dalším kroku.

Praktické hranice

CLI je společná vrstva pro vývoj, kontrolu i provoz.

Příkazový řádek nástroje sjednocuje, ale nedává jim automaticky správný kontext ani bezpečná oprávnění.

IDE

IDE může otevřít integrovaný terminál a spustit konfiguraci. Základní chování shellu a oprávnění se tím nemění.

Composer a PHP

Composer spravuje závislosti a php spouští runtime. Každý nástroj má jiné argumenty, výstup a vliv na projekt.

Symfony Console

Příkazy aplikace jsou součástí kódu a mohou pracovat s databází či integracemi; před spuštěním je třeba znát prostředí.

Docker

Docker CLI ovládá kontejnery, image a volumes. Příkaz v lokálním Dockeru nemusí být bezpečný ani dostupný na produkčním serveru.

Důležité pojmy

Terminál, shell a CLI nejsou synonyma.

Přesné názvy usnadní popsat problém i bezpečně najít správnou dokumentaci.

Terminál

Uživatelské rozhraní pro textový vstup a výstup. Může otevřít Bash, Zsh, PowerShell i jiný shell.

Shell

Interpret příkazů operačního systému. Rozhoduje, jak se vyhodnotí mezery, proměnné jako $HOME, zástupné znaky, roury a přesměrování.

CLI nástroje

Programy s vlastní sadou podpříkazů a voleb. git status, composer install a docker compose jsou různé CLI s vlastní dokumentací.

Pracovní adresář

Místo, ze kterého se příkaz spouští. Relativní cesta, konfigurace i cílový soubor se mohou podle něj změnit.

Exit code

Číselný výsledek procesu. Nula obvykle znamená úspěch; nenulová hodnota říká skriptu a CI, že je potřeba věnovat pozornost chybě.

Výhody a omezení

Přesnost a automatizace výměnou za potřebu rozumět syntaxi.

Přínosy

stejný postup lze dokumentovat, opakovat a spustit v CI
rychlé složení menších nástrojů do jednoho workflow
výstup a návratový kód jsou dobře použitelné pro automatizaci
nástroje často zpřístupní více funkcí než grafické rozhraní

Rizika a chyby

příkaz z neznámého zdroje může mazat data, spustit skript nebo odeslat secrets
nequotované proměnné a cesty se mezerou mohou změnit význam příkazu
sudo zvyšuje dopad chyby a nemá být první reakcí na permission denied
kopírování produkčních příkazů do lokálního nebo opačného prostředí může mířit na jiná data
tichý přesměrovaný výstup může skrýt chybu nebo přepsat soubor

Kdy dává smysl

Tam, kde má tým popsatelný a opakovatelný postup.

CLI je přirozené pro build, testy, importy, diagnostiku a práci s verzováním. Příkaz může být jednoduchý i pro začátečníka, pokud je v projektu popsán včetně pracovního adresáře, očekávaného vstupu, bezpečných parametrů a výsledku.

Na jednorázový úkon může být pohodlnější grafické rozhraní. I v tom případě je dobré rozumět tomu, jaký příkaz nebo API operaci tlačítko provádí. Pro citlivé produkční kroky je potřeba navíc kontrola přístupu, audit a postup schvalování, ne jen znalost příkazu.

Bezpečnost shellu

Neznámý příkaz nejdřív přečíst, ne spustit.

Shell kombinuje data a instrukce. Krátký řádek proto může mít větší dopad, než vypadá na první pohled.

před příkazem ověřit pracovní adresář, cílové prostředí a účet, pod kterým poběží
nekopírovat řádky s curl, pipe do shellu, sudo, rm, přesměrováním nebo proměnnými bez porozumění každé části
cesty a hodnoty s mezerami nebo zvláštními znaky správně citovat podle používaného shellu
neposílat tokeny, hesla ani celé proměnné prostředí do historie, shellové historie, logu či ticketu
před hromadnou operací zkusit malý neškodný vzorek a mít zálohu nebo možnost návratu
pro týmové úlohy použít verzovaný skript či make target s jasným názvem místo dlouhého nezdokumentovaného příkazu

Časté otázky

Příkazový řádek bez zbytečných rizik

Je terminál totéž co shell?

Ne. Terminál zobrazuje vstup a výstup. Shell interpretuje zadaný text a spouští programy. V jednom terminálu lze otevřít různé shelly.

Je CLI totéž co příkazový řádek operačního systému?

CLI je obecně textové rozhraní programu. Příkazový řádek operačního systému je jedno místo, odkud lze taková CLI spouštět.

Proč neřešit permission denied vždy přes sudo?

sudo zvětší oprávnění a tím i následky chyby. Nejprve zjisti, který soubor nebo služba je cílem a proč běžný účet přístup nemá.

Je bezpečné spustit příkaz z návodu, když mu důvěřuji?

Důvěryhodný zdroj pomáhá, ale příkaz stále ověř v kontextu vlastního prostředí. Pozor na proměnné, verzi nástroje, pracovní adresář, podmínky a neviditelné znaky po zkopírování.

Jak držím kvalitu vývoje

Důležité postupy dávám do opakovatelných příkazů a CI.

U PHP projektů sjednocuji build, kontroly kvality a provozní úlohy tak, aby byly dohledatelné, ověřitelné a nezávislé na klikání v jednom nástroji.

Jak pracuji s testováním a kvalitou Nezávazně probrat projekt