Jak zainstalować PHP Composer na hostingu współdzielonym/wirtualnym: Kompletny przewodnik

PHP Composer to de facto standardowy menedżer zależności dla PHP, umożliwiający deweloperom deklarowanie, instalowanie i zarządzanie bibliotekami, od których zależą ich projekty. Niezależnie od tego, czy budujesz aplikację Laravel, API Symfony czy niestandardowy projekt PHP, Composer jest niezbędnym narzędziem w Twoim przepływie pracy.

Ten kompleksowy przewodnik przeprowadzi Cię przez każdy krok instalacji PHP Composer w środowisku hostingu wirtualnego lub współdzielonego — od dostępu SSH do globalnej konfiguracji i rzeczywistego użycia.

Czym jest PHP Composer i dlaczego go potrzebujesz?

PHP Composer to menedżer pakietów, który obsługuje zarządzanie zależnościami na poziomie projektu. Zamiast ręcznego pobierania bibliotek i zarządzania autoloadingiem, Composer automatycznie rozwiązuje zależności, pobiera prawidłowe wersje i generuje zoptymalizowany autoloader.

Kluczowe korzyści to:

• Automatyczne rozwiązywanie zależności — Composer obsługuje konflikty wersji i zagnieżdżone zależności.
• Powtarzalne kompilacje — Plik composer.lock zapewnia, że każdy członek zespołu i środowisko wdrażania używa identycznych wersji pakietów.
• Ogromny ekosystem — Dostęp do ponad 350 000 pakietów na Packagist, domyślnym repozytorium Composera.
• Autoloading PSR-4 — Eliminuje ręczne instrukcje require i include w całej bazie kodu.

Jeśli uruchamiasz aplikacje PHP na Shared Web Hosting lub w środowisku VPS Hosting, instalacja Composera to jeden z pierwszych kroków w kierunku profesjonalnego i łatwego w utrzymaniu przepływu pracy programistycznej.

Wymagania wstępne

Przed rozpoczęciem potwierdź, że spełnione są następujące wymagania:

> Uwaga: Jeśli posiadasz plan zarządzanego hostingu współdzielonego bez dostępu SSH, skontaktuj się z dostawcą hostingu, aby go włączył. Plany Shared Web Hosting AlexHost obejmują dostęp SSH, dając Ci potrzebną kontrolę.

Krok 1: Połącz się z serwerem za pośrednictwem SSH

Otwórz aplikację terminala i nawiąż połączenie SSH z kontem hostingowym:

ssh username@yourdomain.com

Zastąp username swoją rzeczywistą nazwą użytkownika SSH i yourdomain.com nazwą domeny lub adresem IP serwera.

Przykład:

ssh john@203.0.113.45

Po uwierzytelnieniu znajdziesz się w katalogu domowym (zazwyczaj /home/username/). Możesz potwierdzić bieżącą lokalizację za pomocą:

pwd

Krok 2: Weryfikacja dostępności PHP

Przed pobraniem Composera potwierdź, że PHP jest zainstalowany i dostępny z wiersza poleceń:

php -v

Powinieneś zobaczyć dane wyjściowe podobne do:

PHP 8.2.10 (cli) (built: Sep  5 2023 08:15:22) (NTS)
Copyright (c) The PHP Group
Zend Engine v4.2.10, Copyright (c) Zend Technologies

Jeśli PHP nie zostanie znalezione lub wersja jest poniżej 7.2, skontaktuj się z dostawcą hostingu lub uaktualnij swoje środowisko. Użytkownicy planu VPS Hosting mają pełną kontrolę do instalacji lub aktualizacji wersji PHP w razie potrzeby.

Sprawdź również, czy wymagane rozszerzenia są załadowane:

php -m | grep -E 'openssl|phar|mbstring|json'

Wszystkie cztery rozszerzenia powinny pojawić się w danych wyjściowych.

Krok 3: Pobierz instalator Composera

Composer udostępnia oficjalny skrypt instalatora oparty na PHP. Pobierz go za pomocą następującego polecenia:

php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"

To pobiera skrypt instalatora composer-setup.php do Twojego bieżącego katalogu roboczego.

Krok 4: Weryfikacja integralności instalatora

Ten krok jest krytyczny dla bezpieczeństwa. Zawsze weryfikuj hash SHA-384 instalatora przed jego uruchomieniem, aby upewnić się, że plik nie został zmieniony ani uszkodzony podczas pobierania.

