CLI: Bash · Git · Composer

pwd                 # print working directory — где я сейчас
ls                  # список файлов
ls -la              # -l подробно, -a включая скрытые (начинаются с точки)
ls -lh              # -h размеры по-человечески: 4.0K вместо 4096
ls -lt              # -t сортировка по времени, свежие сверху

cd /var/www         # абсолютный путь — от корня
cd ../logs          # относительный: .. это на уровень вверх
cd ~                # домашняя папка
cd -                # вернуться туда, где был до этого

mkdir logs              # создать папку
mkdir -p a/b/c          # -p создать всю цепочку, не ругаться если есть
touch file.txt          # создать пустой файл / обновить дату

cp file.txt backup.txt  # копировать файл
cp -r src/ dist/        # -r рекурсивно, для папок обязателен
cp -a src/ dist/        # -a сохранить права, владельца, даты

mv old.txt new.txt      # переименовать
mv file.txt /tmp/       # переместить — та же команда

rm file.txt             # удалить файл
rm -r folder/           # удалить папку рекурсивно
rm -f file.txt          # -f не спрашивать и не ругаться на отсутствие

cat file.txt            # вывести целиком
less file.txt           # постранично: q выход, / поиск, G в конец
head -20 file.txt       # первые 20 строк
tail -20 file.txt       # последние 20 строк
tail -f storage/logs/laravel.log   # следить за новыми строками в реальном времени
wc -l file.txt          # сколько строк

grep "error" app.log            # строки со словом error
grep -i "error" app.log         # -i без учёта регистра
grep -r "TODO" app/             # -r рекурсивно по папке
grep -n "error" app.log         # -n показать номера строк
grep -c "error" app.log         # -c только посчитать совпадения
grep -v "debug" app.log         # -v инверсия: всё КРОМЕ совпавшего
grep -A3 -B3 "error" app.log    # 3 строки после (After) и до (Before)
grep -E "error|warning" app.log # -E регулярка, | это ИЛИ

В macOS предустановлен BSD grep, а подавляющее большинство примеров в сети написано под GNU grep из Linux. Команды выглядят одинаково, но часть ключей у BSD отсутствует — и строка, которая у автора статьи работала, на Mac падает с ошибкой.

$ grep --version
grep (BSD grep, GNU compatible) 2.6.0-FreeBSD   # macOS
grep (GNU grep) 3.11                            # Linux

Чаще всего спотыкаются об один ключ — -P, то есть регулярные выражения в стиле Perl. Именно он стоит почти во всех однострочниках с \d, \w и \s:

$ grep -oP '\d+' app.log
grep: invalid option -- P
usage: grep [-abcdDEFGHhIiJLlMmnOopqRSsUVvwXxZz] ...

Если ключ -P нужен ради \d и подобных сокращений, их почти всегда можно заменить на переносимые классы POSIX — они работают и на Mac, и на Linux:

# было (GNU, на macOS упадёт)
grep -oP '\d+' app.log
grep -oP '\w+@\w+' users.txt

# стало (работает везде)
grep -oE '[[:digit:]]+' app.log
grep -oE '[[:alnum:]_]+@[[:alnum:]_]+' users.txt

Второй путь — поставить настоящий GNU grep через Homebrew. Он встанет рядом, под именем ggrep, чтобы не ломать системные скрипты:

brew install grep

ggrep -oP '\d+' app.log      # GNU-версия, -P работает
grep  -oP '\d+' app.log      # системный BSD, по-прежнему ошибка

Можно сделать GNU-версию основной, добавив её каталог в начало PATH — тогда grep будет означать GNU grep:

# в ~/.zshrc
export PATH="/opt/homebrew/opt/grep/libexec/gnubin:$PATH"

find . -name "*.php"                  # по имени, с текущей папки
find . -iname "*.PHP"                 # -iname без учёта регистра
find . -type f -size +10M             # файлы больше 10 МБ
find . -type d -name node_modules     # -type d только папки
find . -mtime -7                      # изменённые за последние 7 дней
find . -name "*.log" -delete          # найти и удалить
find . -name "*.php" -exec grep -l "TODO" {} \;   # выполнить команду над каждым

sort file.txt           # отсортировать строки
sort -u file.txt        # -u убрать дубликаты
sort -rn file.txt       # -r обратный порядок, -n числовая сортировка
uniq -c file.txt        # -c посчитать повторы (нужен отсортированный вход)
cut -d: -f1 /etc/passwd # -d разделитель, -f номер поля
sed 's/old/new/g' f.txt # замена: s/что/на что/g — g значит все вхождения
awk '{print $1, $3}' f  # вывести 1-ю и 3-ю колонки

ps aux                  # все процессы системы
ps aux | grep php       # отфильтровать по имени
top                     # интерактивно, обновляется (q выход)
htop                    # то же, удобнее — ставится отдельно

kill 1234               # послать SIGTERM — «завершись корректно»
kill -9 1234            # SIGKILL — убить немедленно, без шансов
pkill -f "artisan queue" # убить по совпадению в командной строке

