Jak zainstalować Pear przez SSH?

PEAR (PHP Extension and Application Repository) to menedżer pakietów i bibliotek dla języka PHP. Na serwerze z panelem direct_Admin możesz zainstalować go samodzielnie przez SSH, bez potrzeby uprawnień administratora serwera. Z tego poradnika dowiesz się, jak przygotować katalog roboczy, pobrać i uruchomić instalator oraz na stałe dodać polecenie pear do ścieżki PATH swojego konta.

Wymagania wstępne

Przed rozpoczęciem upewnij się, że:

• Masz włączony dostęp SSH na swoim koncie hostingowym, zgodnie z instrukcją: Jak włączyć SSH?
• Jesteś zalogowany do serwera przez SSH, zgodnie z instrukcją: Jak zalogować się na ssh?
• Znasz swój login do panelu direct_Admin, będzie potrzebny podczas instalacji.

Instalacja Pear

Aby zainstalować Pear ręcznie przez SSH:
1. Po zalogowaniu się do SSH utwórz katalog, w którym zostanie zainstalowany PEAR, i przejdź do niego:

mkdir -p ~/local/pear

cd ~/local/pear

2. W katalogu roboczym pobierz oficjalny instalator go-pear.phar:

curl -O https://pear.php.net/go-pear.phar

3. Uruchom pobrany instalator poleceniem:

php -d detect_unicode=0 go-pear.phar

Instalator wyświetli sugerowany układ katalogów PEAR i poprosi o wybór opcji do zmiany. Wybierz opcję 1 (Installation base) i zmień proponowaną ścieżkę na:

/home/TwójLoginDoDirectAdmin/local/pear

WAŻNE! W ścieżce podstaw prawidłowy login do panelu direct_Admin w miejscu TwójLoginDoDirectAdmin.

Następnie naciskaj Enter, aż instalacja dobiegnie końca.

Po zakończeniu instalacji powinieneś zobaczyć komunikat potwierdzający:

The 'pear' command is now at your service at /home/TwójLoginDoDirectAdmin/local/pear/bin/pear

4. Aby sprawdzić, czy instalacja się powiodła, dodaj katalog binarny PEAR do zmiennej PATH i sprawdź wersję:

export PATH="$HOME/local/pear/bin:$PATH"

pear version

Jeśli w odpowiedzi pojawi się numer wersji PEAR, wszystko działa poprawnie.

WAŻNE! Powyższy wpis do PATH obowiązuje wyłącznie w bieżącej sesji SSH — po wylogowaniu zniknie. Aby polecenie pear było dostępne na stałe, wykonaj kolejny krok.

5. Aby polecenie pear było dostępne w każdej nowej sesji terminala, dopisz wpis do pliku .bashrc:

echo 'export PATH="$HOME/local/pear/bin:$PATH"' >> ~/.bashrc

source ~/.bashrc

Zamiast source ~/.bashrc możesz też po prostu wylogować się i zalogować ponownie.

Instalacja automatyczna (skrypt)

Opracowaliśmy również prosty skrypt, który umożliwia automatyczną instalację Pear przez SSH, aby to wykonać:

1. Po zalogowaniu się do SSH w bezpicznym katalogu utwórz plik skryptu i otwórz go w edytorze nano.

nano install_pear.sh

2. Wklej treść poniższego skryptu:

#!/bin/bash

# Ustawienia
INSTALL_DIR="$HOME/local/pear"
PHAR_URL="https://pear.php.net/go-pear.phar"
BIN_PATH="$INSTALL_DIR/bin"
SHARE_PATH="$INSTALL_DIR/share/pear"
BASHRC="$HOME/.bashrc"

# Tworzenie katalogu docelowego
mkdir -p "$INSTALL_DIR"
cd "$INSTALL_DIR" || exit 1

# Pobranie go-pear.phar
echo "Pobieranie PEAR..."
curl -s -O "$PHAR_URL"

# Automatyczna instalacja
echo "Instalacja PEAR lokalnie do $INSTALL_DIR..."
php -d detect_unicode=0 go-pear.phar <<EOF
1
$INSTALL_DIR
EOF

# Dodanie do PATH tymczasowo i na stałe
if ! grep -q "$BIN_PATH" "$BASHRC"; then
  echo " Dodawanie PEAR do ~/.bashrc..."
  echo "export PATH=\"$BIN_PATH:\$PATH\"" >> "$BASHRC"
fi

export PATH="$BIN_PATH:$PATH"

# Test działania
if command -v pear >/dev/null 2>&1; then
  echo "PEAR zainstalowany poprawnie!"
  pear version
else
  echo "Coś poszło nie tak. PEAR nadal nie działa."
  exit 1
fi

# Wskazówki do PHP
echo -e "\n W PHP używaj tego kodu, aby załadować PEAR:"
echo "set_include_path(get_include_path() . PATH_SEPARATOR . getenv('HOME') . '/local/pear/share/pear');"
echo "require_once 'PEAR.php';"

3. Zapisz plik i zamknij edytor, używając poniższych skrótów klawiszowych:

4. Nadaj skryptowi uprawnienia wykonywalne.

chmod +x install_pear.sh

5. Uruchom skrypt.

./install_pear.sh

Skrypt wykona następujące działania:
1. Utworzy katalog ~/local/pear.
2. Pobierze go-pear.phar z oficjalnej strony PEAR.
3. Zainstaluje PEAR lokalnie.
4. Dopisze ścieżkę do ~/.bashrc, żeby komenda pear działała też w nowych sesjach terminala.
5. Na końcu wypisze wersję PEAR, jeśli instalacja się powiodła.

Podsumowanie

Od tej chwili polecenie pear będzie dostępne w każdej nowej sesji terminala na Twoim serwerze. Możesz teraz instalować i zarządzać pakietami PEAR wymaganymi przez Twoje aplikacje PHP.