4a. Pobierz oczekiwany hash ze strony oficjalnych kluczy publicznych Composer:

Odwiedź https://composer.github.io/pubkeys.html, aby pobrać najnowszy hash instalatora.

4b. Uruchom polecenie weryfikacji:

HASH="$(php -r "echo hash_file('sha384', 'composer-setup.php');")"

Następnie porównaj go z opublikowanym hashem:

php -r "if (hash_file('sha384', 'composer-setup.php') === '$HASH') { echo 'Installer verified'; } else { echo 'Installer corrupt'; unlink('composer-setup.php'); } echo PHP_EOL;"

Jeśli zobaczysz "Installer verified", przejdź dalej. Jeśli zobaczysz "Installer corrupt", natychmiast zatrzymaj się, usuń plik i pobierz go ponownie.

Alternatywnie możesz użyć jednolinijkowca z oficjalnej dokumentacji Composer, zastępując EXPECTED_HASH wartością ze strony kluczy publicznych:

php -r "if (hash_file('sha384', 'composer-setup.php') === 'EXPECTED_HASH') { echo 'Installer verified'; } else { echo 'Installer corrupt'; unlink('composer-setup.php'); } echo PHP_EOL;"

Krok 5: Uruchom instalator Composer

Po weryfikacji instalatora wykonaj go, aby zainstalować Composer:

php composer-setup.php

Po pomyślnym wykonaniu zobaczysz dane wyjściowe podobne do:

All settings correct for using Composer
Downloading...

Composer (version 2.x.x) successfully installed to: /home/username/composer.phar
Use it: php composer.phar

Plik composer.phar jest teraz tworzony w bieżącym katalogu. Na tym etapie możesz już używać Composer, wywołując php composer.phar, ale udostępnienie go globalnie jest znacznie wygodniejsze.

Krok 6: Wyczyść skrypt instalatora

Usuń skrypt konfiguracji, ponieważ nie jest już potrzebny:

php -r "unlink('composer-setup.php');"

Krok 7: Zainstaluj Composer globalnie

Aby uruchomić Composer z dowolnego miejsca w systemie za pomocą polecenia composer, przenieś plik binarny composer.phar do katalogu zawartego w $PATH systemu.

Na VPS lub Serwerze Dedykowanym (z dostępem sudo):

sudo mv composer.phar /usr/local/bin/composer
sudo chmod +x /usr/local/bin/composer

Na Hostingu Współdzielonym (bez dostępu sudo):

Jeśli nie masz uprawnień sudo, zainstaluj Composer lokalnie w katalogu domowym:

mkdir -p ~/bin
mv composer.phar ~/bin/composer
chmod +x ~/bin/composer

Następnie dodaj ~/bin do $PATH poprzez dołączenie następującej linii do ~/.bashrc lub ~/.bash_profile:

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

Przeładuj konfigurację powłoki:

source ~/.bashrc

> Wskazówka Pro: Jeśli potrzebujesz pełnego dostępu root i większej kontroli nad środowiskiem PHP, rozważ upgrade do planu VPS Hosting lub Serwera Dedykowanego w celu uzyskania nieograniczonej konfiguracji na poziomie systemu.

Krok 8: Weryfikacja instalacji

Potwierdź, że Composer jest zainstalowany i dostępny globalnie:

composer --version

Oczekiwane wyjście:

Composer version 2.x.x 2024-xx-xx xx:xx:xx

Aby uzyskać pełną diagnostykę swojego środowiska, uruchom:

composer diagnose

To polecenie sprawdza konfigurację PHP, łączność sieciową i ustawienia Composera, zgłaszając wszelkie potencjalne problemy.

Krok 9: Używanie Composera do zarządzania zależnościami PHP

Teraz, gdy Composer jest zainstalowany, oto jak efektywnie go używać w swoich projektach PHP.

9a. Inicjalizacja nowego projektu

Przejdź do katalogu projektu i zainicjuj nowy projekt Composera:

cd /path/to/your/project
composer init

Interaktywny kreator poprosi Cię o:

• Nazwę pakietu (np. yourname/project)
• Opis
• Informacje o autorze
• Minimalną stabilność
• Wymagane zależności

To generuje plik composer.json — serce konfiguracji zależności Twojego projektu.