df -h                   # сколько места на разделах
du -sh /var/www         # -s итог по папке, -h по-человечески
du -sh * | sort -rh     # что занимает больше всего в текущей папке
du -sh * | sort -rh | head -10   # топ-10 тяжёлых

ping example.com                      # доступен ли хост
lsof -i :8000                         # кто занял порт 8000
netstat -tulpn | grep 80              # что слушает 80 порт (Linux)

Без флагов curl URL делает обычный GET и вываливает тело в терминал. Всё остальное поведение задаётся ключами, и почти всегда их комбинируют: типичная строка из скрипта выглядит как curl -sS -f -L URL. Разберём по группам.

Типовые вызовы, которые стоит помнить наизусть:

# Обычный GET
curl https://api.example.com/users

# Только код ответа — удобно в проверках
curl -s -o /dev/null -w '%{http_code}\n' https://example.com

# POST с JSON
curl -X POST https://api.example.com/orders \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer TOKEN' \
  -d '{"total":"100.00"}'

# Тело из файла — когда JSON большой
curl -X POST https://api.example.com/orders \
  -H 'Content-Type: application/json' \
  -d @order.json

# Форма, как её шлёт браузер
curl -X POST https://example.com/login \
  -d 'email=a@b.com' -d 'password=secret'

# Загрузка файла формой
curl -F 'file=@photo.jpg' -F 'title=Фото' https://example.com/upload

# Скачать с продолжением и редиректами
curl -L -C - -O https://example.com/big.zip

# Диагностика: весь обмен целиком
curl -v https://example.com 2>&1 | head -40

# Замер времени ответа
curl -s -o /dev/null -w 'dns=%{time_namelookup} connect=%{time_connect} total=%{time_total}\n' https://example.com

API отвечает одной длинной строкой без переносов — читать её в терминале невозможно. jq форматирует JSON и умеет доставать из него нужное. Ставится одной командой: brew install jq на macOS, apt install jq на Debian и Ubuntu.

# Просто отформатировать — точка означает «весь документ»
curl -s https://api.example.com/users | jq

# Достать одно поле
curl -s https://api.example.com/user/1 | jq '.email'
# "ivan@example.com"  — в кавычках, это JSON-строка

# -r убирает кавычки: нужно, когда значение идёт в переменную
TOKEN=$(curl -s -X POST https://api.example.com/login \
  -d '{"email":"a@b.com","password":"secret"}' \
  -H 'Content-Type: application/json' | jq -r '.token')

# Перебрать массив и оставить только нужные поля
curl -s https://api.example.com/users | jq '.[] | {id, email}'

# Сколько элементов пришло
curl -s https://api.example.com/users | jq 'length'

# Фильтр по условию
curl -s https://api.example.com/orders | jq '.[] | select(.total > 1000)'

# Вложенное поле и значения по умолчанию, если его нет
curl -s https://api.example.com/user/1 | jq '.profile.city // "не указан"'

# Собрать плоскую строку для отчёта
curl -s https://api.example.com/users | jq -r '.[] | "\(.id)\t\(.email)"'

Если ставить jq некуда, минимальное форматирование есть в самом Python:

curl -s https://api.example.com/users | python3 -m json.tool

$ ls -l
-rw-r--r--  1 observer  staff   1024 Oct 16 12:00 file.txt
drwxr-xr-x  5 observer  staff    160 Oct 16 12:00 folder/
│└┬┘└┬┘└┬┘
│ │  │  └── остальные (others)
│ │  └───── группа (group)
│ └──────── владелец (user)
└────────── тип: - файл, d папка, l симлинк

chmod 755 script.sh     # числом
chmod +x script.sh      # добавить право запуска всем
chmod -R 775 storage/   # -R рекурсивно

chown www-data file     # сменить владельца
chown -R www-data:www-data /var/www/app   # владелец:группа

cat app.log | grep error | wc -l       # сколько строк с ошибками
ps aux | grep php | grep -v grep       # процессы PHP без самого grep
du -sh * | sort -rh | head -5          # топ-5 тяжёлых папок
git log --oneline | head -20           # последние 20 коммитов

command > file.txt      # записать, ПЕРЕЗАПИСАВ файл
command >> file.txt     # дописать в конец
command 2> errors.txt   # только ошибки (поток 2)
command > out.txt 2>&1  # и вывод, и ошибки в один файл
command > /dev/null 2>&1 # выбросить всё

cmd1 && cmd2            # cmd2 только если cmd1 успешна (код 0)
cmd1 || cmd2            # cmd2 только если cmd1 упала
cmd1 ; cmd2             # подряд, независимо от результата
cmd &                   # запустить в фоне

# Типичный деплой — каждый шаг только при успехе предыдущего
git pull && composer install --no-dev && php artisan migrate --force

git init                        # создать репозиторий в текущей папке
git clone URL                   # скачать существующий
git clone URL my-folder         # в папку с другим именем
git clone --depth 1 URL         # только последний коммит, без истории

# Кто автор коммитов — без этого Git откажется коммитить
git config --global user.name "Имя"
git config --global user.email "mail@example.com"
git config --list               # посмотреть все настройки

