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

PHP Composer to de facto standard menedżer zależności dla PHP, umożliwiający deweloperom deklarowanie, instalowanie i zarządzanie bibliotekami, od których zależy 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 etap instalacji PHP Composer w środowisku hostingu wirtualnego lub współdzielonego — od dostępu SSH do globalnej konfiguracji i rzeczywistego użycia.

Co to jest PHP Composer i dlaczego go potrzebujesz?

PHP Composer to menedżer pakietów obsługujący 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 Composer.
• Autoloading PSR-4 — Eliminuje ręczne instrukcje require i include w całym kodzie.

Jeśli uruchamiasz aplikacje PHP na Hostingu Web Współdzielonym lub w środowisku Hostingu VPS, instalacja Composer to jeden z pierwszych kroków w kierunku profesjonalnego, łatwego w utrzymaniu przepływu pracy.

Wymagania wstępne

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

> Uwaga: Jeśli jesteś na planie hostingu współdzielonego bez dostępu SSH, skontaktuj się z dostawcą hostingu, aby go włączył. Plany Hostingu Web Współdzielonego AlexHost obejmują dostęp SSH, dając Ci kontrolę, której potrzebujesz.

Krok 1: Połącz się z serwerem przez SSH

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

ssh username@example.com

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

Przykład:

ssh john@mywebsite.com

Po uwierzytelnieniu wylądowiesz w katalogu domowym (zwykle /home/username). Możesz potwierdzić swoją bieżącą lokalizację za pomocą:

pwd

Krok 2: Sprawdź dostępność PHP

Przed pobraniem Composer potwierdź, że PHP jest zainstalowane i dostępne z wiersza poleceń:

php -v

Powinieneś zobaczyć dane wyjściowe podobne do:

PHP 8.1.2 (cli) (built: Jan 15 2022 10:00:00) ( NTS )

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 Hostingu VPS mają pełną kontrolę do instalacji lub aktualizacji wersji PHP.

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

php -m | grep -E ‘curl|json|mbstring|openssl’

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

Krok 3: Pobierz instalator Composer

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: Sprawdź integralność instalatora

Ten krok jest krytyczny dla bezpieczeństwa. Zawsze sprawdzaj hash SHA-384 instalatora przed jego wykonaniem, 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:

php -r “echo hash_file(‘sha384’, ‘composer-setup.php’);”

Następnie porównaj go z opublikowanym hashem:

echo “EXPECTED_HASH_HERE”

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_HERE’) { echo ‘Installer verified’; } else { echo ‘Installer corrupt’; unlink(‘composer-setup.php’); } “

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 takie jak:

All settings correct for using Composer
Composer (version 2.5.0) successfully installed to: /home/username/composer.phar

Plik composer.phar jest teraz tworzony w Twoim 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 konfiguracyjny, ponieważ nie jest już potrzebny:

rm composer-setup.php

Krok 7: Zainstaluj Composer globalnie

Aby uruchomić Composer z dowolnego miejsca w systemie, używając tylko polecenia composer, przenieś binarny plik 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

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, dołączając następującą linię do pliku ~/.bashrc lub ~/.bash_profile:

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

Przeładuj konfigurację powłoki:

source ~/.bashrc

> Pro Tip: Jeśli potrzebujesz pełnego dostępu root i większej kontroli nad środowiskiem PHP, rozważ uaktualnienie do planu Hostingu VPS lub Serwera Dedykowanego dla nieograniczonej konfiguracji na poziomie systemu.

Krok 8: Sprawdź instalację

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

composer –version

Oczekiwane dane wyjściowe:

Composer version 2.5.0 2023-02-09 16:13:27

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

composer diagnose

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

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

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

9a. Zainicjuj nowy projekt

Przejdź do katalogu projektu i zainicjuj nowy projekt Composer:

composer init

Interaktywny kreator poprosi Cię o:

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

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

9b. Zainstaluj pakiet

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

composer require vendor/package

Przykłady rzeczywiste:

composer require laravel/framework
composer require symfony/console
composer require monolog/monolog

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

9c. Zainstaluj wszystkie 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 programistów:

composer install –no-dev

9d. Zaktualizuj zależności

Aby zaktualizować wszystkie pakiety do ich najnowszych dozwolonych wersji:

composer update

Aby zaktualizować konkretny pakiet:

composer update vendor/package

9e. Autoloading

Composer automatycznie generuje autoloader. Dołącz go na początku punktu wejścia 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 Composer 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 cofnąć się do poprzedniej wersji, jeśli to konieczne:

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 hostingu dla rozwoju PHP

Wybrane środowisko hostingu znacząco wpływa na Twoją zdolność do efektywnego używania narzędzi takich jak Composer.

• Hosting Web Współdzielony