9b. Instalacja pakietu

Aby dodać bibliotekę do projektu, użyj polecenia require:

composer require vendor/package-name

Przykłady z rzeczywistego świata:

# Install Guzzle HTTP client
composer require guzzlehttp/guzzle

# Install Carbon date library
composer require nesbot/carbon

# Install Monolog logging library
composer require monolog/monolog

Composer rozwiąże zależności, pobierze pakiety do katalogu vendor/ i zaktualizuje composer.json oraz composer.lock.

9c. Instalacja wszystkich zależności z composer.json

Podczas wdrażania projektu lub klonowania repozytorium zainstaluj wszystkie zadeklarowane zależności za pomocą:

composer install

W środowiskach produkcyjnych użyj flagi --no-dev aby pominąć pakiety tylko dla rozwoju:

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

9d. Aktualizacja zależności

Aby zaktualizować wszystkie pakiety do ich najnowszych dozwolonych wersji:

composer update

Aby zaktualizować konkretny pakiet:

composer update vendor/package-name

9e. Autoloading

Composer automatycznie generuje autoloader. Dołącz go na początku pliku wejściowego PHP:

<?php
require 'vendor/autoload.php';

Ta pojedyncza linia daje Ci dostęp do wszystkich zainstalowanych pakietów i wszelkich niestandardowych przestrzeni nazw, które definiujesz w composer.json.

Rozwiązywanie typowych problemów

Utrzymywanie Composera w aktualnym stanie

Composer zawiera wbudowany mechanizm samoaktualizacji. Uruchom następujące polecenie okresowo, aby upewnić się, że masz najnowszą wersję:

composer self-update

Aby powrócić do poprzedniej wersji w razie potrzeby:

composer self-update --rollback

Bycie na bieżąco zapewnia, że korzystasz z najnowszych poprawek bezpieczeństwa, poprawek błędów i ulepszeń wydajności.

Wybór odpowiedniego środowiska hostingowego do tworzenia aplikacji PHP

Wybrane środowisko hostingowe znacząco wpływa na Twoją zdolność do efektywnego korzystania z narzędzi takich jak Composer.

• Hosting współdzielony — Odpowiedni dla mniejszych projektów PHP. Dostęp SSH jest dostępny, ale zmiany na poziomie systemu są ograniczone. Composer można zainstalować lokalnie w katalogu domowym.

• Hosting VPS — Idealny dla większości programistów PHP. Pełny dostęp root umożliwia globalną instalację Composer, niestandardowe konfiguracje PHP i pełną kontrolę nad Twoim stosem technologicznym.

• VPS z cPanel — Łączy moc VPS z wygodą graficznego panelu sterowania, czyniąc zarządzanie PHP i Composer jeszcze bardziej dostępnym.

• Serwery dedykowane — Najlepsze dla aplikacji PHP o wysokim ruchu wymagających maksymalnej wydajności, izolacji i dostępności zasobów.

Połącz swój hosting z odpowiednim Certyfikatem SSL, aby zabezpieczyć swoje aplikacje PHP i punkty końcowe API w produkcji.

Podsumowanie

Instalacja PHP Composer w środowisku hostingu wirtualnego lub współdzielonego to prosty proces, który dramatycznie poprawia przepływ pracy w twojej aplikacji PHP. Postępując zgodnie z tym przewodnikiem, osiągnąłeś:

1. ✅ Połączenie z serwerem za pośrednictwem SSH
2. ✅ Weryfikację dostępności PHP i wymaganych rozszerzeń
3. ✅ Pobranie i kryptograficzną weryfikację instalatora Composer
4. ✅ Instalację Composer globalnie lub lokalnie w zależności od poziomu dostępu
5. ✅ Nauczenie się inicjalizacji projektów, instalacji pakietów i zarządzania zależnościami

Composer to nie tylko wygoda — to standard profesjonalny. Utrzymywanie go w aktualnym stanie i konsekwentne używanie go w swoich projektach zapewnia, że twoje aplikacje PHP pozostają bezpieczne, łatwe w utrzymaniu i skalowalne.

Niezależnie od tego, czy prowadzisz małą witrynę na Hostingu Web Współdzielonym czy złożoną aplikację na Serwerze Dedykowanym, AlexHost zapewnia infrastrukturę i środowiska z włączonym SSH, których potrzebujesz do efektywnej pracy z Composer.