git status                  # что изменилось — главная команда
git add file.txt            # добавить файл в индекс
git add .                   # всё из текущей папки и ниже
git add -p                  # по кускам: спросит про каждый фрагмент

git commit -m "Описание"    # зафиксировать то, что в индексе
git commit -am "Описание"   # -a добавить все ОТСЛЕЖИВАЕМЫЕ и закоммитить

git push                    # отправить на сервер
git pull                    # забрать и влить чужие изменения

git log                     # полная история
git log --oneline           # по строке на коммит
git log --oneline --graph --all   # с деревом веток
git log -5                  # последние 5
git log -p file.txt         # история конкретного файла с диффами
git log --author="Имя"      # коммиты одного автора

git diff                    # что изменено, но НЕ в индексе
git diff --staged           # что в индексе и уйдёт в коммит
git diff main..feature      # разница между ветками

git show HEAD               # последний коммит целиком
git blame file.txt          # кто и когда менял каждую строку

# Типичный для Laravel
/vendor
/node_modules
/public/storage
/storage/*.key
.env
.env.backup
.phpunit.result.cache
.DS_Store

Это ключевая модель Git. Без неё команды отмены выглядят набором случайных заклинаний.

git branch                  # список локальных веток
git branch -a               # включая удалённые
git branch feature-x        # создать, но не переключаться

git switch feature-x        # переключиться (современный способ)
git switch -c feature-x     # создать и сразу перейти
git checkout -b feature-x   # то же самое, старый синтаксис

git branch -d feature-x     # удалить влитую ветку
git branch -D feature-x     # удалить принудительно, даже не влитую

git switch main
git merge feature-x         # влить feature-x в текущую ветку

# При конфликте Git остановится и разметит файл:
# <<<<<<< HEAD        — что в твоей ветке
# =======              — граница
# >>>>>>> feature-x   — что во вливаемой

git status                  # покажет конфликтные файлы
# правишь руками, убираешь маркеры, затем:
git add file.txt
git commit                  # завершить слияние

git merge --abort           # передумал — откатить слияние целиком

git remote -v                       # какие remote настроены
git remote add origin URL           # добавить
git remote set-url origin NEW_URL   # сменить адрес

git fetch                   # забрать изменения, НЕ применяя
git pull                    # fetch + merge одной командой
git pull --rebase           # fetch + rebase — история линейнее

git push                            # отправить текущую ветку
git push -u origin feature-x        # -u связать с удалённой при первом пуше
git push --force-with-lease         # безопасный force

git tag                         # список тегов
git tag v1.0.0                  # лёгкий тег на текущий коммит
git tag -a v1.0.0 -m "Релиз"    # аннотированный: с автором и датой
git tag -a v1.0.0 HASH          # тег на конкретный коммит

git push origin v1.0.0          # теги НЕ уходят с обычным push
git push --tags                 # отправить все теги
git tag -d v1.0.0               # удалить локально

Менеджер зависимостей для PHP. Решает две задачи: ставит библиотеки нужных версий со всеми их зависимостями и настраивает автозагрузку, чтобы классы подключались без ручных require.

composer init                       # создать composer.json интерактивно
composer require guzzlehttp/guzzle  # поставить пакет и записать в json
composer require --dev phpunit/phpunit   # только для разработки
composer require guzzlehttp/guzzle:^7.5  # конкретное ограничение версии

composer remove guzzlehttp/guzzle   # удалить пакет
composer show                       # что установлено
composer show guzzlehttp/guzzle     # подробности о пакете
composer outdated                   # у чего есть обновления
composer why vendor/package         # КТО тянет этот пакет
composer validate                   # проверить composer.json
composer audit                      # известные уязвимости в зависимостях

composer install --no-dev --optimize-autoloader --no-interaction

# --no-dev               не ставить require-dev (phpunit, faker, debugbar)
# --optimize-autoloader  собрать статическую карту классов вместо поиска по файлам
# --no-interaction       ничего не спрашивать — обязательно для CI
# --prefer-dist          ставить архивы вместо клонирования репозиториев

composer update vendor/package      # обновить ОДИН пакет, не всё подряд
composer update --lock              # пересобрать lock без переустановки

Версия пишется как MAJOR.MINOR.PATCH, например 7.5.2. Правило семантического версионирования: MAJOR меняется при ломающих изменениях, MINOR — при новых совместимых возможностях, PATCH — при исправлениях.

{
    "autoload": {
        "psr-4": {
            "App\\": "app/",
            "Database\\Factories\\": "database/factories/"
        },
        "files": ["app/helpers.php"],
        "classmap": ["database/seeders"]
    },
    "autoload-dev": {
        "psr-4": { "Tests\\": "tests/" }
    }
}

composer dump-autoload              # пересобрать карту автозагрузки
composer dump-autoload -o           # -o оптимизированная (= --optimize)

{
    "scripts": {
        "test": "phpunit",
        "lint": "pint --test",
        "post-autoload-dump": [
            "@php artisan package:discover --ansi"
        ],
        "post-install-cmd": ["@php artisan optimize"]
    }
}

composer test               # запустить свой скрипт
composer run-script test    # то же явно
composer list               # все доступные команды